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 à Allo d’envoyer des événements vers votre serveur en temps réel. Lorsqu’un événement se produit — un appel se termine, un SMS arrive, un contact est créé — Allo envoie une requête HTTPS POST vers votre endpoint avec les données de l’événement.

​
Comment ça fonctionne

  1. Un événement se produit dans votre compte Allo (par exemple, un appel se termine).
  2. Allo envoie une requête HTTPS POST vers l’URL que vous avez configurée.
  3. Votre serveur reçoit la requête, vérifie la signature et traite l’événement.

​
Événements disponibles

ÉvénementDescription
call.receivedAppel entrant en cours de sonnerie
call.triggeredAppel sortant initié
call.completedAppel terminé avec toutes les données (enregistrement, transcription, résumé)
tag.addedTag ajouté à un appel
tag.removedTag retiré d’un appel
sms.receivedSMS entrant reçu
sms.sentSMS sortant envoyé
contact.createdContact créé
contact.updatedContact mis à jour
Consultez le Catalogue des événements pour les schémas complets des payloads.

​
Format du payload

Chaque webhook utilise le même format d’enveloppe : 
{
  "topic": "call.completed",
  "version": "2.0",
  "timestamp": "2025-03-15T14:30:45.123456Z",
  "data": {
    // Champs spécifiques à l'événement
  }
}
ChampTypeDescription
topicstringType d’événement (ex. call.completed, sms.received)
versionstringVersion du payload, toujours "2.0"
timestampstringHorodatage ISO 8601 de l’envoi de l’événement
dataobjectPayload spécifique à l’événement

​
Démarrage rapide

1

Créer un endpoint webhook

Allez dans Paramètres > Webhooks dans votre tableau de bord Allo. Ajoutez l’URL HTTPS de votre endpoint et sélectionnez les événements que vous souhaitez recevoir. Le webhook s’applique à tous les numéros Allo de votre workspace.
2

Traiter les requêtes entrantes

Votre endpoint reçoit des requêtes POST avec le payload de l’événement dans le corps. Retournez un code de statut 2xx dans les 20 secondes pour confirmer la réception.
3

Vérifier les signatures

Chaque webhook inclut une signature cryptographique. Vérifiez-la pour vous assurer que la requête provient d’Allo. Consultez Vérification des signatures.

​
Prochaines étapes

Catalogue des événements

Référence complète de tous les événements et leurs payloads

Vérification des signatures

Authentifier les webhooks entrants avec HMAC-SHA256