Configuration des Webhooks
Abonnez-vous aux Webhooks pour recevoir des notifications en cas de modification des paramètres de votre compte WhatsApp Business et de vos signaux de qualité.
La configuration des webhooks n’affectera pas le numéro de téléphone sur votre application WhatsApp Business. Un numéro transféré vers la plateforme WhatsApp Business ne peut plus être utilisé dans votre application WhatsApp Business.
Créer un point de terminaison
Pour pouvoir recevoir des notifications, vous devrez créer un point de terminaison des notifications sur votre serveur.
Votre point de terminaison doit être capable de traiter deux types de demandes HTTPS : Demandes de vérification et Notifications d’évènement. Comme les deux requêtes utilisent le protocole HTTPS, votre serveur doit disposer d’un certificat TLS ou SSL valide, correctement configuré et installé. Les certificats autosignés ne sont pas pris en charge.
En savoir plus sur les Demandes de vérification et les Notifications d’événement 
S’abonner aux webhooks
Pour vous abonner aux webhooks, vous devrez obtenir un ID d’application Meta et des autorisations. Pour ce faire, accédez à l’Espace App Meta. À partir de là, vous pourrez :
- Créer une application Meta dans l’Espace App Meta
- Ajouter le produit Webhooks à votre application Meta dans l’Espace App
Chaque application Meta ne peut avoir qu’un seul point de terminaison configuré à la fois. Si vous devez envoyer les mises à jour de vos Webhooks à plusieurs points de terminaison, plusieurs applications Meta sont nécessaires.
Lorsque vous serez prêt·e à faire évoluer vos messages d’entreprise, vous pourrez avoir besoin de ce qui suit :
- Ajouter l’autorisation
whatsapp_business_management dans votre Espace App
- Procéder et terminer le Contrôle app Meta . Cette étape prend du temps, mais vous pourrez continuer les tests au cours du processus d’examen complet.
Champs d’abonnement disponibles
Champs d’abonnement disponibles
| Nom du champ | Description |
|---|---|
| Vous recevez une notification quand un compte WhatsApp Business a été vérifié. |
| Vous recevez une notification quand votre compte WhatsApp Business a été modifié. Cette modification peut inclure la mise à jour du numéro de téléphone, une violation de politique, l’exclusion d’un compte WhatsApp Business, etc. |
| Vous recevez une notification quand une fonctionnalité a été mise à jour. La modification peut concerner le nombre maximum de numéros de téléphone pouvant être associés à un compte WhatsApp Business ou de conversations par numéro de téléphone. |
| Vous recevez une notification quand le modèle de message est approuvé ou rejeté, ou s’il a été désactivé. |
| Vous recevez une notification quand votre entreprise reçoit un message d’un·e client·e, quand vous envoyez un message à un·e client·e, quand un message est reçu par un·e client·e et quand votre message est lu par un·e client·e. |
| Vous recevez une notification quand le nom associé à un numéro de téléphone est approuvé ou rejeté. |
| Vous recevez une notification quand le statut lié à la qualité d’un numéro de téléphone est mis à jour. |
| Vous recevez une notification quand : |
Consultez la référence sur les Webhooks de compte WhatsApp Businesspour plus d’informations sur le champ de charge utile et la référence sur les Webhooks de l’API Cloud WhatsApppour plus d’informations sur les différents types de notification messages que vous pouvez recevoir.
Charge utile de notification
Toutes les notifications utilisent le format général suivant :
[{
"object": "whatsapp_business_account",
"entry": [{
"id": "{whatsapp-business-account-id}",
"time": {unix-timestamp},
"changes": [{
"field": "{subscribed-field}",
"value": {
# Information that was update
}
}]
}]
}]La grille de premier niveau contient deux objets principaux :
| Paramètre | Description |
|---|---|
Objet auquel vous êtes abonné·e. | |
Cet objet contient les détails de la modification qui a déclenché l’appel de webhooks. |
Consultez la liste complète des objets Webhooks disponibles sur la page Composants.