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

# Livraison et nouvelles tentatives

> Comment Allo livre les webhooks, retente les echecs et gere la recuperation

## Exigences de livraison

Votre endpoint doit :

* Retourner un code de statut **2xx** (200-299) dans un delai de **20 secondes**.
* Etre accessible publiquement via HTTPS.

Toute reponse non-2xx, tout timeout ou tout echec de connexion est considere comme une livraison echouee.

## Calendrier des nouvelles tentatives

En cas d'echec de livraison, Allo retente automatiquement avec un backoff exponentiel :

| Tentative | Delai apres la precedente | Temps total ecoule |
| :-------: | ------------------------- | ------------------ |
|     1     | Immediate                 | 0                  |
|     2     | 5 secondes                | \~5 secondes       |
|     3     | 5 minutes                 | \~5 minutes        |
|     4     | 30 minutes                | \~35 minutes       |
|     5     | 2 heures                  | \~2,5 heures       |
|     6     | 5 heures                  | \~7,5 heures       |
|     7     | 10 heures                 | \~17,5 heures      |
|     8     | 10 heures                 | \~27,5 heures      |

Apres 8 tentatives (\~27,5 heures), le message est marque comme **Echoue**.

## Disjoncteur (Circuit breaker)

Allo desactive automatiquement les endpoints qui echouent de maniere persistante. Le processus fonctionne comme suit :

1. Plusieurs livraisons doivent echouer dans une fenetre de 24 heures, avec au moins 12 heures entre le premier et le dernier echec. Une breve interruption ne declenche pas le disjoncteur.
2. Une fois cette condition remplie, un delai de 5 jours demarre.
3. Si toutes les tentatives de livraison continuent d'echouer pendant **5 jours consecutifs**, l'endpoint est automatiquement desactive.

Pour recuperer :

1. Corrigez le probleme avec votre endpoint.
2. Rendez-vous dans [Parametres > Webhooks](https://web.withallo.com/settings/webhooks) et reactivez le webhook.
3. Utilisez l'option **Recover** dans les parametres du webhook pour rejouer les evenements manques.

## Inspecter les livraisons

Vous pouvez inspecter les tentatives de livraison, consulter les payloads et verifier les details des reponses depuis [Parametres > Webhooks](https://web.withallo.com/settings/webhooks). Selectionnez un webhook pour voir son historique de livraison, filtrer par statut et examiner les livraisons individuelles.

## Nouvelle tentative et recuperation

Depuis l'interface des parametres webhook, vous pouvez :

* **Retry** : retenter immediatement une livraison echouee specifique.
* **Recover** : rejouer les evenements manques en rejouant toutes les livraisons depuis une date donnee. Utilisez cette option apres avoir corrige un endpoint defaillant ou apres une periode d'indisponibilite.

## Garanties de livraison

Allo utilise une livraison **at-least-once** (au moins une fois). Les evenements peuvent etre livres plus d'une fois. Implementez l'idempotence dans votre handler en utilisant l'en-tete `webhook-id`. Voir [Bonnes pratiques](/fr/v2/api-reference/webhooks/best-practices).