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 désactive les endpoints qui échouent de façon continue pendant 5 jours. Pour corriger :
  1. Consultez l’historique des livraisons dans Paramètres > Webhooks pour comprendre pourquoi les livraisons ont échoué.
  2. Corrigez le problème sous-jacent (URL modifiée, serveur hors ligne, erreur d’authentification, etc.).
  3. Réactivez le webhook depuis Paramètres > Webhooks.
  4. Utilisez l’option Récupérer pour rejouer les événements manqués.
Vérifiez ces causes courantes :
  • 401/403 : Votre endpoint nécessite une authentification. Les requêtes webhook n’incluent pas votre clé API — elles utilisent la vérification de signature à la place.
  • 404 : L’URL du webhook est incorrecte ou le routage de votre serveur ne correspond pas.
  • 500 : Votre handler génère une erreur. Consultez les logs de votre serveur.
  • Firewall/WAF : Votre pare-feu ou WAF peut bloquer les requêtes. Autorisez les requêtes POST entrantes vers votre chemin webhook.
Causes courantes :
  • Corps parsé : Vous devez utiliser le corps brut de la requête pour la vérification. Si votre framework parse automatiquement le JSON et que vous le re-sérialisez, les différences 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 spécifique.
  • Décalage d’horloge : L’horloge de votre serveur doit être à moins de 5 minutes de l’heure réelle. Vérifiez que NTP fonctionne sur votre serveur.
  • Modification par un middleware : Les proxys ou middlewares qui modifient les en-têtes ou le corps de la requête invalident la signature.
Vérifiez les points suivants :
  1. Le webhook est activé : Allez dans Paramètres > Webhooks et vérifiez que le webhook est activé.
  2. Les topics correspondent : Vérifiez que les types d’événements attendus sont sélectionnés dans la configuration du webhook.
  3. Historique des livraisons : Consultez l’historique des livraisons dans les paramètres du webhook — les événements peuvent échouer silencieusement.
  4. L’URL est accessible : Assurez-vous que votre endpoint est accessible publiquement via HTTPS. Utilisez la fonctionnalité de test pour vérifier.
C’est un comportement attendu. Allo utilise une livraison « au moins une fois », les événements peuvent donc être livrés plus d’une fois.Implémentez l’idempotence en utilisant l’en-tête webhook-id comme clé de déduplication. Voir Bonnes pratiques.
Votre endpoint doit répondre dans les 20 secondes. Si votre traitement prend plus de temps :
  1. Retournez 200 immédiatement à la réception de la requête.
  2. Mettez l’événement en file d’attente pour un traitement en arrière-plan.
  3. Traitez l’événement de manière asynchrone (par exemple, avec une file de messages ou un job en arrière-plan).
Voir Bonnes pratiques — Répondre rapidement.

​
Besoin d’aide ?

Contacter le support

Contactez notre équipe support

Référence API

Parcourir la documentation complète des webhooks