Webhooks
Webhooks
Recevez les événements Sinao en temps réel
Connectez Sinao à vos outils externes pour recevoir notifications, payloads d’exemple et faciliter le debug.
La section Webhooks centralise tout ce dont vous avez besoin pour envoyer des événements Sinao vers un service externe (URL de callback). C’est utile pour automatiser des flux (CRM, ERP, intégrations personnalisées) et pour diagnostiquer rapidement les erreurs côté destinataire.
Capacités principales
Définir / éditer l’URL
Saisissez ou modifiez l’URL de destination du webhook pour recevoir les événements de votre application.
Activer / désactiver événements
Choisissez exactement quels événements et sous-événements doivent être envoyés (filtrage fin pour éviter le bruit).
Charger et visualiser exemples
Parcourez l’historique paginé d’événements et ouvrez des payloads d’exemple pour vérifier le format attendu.
Copier payloads / erreurs
Copiez en un clic le payload ou le message d’erreur pour coller dans un outil de debug ou partager avec votre équipe.
Flux d’utilisation rapide
Accéder aux webhooks
Ouvrez Paramètres > Webhooks pour voir la configuration actuelle.
Configurer l’URL
Saisissez l’URL de callback de votre service externe et vérifiez qu’elle répond correctement.
Remarque : le champ webhook_url a été migré du type string vers le type text (migration database/migrations/apps-updates/2026_05_25_113210_update_events_webhooks_data_type.php) pour permettre des URL plus longues et des caractères UTF‑8. Les enregistrements existants sont convertis automatiquement lors de la migration ; aucune action n’est requise de votre part. Notez toutefois que les limites exactes dépendent du moteur de base de données (ex. PostgreSQL : taille illimitée ; MySQL TEXT ≈ 65 535 octets) et que si l’interface cliente impose une longueur maximale, il faudra éventuellement adapter cette validation côté frontend.
Sélectionner événements
Cochez les événements et sous-événements que vous souhaitez envoyer, puis cliquez sur Sauvegarder.
Vérifier et copier payloads
Sélectionnez un événement dans la liste, inspectez l’exemple de payload et copiez-le pour tester/diagnostiquer.
Bonnes pratiques rapides
Enregistrez d’abord une URL de test (ex. un outil de capture ou un endpoint staging). Activez les événements progressivement pour vérifier la réception avant d’ouvrir en production.
Limites et règles importantes
Les webhooks sont envoyés seulement si l’option est activée et que l’URL de destination est valide. La liste d’événements peut être paginée : utilisez « Charger plus » pour voir l’historique complet. Copier un payload n’exécute pas d’appel réel — c’est uniquement pour l’aide au debug.
Champ webhook_url — changement de type : le stockage de l’URL de callback a été changé de string à text via la migration database/migrations/apps-updates/2026_05_25_113210_update_events_webhooks_data_type.php. Cela autorise désormais des URL plus longues et la conservation de caractères encodés en UTF‑8 ; toutefois, les limites pratiques (taille maximale) dépendent du moteur de base de données utilisé. La migration convertit automatiquement les données existantes — vos endpoints actuels restent fonctionnels. Si vous comptez indexer ou appliquer des validations de longueur côté client, vérifiez les contraintes spécifiques de votre base de données et adaptez la validation frontend si nécessaire.
Besoin d’en savoir plus ? Consultez les pages détaillées :
- Configuration des webhooks — comment configurer l’URL et sauvegarder la configuration.
- Gestion des événements — activer/désactiver événements et sous-événements.
- Exemples de payloads et debug — lire les payloads, copier et tester.
- Règles et bonnes pratiques — sécuriser et monitorer vos webhooks.
Si vous venez d’arriver dans l’équipe, commencez par créer une URL de test et activer un seul événement pour valider le flux. Si vous voulez, je peux générer un petit checklist à suivre pour vos premières intégrations.