> ## Documentation Index
> Fetch the complete documentation index at: https://www.zippendo.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Échecs de livraison des webhooks

> Que faire lorsque les webhooks Zippendo n'atteignent pas votre système, affichent des erreurs dans le journal des envois ou arrivent plusieurs fois.

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](/docs/fr/how-to/tracking-webhooks).

## 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é

| Cause probable | Que faire |
| - | - |
| Le webhook est **Inactif** | Cliquez sur **Modifier** sur le webhook et activez **Actif**. Un webhook inactif n'envoie rien et ne consigne rien. **Envoyer un test** n'envoie rien non plus, même s'il affiche **Événement de test envoyé** |
| L'événement n'est pas coché | Cliquez sur **Modifier** et vérifiez que l'événement est coché sous **Événements** |
| L'événement ne s'est pas produit | Par exemple, **Expédition envoyée** n'est émis que lorsqu'une expédition est réellement envoyée au transporteur |

## 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é.

| Ce qu'affiche le journal des envois | Cause probable | Que faire |
| - | - | - |
| 404 | L'**URL de destination** est incorrecte, ou l'adresse a changé de votre côté | Corrigez l'**URL de destination** sous **Modifier** |
| 401 ou 403 | Votre système demande un mot de passe ou un jeton, ou bloque les expéditeurs inconnus | Laissez passer les messages de Zippendo, et vérifiez-les plutôt avec la signature (voir ci-dessous) |
| 500-599 | Votre système a planté pendant le traitement du message | Consultez le journal d'erreurs de votre système |
| **N/D** avec une erreur de délai dépassé | Votre système a mis plus de 10 secondes à répondre | Répondez tout de suite, puis effectuez le travail long ensuite |
| **N/D** avec une erreur de connexion | L'adresse est inaccessible depuis Internet, ou son certificat n'est pas valide | Utilisez une adresse `https://` publique avec un certificat valide |

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**.

<Note>
  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.
</Note>

## 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](/docs/fr/quickstarts/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](/docs/fr/how-to/webhooks), [Paramètres des webhooks](/docs/fr/settings/webhooks).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.