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.

Allo desactive les endpoints qui echouent de maniere continue pendant 5 jours. Pour corriger :
  1. Verifiez l’historique des livraisons dans Parametres > Webhooks pour comprendre pourquoi les livraisons ont echoue.
  2. Corrigez le probleme sous-jacent (URL modifiee, serveur en panne, erreur d’authentification, etc.).
  3. Reactivez le webhook depuis Parametres > Webhooks.
  4. Utilisez l’option Recover pour rejouer les evenements manques.
Verifiez ces causes courantes :
  • 401/403 : Votre endpoint necessite une authentification. Les requetes webhook n’incluent pas votre cle API — elles utilisent la verification de signature a la place.
  • 404 : L’URL du webhook est incorrecte ou le routage de votre serveur ne correspond pas.
  • 500 : Votre handler genere une erreur. Verifiez les logs de votre serveur.
  • Pare-feu/WAF : Votre pare-feu ou votre WAF (Web Application Firewall) bloque peut-etre les requetes. Autorisez les requetes POST entrantes vers le chemin de votre webhook.
Causes courantes :
  • Corps parse : Vous devez utiliser le corps brut de la requete pour la verification. Si votre framework parse automatiquement le JSON et que vous le re-serialisez, les differences d’espacement invalideront la signature. Utilisez express.raw() en Node.js ou request.get_data() en Flask.
  • Mauvais secret : Assurez-vous d’utiliser le bon secret de signature whsec_... pour cet endpoint specifique.
  • Decalage d’horloge : L’horloge de votre serveur doit etre a moins de 5 minutes de l’heure reelle. Verifiez que NTP fonctionne sur votre serveur.
  • Modification par un middleware : Les proxies ou middlewares qui modifient les en-tetes ou le corps de la requete invalideront la signature.
Verifiez les points suivants :
  1. Le webhook est active : Rendez-vous dans Parametres > Webhooks et verifiez que le webhook est active.
  2. Les topics correspondent : Verifiez que les types d’evenements attendus sont selectionnes dans la configuration du webhook.
  3. Historique des livraisons : Consultez l’historique des livraisons dans les parametres de votre webhook — les evenements echouent peut-etre silencieusement.
  4. L’URL est accessible : Assurez-vous que votre endpoint est accessible publiquement via HTTPS. Utilisez la fonctionnalite de test pour verifier.
C’est un comportement attendu. Allo utilise une livraison at-least-once (au moins une fois), les evenements peuvent donc etre livres plus d’une fois.Implementez l’idempotence en utilisant l’en-tete webhook-id comme cle de deduplication. Voir Bonnes pratiques.
Votre endpoint doit repondre dans les 20 secondes. Si votre traitement prend plus de temps :
  1. Retournez 200 immediatement a la reception de la requete.
  2. Mettez l’evenement en file d’attente pour un traitement en arriere-plan.
  3. Traitez l’evenement de maniere asynchrone (par ex., en utilisant une file de messages ou un job en arriere-plan).
Voir Bonnes pratiques — Repondre rapidement.

​
Besoin d’aide ?

Contacter le support

Contactez notre equipe de support

Reference API

Parcourez la documentation complete des webhooks