Skip to main content
Les Webhooks permettent à votre propre système d’être informé immédiatement des expéditions, des commandes et du suivi. Quand un événement que vous avez choisi se produit, par exemple l’envoi d’une expédition, Zippendo envoie un message à une adresse (URL) de votre serveur. La configuration est généralement réalisée par un développeur. Les webhooks sont inclus dans toutes les formules (jusqu’à 5 avec Free, 10 avec Standard, 25 avec Growth, 100 avec Pro, illimités avec Enterprise).

​
Où les trouver

Ouvrez le menu de l’organisation en bas de la barre latérale, cliquez sur Gérer, puis sur l’onglet Webhooks. Vous voyez vos webhooks et un bouton Ajouter un webhook.

​
Ajouter un webhook

1

Ouvrir la fenêtre

Cliquez sur Ajouter un webhook (ou sur Créer votre premier webhook si la liste est vide).
2

Nom et adresse

Saisissez un Nom * et l’URL de destination *, par exemple https://your-server.com/webhooks/zippendo. Utilisez une adresse qui commence par https://.
3

Choisir les événements

Cochez les Événements * souhaités, comme Expédition envoyée ou Suivi mis à jour, ou cliquez sur Tout sélectionner.
4

Enregistrer

Cliquez sur Créer un webhook. Zippendo envoie désormais chaque événement sélectionné à votre adresse. Votre serveur doit répondre rapidement avec un statut 2xx, afin que Zippendo sache que le message est bien arrivé.
Chaque message contient le nom de l’événement, l’heure et les détails de l’expédition, de la commande ou du suivi. Le contenu exact et la façon de vérifier la signature se trouvent dans le Démarrage rapide des webhooks.

​
Sécuriser les webhooks

  • Signature : Zippendo signe chaque message avec un secret propre au webhook. Votre développeur l’utilise pour vérifier qu’un message provient bien de Zippendo. L’application n’affiche pas le secret ; un développeur le lit via l’API (la requête Get webhook de la référence de l’API).
  • HTTPS : utilisez uniquement des adresses https://, afin que les messages soient chiffrés pendant le trajet.

​
Marques

Si votre organisation utilise des marques, vous pouvez attribuer une marque à un webhook. Il ne reçoit alors que les événements de cette marque. Un webhook sans marque reçoit les événements de toutes les marques. Définissez la Marque quand vous ajoutez ou modifiez le webhook.

​
Suspendre ou supprimer un webhook

  • Suspendre : cliquez sur Modifier sur le webhook, décochez Active et cliquez sur Enregistrer les modifications. Zippendo cesse d’envoyer à cette adresse mais conserve le webhook et son Journal des envois.
  • Supprimer : cliquez sur Supprimer, saisissez le nom du webhook en majuscules et confirmez. Plus aucun message n’est envoyé à cette adresse, et son Journal des envois est supprimé.
Chaque champ, le journal des envois et les messages de test : Webhooks.