Les webhooks vous permettent de recevoir des notifications en temps réel lorsque quelqu'un envoie un message WhatsApp à votre numéro ou lorsque le statut de livraison d'un message sortant change.
Comment ça marche
Lorsqu'un événement se produit (par ex. un message entrant ou une mise à jour du statut de livraison), seven envoie une requête HTTP POST à l'URL du webhook que vous avez configurée. Votre serveur traite la charge utile et répond avec un code de statut 2xx pour accuser réception.
Configurer votre URL de webhook
- Connectez-vous à dashboard.seven.io.
- Naviguez vers Paramètres > Webhooks.
- Saisissez votre URL de webhook - il doit s'agir d'un point de terminaison HTTPS accessible publiquement sur votre serveur.
- Sélectionnez les types d'événements que vous souhaitez recevoir.
- Enregistrez la configuration.
Assurez-vous que votre point de terminaison est joignable et répond dans un délai raisonnable (moins de 10 secondes). Si votre point de terminaison est inaccessible ou renvoie des erreurs à plusieurs reprises, la livraison des webhooks peut être suspendue.
Types d'événements
Message entrant (wa_mo)
Déclenché lorsqu'un utilisateur envoie un message WhatsApp à votre numéro connecté. La charge utile comprend le numéro de téléphone de l'expéditeur, le contenu du message, le type de message et l'horodatage.
Rapports de livraison
Déclenchés lorsque le statut d'un message sortant change. Les statuts incluent :
- sent - le message a été envoyé aux serveurs WhatsApp
- delivered - le message a été livré sur l'appareil du destinataire
- read - le destinataire a lu le message
- failed - le message n'a pas pu être livré
Format de la charge utile
Les charges utiles des webhooks sont envoyées au format JSON dans le corps d'une requête POST. Une charge utile typique de message entrant comprend :
{
"event": "wa_mo",
"from": "491701234567",
"to": "491709876543",
"timestamp": "2026-01-15T10:30:00Z",
"message": {
"type": "text",
"text": "Hello, I have a question about my order."
}
}La structure exacte de la charge utile peut varier en fonction du type de message et de l'événement. Consultez la documentation de l'API pour le schéma complet.
Lecture complémentaire
Pour des informations détaillées sur l'authentification, le comportement de nouvelle tentative et la spécification complète de la charge utile, consultez la documentation de l'API seven.