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.
Exigences de livraison
Votre endpoint doit :- Retourner un code de statut 2xx (200–299) dans un délai de 20 secondes.
- Être accessible publiquement via HTTPS.
Calendrier des nouvelles tentatives
En cas d’échec de livraison, Allo retente automatiquement avec un backoff exponentiel :| Tentative | Délai après la précédente | Temps total écoulé |
|---|---|---|
| 1 | Immédiat | 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 |
Disjoncteur (circuit breaker)
Allo désactive automatiquement les endpoints qui échouent de manière persistante. Le processus fonctionne comme suit :- Plusieurs livraisons doivent échouer dans une fenêtre de 24 heures, avec au moins 12 heures entre le premier et le dernier échec. Une panne brève ne déclenche pas le disjoncteur.
- Une fois cette condition remplie, un minuteur de 5 jours démarre.
- Si toutes les tentatives de livraison continuent d’échouer pendant 5 jours consécutifs, l’endpoint est automatiquement désactivé.
- Corrigez le problème de votre endpoint.
- Allez dans Paramètres > Webhooks et réactivez le webhook.
- Utilisez l’option Récupérer dans les paramètres du webhook pour rejouer les événements manqués.
Inspecter les livraisons
Vous pouvez inspecter les tentatives de livraison, consulter les payloads et vérifier les détails des réponses depuis Paramètres > Webhooks. Sélectionnez un webhook pour voir son historique de livraison, filtrer par statut et examiner les livraisons individuelles.Nouvelle tentative et récupération
Depuis l’interface des paramètres webhook, vous pouvez :- Réessayer une livraison échouée immédiatement.
- Récupérer les événements manqués en rejouant toutes les livraisons depuis une date donnée. Utilisez cette fonctionnalité après avoir corrigé un endpoint défaillant ou après une interruption de service.
Garanties de livraison
Allo utilise la livraison au moins une fois (at-least-once). Les événements peuvent être livrés plus d’une fois. Implémentez l’idempotence dans votre handler en utilisant l’en-têtewebhook-id. Consultez les Bonnes pratiques.