Aller au contenu
Essai gratuit de 14 jours, sans carte9 langues176 types d'activité · 50 applications
FR· USD
Essayer une démo en directEssai gratuit

Webhooks sortants : comment ça marche

Un webhook est un message que le système envoie à une adresse de votre choix dès qu'un événement se produit : nouveau prospect, facture envoyée, paiement reçu ou commande passée. Un autre système peut ainsi réagir aussitôt au lieu de demander encore et encore.

Leçon 3 sur 9 · Comment ça marche

  • environ 3 min
  • System → Integrations → Integrations & API

Comment ça marche

  1. Sur «System → Integrations → Integrations & API», appuyez sur «Add endpoint» dans le panneau «Webhook endpoints». Saisissez un nom et l'adresse, puis cochez «All events» ou choisissez des événements dans la liste.

  2. Après l'enregistrement, le «Webhook signing secret» s'affiche une seule fois. Copiez-le dans le système récepteur, qui s'en sert pour vérifier qu'un envoi vient bien de votre site.

  3. Quand un événement suivi se produit, le système envoie aussitôt les détails à l'adresse. Le récepteur doit répondre par un succès dans les 10 secondes.

  4. Un envoi qui échoue est retenté après 1 minute, 5 minutes, 30 minutes, 2 heures, 12 heures et 24 heures. Il est ensuite marqué comme échoué.

  5. Un endpoint qui échoue 25 fois de suite est désactivé par le système, et le tableau de bord affiche une tâche à faire. Appuyez sur «Enable» sur sa ligne une fois le récepteur rétabli.

  6. «Test» sur la ligne, ou «Send test event» sur la page de l'endpoint, envoie un message de test. La page de l'endpoint affiche aussi ses derniers envois et permet de remplacer le secret avec «Rotate secret».

  7. «Delivery log» liste chaque envoi avec son statut, son endpoint et son événement, le contenu envoyé et la réponse reçue. «Retry now» renvoie un envoi échoué. Les lignes sont conservées 30 jours.

Où le trouver

Réglages qui le modifient

Liste de contrôle

Avant de continuer, vérifiez que vous savez :

  • Ouvrir System → Integrations → Integrations & API
  • Sur System → Integrations → Integrations & API, appuyez sur Add endpoint dans le panneau Webhook endpoints.
  • Après l'enregistrement, le Webhook signing secret s'affiche une seule fois.
  • Quand un événement suivi se produit, le système envoie aussitôt les détails à l'adresse.
  • Un envoi qui échoue est retenté après 1 minute, 5 minutes, 30 minutes, 2 heures, 12 heures et 24 heures.

Astuces et erreurs fréquentes

  • Rien n'arrive ? Ouvrez le journal des envois et lisez la réponse sur la ligne en échec. Une mauvaise adresse ou un récepteur qui met plus de 10 secondes sont les causes habituelles.
  • Le même envoi peut arriver plusieurs fois après une nouvelle tentative. Le système récepteur doit utiliser l'identifiant d'envoi pour ignorer les doublons.
  • Après «Rotate secret», l'envoi suivant est déjà signé avec le nouveau secret : mettez à jour le système récepteur au même moment.
  • Les nouvelles tentatives sont envoyées par le processus d'arrière-plan. Tant qu'il est arrêté, les envois échoués ne sont pas retentés.