Skip to main content
Un webhook fait que Zippendo informe un autre système d’un événement, comme Expédition envoyée ou Suivi mis à jour. Vous configurez les webhooks sous Paramètres → Webhooks (ouvrez le menu de l’organisation et cliquez sur Gérer). Pour chaque événement, Zippendo envoie un message à l’URL de destination que vous avez saisie. Ce ne sont pas les webhooks de suivi des transporteurs. Pour ceux-ci, voir Webhooks de suivi des transporteurs.

​
Ce que vous voyez

  • Votre système ne reçoit jamais rien.
  • Le Journal des envois d’un webhook affiche des codes de statut rouges ou du texte dans la colonne Erreur.
  • Votre système reçoit plusieurs fois le même événement.

​
D’abord, consultez le journal des envois

Sur Webhooks, cliquez sur Journal des envois pour le webhook. Chaque ligne est une tentative, avec l’Événement, le Statut avec lequel votre système a répondu, la Durée et une éventuelle Erreur.
  • Aucun envoi pour le moment : Zippendo n’a rien essayé d’envoyer. Voir « Rien n’est envoyé » ci-dessous.
  • Un statut vert : votre système a reçu le message. Cherchez le problème dans votre propre système.
  • Un statut rouge ou N/D avec une erreur : votre système n’a pas accepté le message. Voir « Les envois échouent » ci-dessous.

​
Rien n’est envoyé

​
Les envois échouent

Zippendo ne considère un envoi comme réussi que lorsque votre système répond avec un statut de succès (200-299) en moins de 10 secondes. Sinon, il réessaie encore plusieurs fois en une minute environ, 5 tentatives au total. Ensuite, l’événement n’est plus renvoyé. Après avoir corrigé la cause, cliquez sur Envoyer un test sur le webhook. Vous voyez Événement de test envoyé, et une nouvelle ligne apparaît dans le Journal des envois.
Zippendo ne renvoie pas plus tard les événements échoués. Si votre système a été indisponible un moment, retrouvez les expéditions ou les commandes manquées dans l’application Zippendo, ou récupérez-les via l’API.

​
Votre système rejette la signature

Chaque message comporte un en-tête X-Webhook-Signature pour que votre système puisse vérifier qu’il provient bien de Zippendo. C’est un HMAC-SHA256 du corps brut du message, calculé avec le secret du webhook. Erreurs courantes :
  • La signature est calculée sur le message après qu’il a été analysé et réécrit, au lieu d’être calculée sur le corps brut tel qu’il a été reçu.
  • Le secret d’un autre webhook est utilisé. Chaque webhook a son propre secret.
Détails et exemples de code : Démarrage rapide des webhooks.

​
Le même événement arrive deux fois

Si votre système a répondu trop lentement ou par une erreur, Zippendo réessaie, même si votre système a bien traité la première tentative. Utilisez l’en-tête X-Webhook-Id pour reconnaître un message que vous avez déjà traité. Voir aussi : Webhooks, Paramètres des webhooks.