Ajouter et gérer des webhooks sortants dans les paramètres Flowella

Un webhook sortant permet à Flowella d’envoyer une requête HTTP POST à votre propre système chaque fois qu’un événement choisi se produit, par exemple lorsqu’un contact envoie un message WhatsApp. Cette page explique comment ajouter, tester et gérer des endpoints de webhook dans l’application. Pour les types d’événements, les corps de requête, les en-têtes et la vérification des signatures, consultez la référence des webhooks.

​

Avant de commencer

• Vous devez avoir le rôle Owner ou Admin. Les autres rôles voient Webhooks dans le menu, mais la liste ne se charge pas pour eux. Consultez Équipe et rôles.
• Vous avez besoin d’une URL publique qui accepte les requêtes POST avec un corps JSON et qui répond avec un statut 2xx en moins de 10 secondes.
• Choisissez un secret de signature d’au moins 8 caractères et stockez-le à un endroit où votre gestionnaire peut le lire. Flowella l’utilise pour signer chaque requête et ne l’affiche plus jamais après l’enregistrement.

​

Ajouter un endpoint de webhook

​

Règles pour les URL

Flowella vérifie l’URL lors de l’enregistrement, puis à nouveau avant chaque livraison. L’URL doit :

• Commencer par https:// ou http://. Le simple http:// fonctionne, mais la charge utile circule alors sans chiffrement : utilisez donc https:// en dehors des tests rapides.
• Ne contenir ni nom d’utilisateur ni mot de passe.
• Pointer vers une adresse publique. Flowella refuse localhost, les noms d’hôte se terminant par .localhost ou .local, ainsi que metadata.google.internal. Il refuse aussi les noms d’hôte qui ne se résolvent pas. Les adresses privées, de bouclage, link-local et non spécifiées sont également refusées, que vous les saisissiez directement ou qu’un nom d’hôte pointe vers elles. Par exemple 10.0.0.5, 127.0.0.1, 169.254.169.254, 192.168.1.10 et ::1.
• Ne pas dépasser 2 048 caractères.

Une URL qui enfreint ces règles affiche l’erreur Webhook URL host is not allowed.

​

Envoyer un événement de test

Utilisez un événement de test pour vérifier que votre endpoint reçoit et accepte les requêtes avant l’arrivée des événements réels.

1. Dans la liste, sélectionnez le bouton … à la fin de la ligne du webhook pour ouvrir son menu d’actions.
2. Sélectionnez Send test event. Une confirmation apparaît sous l’URL du webhook.
3. Ouvrez Delivery log depuis le même menu. Une ligne webhook.test avec le Result OK signifie que votre endpoint a répondu avec un statut 2xx.

Un événement de test a le type webhook.test et les data { "test": true, "sentAt": "..." }. Flowella l’envoie quels que soient les événements cochés, et même lorsque le webhook est inactif. La référence des webhooks présente le corps complet.

​

Journal de livraison

Sélectionnez Delivery log dans le menu d’actions d’un webhook pour afficher ses 50 dernières tentatives de livraison, des plus récentes aux plus anciennes. Le journal de l’application n’affiche pas les corps de réponse et ne propose pas de bouton de relivraison. Pour lire les 1 024 premiers caractères d’un corps de réponse, ou pour relivrer un événement, utilisez l’API des livraisons de webhooks.

​

Nouvelles tentatives et délais

Une livraison réussit lorsque votre endpoint répond avec un statut 2xx en moins de 10 secondes. Sinon, Flowella réessaie immédiatement : 3 tentatives au total, environ 1 seconde après le premier échec et environ 2 secondes après le deuxième. Après la troisième tentative échouée, Flowella abandonne cet événement et ne le réessaie pas plus tard. Le diagramme montre ce qui arrive à chaque événement et à quel moment Flowella désactive un webhook. Lorsque 10 événements d’affilée échouent à toutes leurs tentatives, Flowella désactive le webhook et son statut passe à Inactive. Chaque Owner de l’organisation reçoit une notification dans l’application intitulée « Outbound webhook disabled », quelles que soient ses préférences de notification. Toute livraison réussie remet le compteur à zéro. Tant qu’un webhook est inactif, Flowella ne lui envoie aucun événement et ne les conserve pas pour un envoi ultérieur. Pour rattraper les événements manqués, lisez le flux d’événements avec GET /v1/events, qui conserve les événements pendant 7 jours. Consultez la référence des webhooks.

​

Gérer les endpoints

Le menu d’actions de chaque ligne propose Edit, Send test event, Delivery log et Delete.

​

Modifier un webhook

Sélectionnez Edit pour ouvrir la boîte de dialogue Edit webhook. Vous pouvez modifier :

• Endpoint URL.
• Events. Au moins un événement doit rester coché.
• Webhook active. Décochez cette option pour suspendre temporairement les livraisons. Les événements survenus pendant que le webhook est inactif ne sont pas envoyés plus tard.
• New signing secret. Laissez ce champ vide pour conserver le secret actuel. Un nouveau secret doit comporter au moins 8 caractères, sinon Flowella conserve le secret actuel.

Sélectionnez Save pour appliquer les modifications. La boîte de dialogue de modification affiche aussi Name (optional), mais un nom modifié n’est pas enregistré. Pour renommer un webhook, utilisez PATCH /v1/webhooks/{id} avec un name.

​

Réactiver un webhook

Une fois qu’un webhook a été désactivé par Flowella, corrigez d’abord le problème sur votre endpoint. Ensuite :

1. Sélectionnez Edit, cochez Webhook active et sélectionnez Save.
2. Sélectionnez Send test event et vérifiez que le Delivery log affiche OK.

Ne sautez pas le test. Réactiver le webhook dans l’application laisse son compteur d’échecs à 10 : un seul événement en échec le désactive donc à nouveau. Une livraison réussie, comme un événement de test validé, remet le compteur à zéro. L’appel d’API POST /v1/webhooks/{id}/reactivate réactive le webhook et remet le compteur à zéro en une seule étape.

​

Supprimer un webhook

Sélectionnez Delete, puis confirmez Delete dans la boîte de dialogue Delete webhook?. Flowella supprime l’endpoint et son historique de livraison. Cette action est irréversible.

​

Dépannage

​

Pages associées