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

# Webhooks

> Envoyez les événements d'expédition, de commande et de suivi de Zippendo vers votre propre système dès qu'ils se produisent.

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

<Steps>
  <Step title="Ouvrir la fenêtre">
    Cliquez sur **Ajouter un webhook** (ou sur **Créer votre premier webhook** si la liste est vide).
  </Step>

  <Step title="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://`.
  </Step>

  <Step title="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**.
  </Step>

  <Step title="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é.
  </Step>
</Steps>

<Info>
  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](/docs/fr/quickstarts/webhooks).
</Info>

## 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](/docs/api-reference/overview)).
* HTTPS : utilisez uniquement des adresses `https://`, afin que les messages soient chiffrés pendant le trajet.

## Marques

Si votre organisation utilise des [marques](/docs/fr/settings/brands), 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](/docs/fr/how-to/webhooks).


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