Ce qu’est un webhook
Un point de terminaison est une adresse de votre propre système, qui commence par https://. Chaque fois que quelque chose que vous avez choisi se produit dans votre espace de travail, nous y envoyons un message : un événement. Chaque événement est signé, pour que votre système puisse vérifier qu’il vient bien de nous. Le guide du développeur explique comment.
Webhooks liste vos points de terminaison : pour chacun, son URL, sa Description et son Statut, Activé ou Désactivé, avec le résultat de sa dernière tentative.
Ajouter un point de terminaison
Sur Webhooks, appuyez sur Ajouter un point de terminaison.
Saisissez l’URL du point de terminaison, et une description si vous le souhaitez.
L’adresse doit commencer par
https://, être accessible sur l’internet public et utiliser le port habituel.Appuyez sur Choisir les événements et cochez ce que cette adresse doit recevoir.
Rechercher un événement en trouve un par son nom. Tout sélectionner coche un groupe entier. Le nombre d’événements choisis est compté au fur et à mesure.
Appuyez sur Confirmer.
La fenêtre Son secret de signature affiche le secret avec lequel votre système vérifie chaque événement. Copiez-le maintenant : il n’est plus affiché ensuite.
Les événements
- Le message d’un client arrive.
- Une conversation est confiée à une personne, ou fermée.
- Un contact est ajouté, change ou se désinscrit.
- Un segment change.
- Meta approuve, refuse ou met en pause un modèle.
- Une campagne est lancée, ou a fini d’être envoyée.
- Une étape d’un workflow échoue.
- Un agent IA est mis en ligne, ou ses modifications sont publiées.
- Une réservation est faite, avec le CRM.
- Un paiement aboutit.
- Le statut d’un numéro change.
Un point de terminaison créé sur cet écran appartient à l’espace de travail et peut recevoir chacun d’eux, y compris les mots du message d’un client. Un point de terminaison qu’un système a créé par l’API appartient à sa clé, l’indique, et ne reçoit que ce que sa clé peut lire.
Suivre les livraisons
Le menu au bout de la ligne d’un point de terminaison :
| À l’écran | À quoi cela sert |
|---|---|
| Modifier | Change son adresse, sa description ou ses événements. |
| Envoyer un événement de test | Envoie un événement de test maintenant. Le résultat s’affiche dans le journal de livraison quelques secondes plus tard. |
| Journal de livraison | Ce qui a été envoyé ces 90 derniers jours : Quand, Événement, Essai, Résultat, la réponse HTTP et la Durée de l’envoi. |
| Nouveau secret | Donne au point de terminaison un nouveau secret de signature, affiché une seule fois. Les événements sont aussitôt signés avec lui. |
| Désactiver | Plus rien ne lui est envoyé jusqu’à ce que vous le réactiviez. |
| Supprimer | Supprime le point de terminaison et son journal de livraison. |
| À l’écran | À quoi cela sert |
|---|---|
| livré | Votre système a répondu qu’il l’a reçu. |
| échec, réessayé | Il n’a pas répondu comme prévu. Nous réessayons quelques fois. |
| non livré | Chaque tentative a échoué. |
| non envoyé : adresse refusée | L’adresse n’a pas pu être appelée. |
Quand trop d’événements de suite ne peuvent pas être livrés, le point de terminaison se désactive de lui-même, et l’indique. Corrigez l’adresse, envoyez un événement de test, puis réactivez-le.
Bon à savoir
- Un espace de travail a 20 points de terminaison au plus.
- Un point de terminaison créé par une clé qui est ensuite supprimée est désactivé. Modifiez-le et enregistrez-le pour qu’il appartienne à l’espace de travail, puis réactivez-le.
- Ce que contient chaque événement se trouve dans le guide du développeur.