Passer au contenu principal

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 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 :
TentativeDelai apres la precedenteTemps total ecoule
1Immediate0
25 secondes~5 secondes
35 minutes~5 minutes
430 minutes~35 minutes
52 heures~2,5 heures
65 heures~7,5 heures
710 heures~17,5 heures
810 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 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. 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.