Webhooks

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.

​

Ce que vous pouvez faire avec les webhooks

• Enregistrer les appels et messages dans votre CRM ou base de données
• Déclencher des workflows lorsque les appels se terminent ou que des SMS arrivent
• Synchroniser les contacts avec des systèmes externes
• Construire des tableaux de bord et alertes en temps réel

​

Événements disponibles

​

Comment configurer les webhooks

curl -X POST https://api.withallo.com/v2/webhooks \
  -H "Authorization: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://example.com/webhooks/allo",
    "topics": ["call.completed", "sms.received"]
  }'

​

Format du payload webhook

{
  "topic": "call.completed",
  "version": "2.0",
  "timestamp": "2025-03-15T14:45:00.000Z",
  "data": {
    "id": "cll_2NfDKEm9sF8xK3pQr1Zt",
    "from_number": "+33612345678",
    "to": "+33112345678",
    "type": "INBOUND",
    "result": "ANSWERED",
    "summary": "Le client a appelé pour une question de facturation.",
    "recording_url": "https://storage.withallo.com/recordings/abc123.mp3"
  }
}

​

Sécurité

• L’URL de votre endpoint doit utiliser HTTPS.
• Chaque webhook inclut une signature cryptographique dans l’en-tête webhook-signature. Vérifiez-la pour vous assurer que la requête est authentique.
• Conservez votre secret de signature de manière sécurisée — traitez-le comme un mot de passe.

​

Fiabilité

• Allo réessaie les livraisons échouées jusqu’à 8 fois sur environ 27,5 heures avec un backoff exponentiel.
• Si votre endpoint échoue de façon continue pendant 5 jours, il est automatiquement désactivé.
• Vous pouvez récupérer les événements manqués en les rejouant après avoir corrigé votre endpoint.

​

Exemples d’implémentation

const express = require("express");
const app = express();

app.post(
  "/webhooks/allo",
  express.raw({ type: "application/json" }),
  (req, res) => {
    const event = JSON.parse(req.body);

    switch (event.topic) {
      case "call.completed":
        console.log("Appel terminé :", event.data.id);
        break;
      case "sms.received":
        console.log("SMS de :", event.data.from_number);
        break;
    }

    res.sendStatus(200);
  }
);

app.listen(3000);

from flask import Flask, request

app = Flask(__name__)

@app.route("/webhooks/allo", methods=["POST"])
def handle_webhook():
    event = request.get_json()

    if event["topic"] == "call.completed":
        print(f"Appel terminé : {event['data']['id']}")
    elif event["topic"] == "sms.received":
        print(f"SMS de : {event['data']['from_number']}")

    return "", 200

​

Dépannage

​

Besoin d’aide ?