25 — Webhooks et Événements
1. Objectif métier
Section titled “1. Objectif métier”Comprendre les événements entrants qui alimentent l’automatisation, les statuts et la traçabilité opérationnelle.
2. Qui utilise ce module (admin/operator)
Section titled “2. Qui utilise ce module (admin/operator)”admin: supervise la santé des webhooks et leur impact métier.operator: comprend les effets visibles (statuts, messages, conversations).
3. Prérequis
Section titled “3. Prérequis”- Onboarding WhatsApp terminé.
- Webhook vérifié et actif.
- Process d’escalade en cas d’incident événementiel.
4. Procédure pas-à-pas (orientée actions produit)
Section titled “4. Procédure pas-à-pas (orientée actions produit)”- Vérifier la validation webhook (challenge/token).
- Contrôler la réception des événements messages/statuts.
- Vérifier les mises à jour de statut templates.
- Contrôler les impacts sur campagnes et Inbox.
- Vérifier le comportement sur événements spéciaux (history, echoes, calls).
5. Scénarios concrets (minimum 2)
Section titled “5. Scénarios concrets (minimum 2)”- Scénario A: mise à jour de statut campagne suite aux retours delivery/read.
- Scénario B: synchronisation historique WhatsApp Business App après onboarding.
6. Erreurs fréquentes et résolution
Section titled “6. Erreurs fréquentes et résolution”- Webhook non validé: vérifier token de vérification et URL exposée.
- Événements non traités: vérifier mapping org via
phone_number_id. - Statuts templates non propagés: vérifier le champ d’événement template dédié.
7. Bonnes pratiques et limites
Section titled “7. Bonnes pratiques et limites”- Traiter les incidents webhook comme incidents critiques de production.
- Documenter les événements observés et leur effet fonctionnel.
- Éviter les modifications de webhook sans fenêtre de contrôle.
8. Référence rapide (champs/statuts/modes)
Section titled “8. Référence rapide (champs/statuts/modes)”- Événements courants:
messages,statuses,message_template_status_update,history,smb_message_echoes,calls. - Vérification: challenge réussi + événements visibles.
- Impact attendu: mise à jour messages, campagnes, templates, conversations.