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.

Les webhooks permettent a Allo d’envoyer des evenements a votre serveur en temps reel. Lorsque quelque chose se produit — un appel se termine, un SMS arrive, un contact est cree — Allo envoie une requete HTTPS POST a votre endpoint avec les donnees de l’evenement.

​
Comment ca fonctionne

  1. Un evenement se produit dans votre compte Allo (par ex., un appel est termine).
  2. Allo envoie une requete HTTPS POST a l’URL que vous avez configuree.
  3. Votre serveur recoit la requete, verifie la signature et traite l’evenement.

​
Evenements disponibles

EvenementDescription
call.receivedUn appel entrant commence a sonner
call.triggeredUn appel sortant est initie
call.completedUn appel est termine avec toutes les donnees (enregistrement, transcription, resume)
tag.addedUn tag est ajoute a un appel
tag.removedUn tag est supprime d’un appel
sms.receivedUn SMS entrant est recu
sms.sentUn SMS sortant est envoye
contact.createdUn contact est cree
contact.updatedUn contact est mis a jour
Consultez le Catalogue d’evenements pour les schemas complets des payloads.

​
Format du payload

Chaque webhook utilise le meme format d’enveloppe : 
{
  "topic": "call.completed",
  "version": "2.0",
  "timestamp": "2025-03-15T14:30:45.123456Z",
  "data": {
    // Champs specifiques a l'evenement
  }
}
ChampTypeDescription
topicstringType d’evenement (par ex., call.completed, sms.received)
versionstringVersion du payload, toujours "2.0"
timestampstringHorodatage ISO 8601 indiquant quand l’evenement a ete envoye
dataobjectPayload specifique a l’evenement

​
Demarrage rapide

1

Creer un endpoint webhook

Rendez-vous dans Parametres > Webhooks dans votre tableau de bord Allo. Ajoutez l’URL HTTPS de votre endpoint et selectionnez les evenements que vous souhaitez recevoir. Le webhook s’applique a tous les numeros Allo de votre workspace.
2

Traiter les requetes entrantes

Votre endpoint recoit des requetes POST avec le payload de l’evenement dans le corps. Retournez un code de statut 2xx dans les 20 secondes pour confirmer la reception.
3

Verifier les signatures

Chaque webhook inclut une signature cryptographique. Verifiez-la pour vous assurer que la requete provient bien d’Allo. Voir Verification des signatures.

​
Etapes suivantes

Catalogue d'evenements

Reference complete de tous les evenements et leurs payloads

Verification des signatures

Authentifiez les webhooks entrants avec HMAC-SHA256