Retour à l’aide›Connecter Zapier avec des webhooks

Connecter Zapier avec des webhooks

Envoyez à Zapier des événements de l’espace de travail, comme une facture payée ou une nouvelle conversation, au moyen d’un webhook sortant signé.

1. Commencer un Zap avec un déclencheur webhook

   L’application est en anglais pour l’instant : les écrans ci-dessous gardent leurs libellés anglais. Dans Zapier, créez un Zap et choisissez « Webhooks by Zapier » comme déclencheur. Choisissez « Catch Raw Hook » pour que les en-têtes de la requête parviennent au Zap, puis copiez l’adresse du webhook affichée par Zapier.

   Bon à savoir : UnifyDesk envoie une requête JSON signée standard : tout outil d’automatisation qui accepte les webhooks entrants fonctionne de la même façon.

2. Ajouter le point de terminaison dans UnifyDesk

   Sélectionnez l’espace, puis ouvrez Settings → This workspace → Access & API → « Webhooks » et choisissez « Manage endpoints ». Choisissez « New endpoint », remplissez « Name », collez l’adresse Zapier dans « URL », cochez les « Events » à envoyer, par exemple « Invoice paid » ou « Conversation created », laissez « Active » coché et choisissez « Save ».

   Bon à savoir : La gestion des webhooks demande un administrateur de l’espace ou de l’organisation.

3. Conserver la clé de signature

   Après le premier enregistrement, « New webhook signing secret » affiche la clé une seule fois. Choisissez « Copy », conservez-la dans Zapier (par exemple dans une étape « Code by Zapier »), puis choisissez « Done ». Utilisez « Rotate secret » sur le point de terminaison si la clé est exposée.

4. Envoyer une livraison de test

   Dans « Webhook endpoints », choisissez « Send test » sur le point de terminaison et confirmez avec « Send test ». Dans Zapier, chargez la requête de test et associez ses champs. Chaque livraison contient « event », « data », « delivery_id » et « timestamp ».

5. Vérifier chaque livraison avant d’agir

   Chaque livraison est signée en HMAC-SHA256 sur le corps brut avec la clé de signature. Comparez-la à l’en-tête « X-Webhook-Signature », vérifiez que « X-Webhook-Delivery » et « X-Webhook-Timestamp » correspondent à « delivery_id » et « timestamp » dans le corps, refusez les horodatages anciens et ignorez un identifiant de livraison déjà traité.

   Bon à savoir : Choisissez « View delivery log » dans Settings → Webhooks pour voir chaque livraison et son résultat. Un point de terminaison en échec répété y affiche son nombre d’échecs.