Sur cette page : configurez les informations d’identification de l’API WhatsApp, les webhooks et une configuration de canal pour connecter votre compte WhatsApp Business, afin que votre environnement soit prêt à envoyer des messages WhatsApp avec Journey Optimizer.
Avant d’envoyer un message WhatsApp, vous devez configurer votre environnement Adobe Journey Optimizer et l’associer à votre compte WhatsApp. Pour ce faire, procédez comme suit :
Ces étapes doivent être exécutées par un Administrateur ou une Administratrice système Adobe Journey Optimizer.
Créer des informations d’identification d’API WhatsApp whatsapp-credentials
-
Dans le rail de gauche, accédez à Administration
>Canaux et sélectionnez le menu Informations d’identification de l’API. Cliquez sur le bouton Créer des informations d’identification de l’API. -
Configurez vos informations d’identification dʼAPI comme indiqué ci-dessous :
- Jeton API : saisissez votre jeton API. Pour en savoir plus, consultez la documentation Meta.
- ID de compte professionnel : saisissez le numéro unique associé à votre porfolio professionnel. Pour en savoir plus, consultez la documentation Meta.
-
Cliquez sur Continuer.
-
Choisissez le compte professionnel WhatsApp que vous souhaitez connecter à vos informations d’identification d’API WhatsApp.
-
Sélectionnez le nom de l’expéditeur ou de l’expéditrice utilisé pour envoyer vos messages WhatsApp.
-
Les paramètres de votre numéro de téléphone sont automatiquement renseignés :
-
Évaluation de la qualité : reflète les commentaires de la clientèle sur les messages envoyés au cours des dernières 24 heures.
- Vert : haute qualité
- Jaune : qualité moyenne
- Rouge : faible qualité
En savoir plus sur l’évaluation de la qualité.
-
Débit : indique la vitesse à laquelle votre numéro de téléphone peut envoyer des messages.
-
-
Cliquez sur Envoyer lorsque vous avez terminé la configuration de vos informations d’identification d’API.
Après avoir créé et configuré vos informations d’identification d’API, vous devez créer votre webhook pour les messages WhatsApp. En savoir plus
Créer un webhook WhatsApp-webhook
Une fois vos informations d’identification d’API WhatsApp créées, vous pouvez configurer les webhooks pour les opérations suivantes :
- Capturer des réponses entrantes pour la gestion du consentement d’opt-in et d’opt-out
- Recevoir les rapports de diffusion tels que les accusés de réception de lecture (le cas échéant) et le statut de diffusion des messages
- Activer le suivi des événements pour les analyses et les rapports dans les jeux de données Adobe Experience Platform
Les webhooks servent de pont de communication entre la plateforme WhatsApp Business de Meta et Adobe Journey Optimizer, ce qui vous permet de recevoir des notifications en temps réel sur les événements de message et les interactions utilisateur.
Meta n’autorise qu’un webhook, une URL de rappel et un jeton de vérification par compte professionnel WhatsApp, partagés sur les sandbox, les informations d’identification d’API et les configurations de canal utilisant ce compte. Les événements de commentaires (envoyés, diffusés, lus, erreur, clic sur un bouton) sont capturés dans chaque sandbox. Événements entrants (réponses, mots-clés relatifs à l’accord préalable/l’exclusion/l’aide) ne sont reçus que dans le sandbox dont le webhook est enregistré dans Meta, quel que soit l’endroit où le message d’origine a été envoyé. Nous vous recommandons d’enregistrer le webhook depuis votre sandbox de production pour y recevoir les événements entrants.
Bonnes pratiques de configuration du Webhook whatsapp-webhook-recommendations
- Créez des informations d’identification d’API WhatsApp principales et un webhook dans le sandbox de production, puis enregistrez son URL Webhook et son jeton de vérification dans Meta. Si Meta utilise actuellement un webhook provenant d’un autre sandbox, remplacez cet enregistrement par les valeurs du webhook de production.
- Vérifiez que le webhook principal reçoit les réponses entrantes et les informations de diffusion avant d’ajouter d’autres configurations d’expéditeur.
- Créez des identifiants d’API WhatsApp supplémentaires et des webhooks pour chaque numéro de téléphone de l’expéditeur. Les webhooks suivants dans le même sandbox ne génèrent pas de nouvelle URL Webhook ni de jeton de vérification.
- Une fois la connexion établie, gardez inchangés l’enregistrement Meta et le webhook principal lors de l’ajout des configurations de l’expéditeur. La production reçoit des commentaires et les événements entrants, l’évaluation et le développement reçoivent des commentaires uniquement.
Créer le webhook create-whatsapp-webhook
-
Dans le rail de gauche, accédez à Administration
>Canaux, sélectionnez le menu Webhooks WhatsApp dans Paramètres WhatsApp, puis cliquez sur le bouton Créer un webhook.
-
Saisissez le Nom de votre webhook.
-
Dans la liste déroulante Sélectionner une configuration, sélectionnez les informations d’identification d’API que vous avez créées précédemment.
-
Choisissez votre catégorie de mots-clés entrants, par exemple :
- Mots-clés d’opt-in
- Mots-clés d’opt-out
- Mots-clés d’aide
- Par défaut : catégorie de secours pour tous les messages entrants qui ne correspondent pas à d’autres mots-clés. Utilisez cette catégorie pour activer le suivi des événements (ouvertures, rapports de diffusion) dans les jeux de données Adobe Experience Platform.
-
Saisissez vos mots-clés, puis cliquez sur
-
Dans le champ Message de réponse, saisissez le message envoyé lors de la réception d’un mot-clé configuré ou sélectionnez une option prédéfinie dans le menu déroulant.
-
Cliquez sur
-
Cliquez sur Envoyer lorsque vous avez terminé la configuration de votre webhook WhatsApp.
-
Dans le menu Webhooks, cliquez sur l’
-
Pour accéder aux valeurs webhook générées, localisez le webhook que vous avez envoyé et cliquez sur Modifier.
-
Copiez le URL du Webhook et le jeton de vérification à partir de ce webhook. Utilisez les deux valeurs du même webhook dans le sandbox sélectionné pour recevoir les événements entrants.
-
Dans la configuration du Webhook Meta pour le compte professionnel WhatsApp connecté, collez l’URL du Webhook dans URL de rappel et l’Jeton de vérification dans Jeton de vérification, puis effectuez la vérification. Le jeton de vérification n’est pas votre jeton API. Pour les étapes de configuration et d’abonnement de Meta, consultez la documentation de Meta.
Maintenant que votre Webhook est configuré, vous pouvez créer votre configuration WhatsApp.
Créer une configuration WhatsApp whatsapp-configuration
-
Dans le rail de gauche, accédez à Administration > Canaux et sélectionnez Paramètres généraux > Configurations de canal. Cliquez sur le bouton Créer une configuration de canal.
-
Saisissez un nom et une description (facultatif) pour la configuration, puis sélectionnez le canal WhatsApp.
note NOTE Les noms doivent commencer par une lettre (A-Z). Ils ne peuvent contenir que des caractères alphanumériques. Vous pouvez également utiliser le trait de soulignement _, le point.et le trait d'union-. -
Sélectionnez WhatsApp en tant que canal.
-
Sélectionnez une ou plusieurs actions marketing pour associer des politiques de consentement aux messages qui utilisent cette configuration. Toutes les politiques de consentement associées à cette action marketing sont utilisées afin de respecter les préférences de vos clientes et clients. En savoir plus
-
Dans la section Paramètres de WhatsApp, sélectionnez la configuration de WhatsApp précédemment créée.
-
Saisissez le numéro de téléphone de l’expéditeur ou de l’expéditrice à utiliser lors de vos communications. N’incluez pas le signe « + » avant le nombre, car cela peut empêcher le flux d’opt-out de fonctionner correctement.
-
Utilisez le Champ d’exécution WhatsApp pour sélectionner, parmi les attributs de profil, le numéro de téléphone à utiliser en priorité si plusieurs numéros sont disponibles dans la base de données. En savoir plus
note NOTE Par défaut, Journey Optimizer utilise le numéro de téléphone spécifié dans les paramètres généraux au niveau du sandbox. La mise à jour de ce champ remplace la valeur par défaut pour les parcours et les campagnes utilisant cette configuration. -
Une fois tous les paramètres configurés, cliquez sur Envoyer pour confirmer. Vous pouvez également enregistrer la configuration de canal en tant que brouillon et reprendre son paramétrage ultérieurement.
-
Une fois la configuration de canal créée, elle s’affiche dans la liste avec le statut En cours de traitement.
note NOTE Si les vérifications ne réussissent pas, découvrez les raisons possibles de l’échec dans cette section. -
Une fois les contrôles réussis, la configuration de canal obtient le statut Actif. Elle est prête à être utilisée pour diffuser des messages.
Une fois configurés, vous pouvez tirer parti de toutes les fonctionnalités d’origine des canaux, telles que la création de messages, la personnalisation, le suivi des liens et la création de rapports.
Vous pouvez maintenant commencer à envoyer des messages WhatsApp avec Journey Optimizer.
Résoudre les problèmes liés à la configuration du canal WhatsApp troubleshooting
Erreurs HTTP 500 lors de la configuration des informations d’identification de l’API
Si vous rencontrez une erreur HTTP 500 lors de la configuration des informations d’identification de l’API WhatsApp, suivez ces étapes de dépannage :
-
Vérifier les droits : confirmez que votre organisation dispose du droit
cjm_whatsapp. Sans ce droit, le canal WhatsApp ne peut pas être configuré. -
Valider les champs du compte d’entreprise : assurez-vous que tous les champs obligatoires sont correctement renseignés :
- Jeton API : doit être un jeton d’accès Meta valide avec les autorisations appropriées. En savoir plus
- ID de compte d’entreprise : doit correspondre exactement à votre ID de compte d’entreprise Meta. En savoir plus
-
Tester les informations d’identification en externe : vérifiez vos informations d’identification directement avec l’API Meta pour confirmer si le problème vient des informations d’identification ou de la gestion des informations d’identification de Journey Optimizer.
-
Activer la journalisation avancée : pour identifier les erreurs de configuration du serveur interne ou de l’authentification, activez les journaux avancés dans votre environnement Journey Optimizer afin de fournir des informations détaillées sur les échecs des appels API.
-
Contacter l’assistance : si la validité de l’environnement et des droits est confirmée mais que l’erreur HTTP 500 persiste, contactez votre représentant Adobe.
Vidéo pratique video
La vidéo ci-dessous montre comment configurer le canal WhatsApp dans Adobe Journey Optimizer.
This section contains structured knowledge intended to support interpretation, retrieval, and question answering related to this topic.
For complete understanding, this information should be combined with the documentation on this page. Neither source is intended to stand alone; the page describes the feature, while this section provides additional context that helps disambiguate terminology, intent, applicability, and constraints.
- TL;DR: This page explains how a System Administrator configures the WhatsApp channel in Journey Optimizer by creating WhatsApp API credentials, a Webhook, and a channel configuration to connect a WhatsApp Business account.
Intents:
- Create WhatsApp API credentials and connect a WhatsApp Business Account
- Create a WhatsApp Webhook to capture inbound responses, receive delivery reports, and enable tracking events
- Create a WhatsApp channel configuration and associate marketing actions and consent policies
- Set the sender phone number and WhatsApp Execution Field for a configuration
- Troubleshoot HTTP 500 errors during API credential setup
Glossary:
- API Credentials: The credential set (API Token and Business Account ID) used to connect Journey Optimizer to a WhatsApp Business Account (product-specific)
- API Token: A Meta access token from a System User in the same Business Manager as your WhatsApp assets, used to authenticate (product-specific)
- Business Account ID: Your Meta Business portfolio ID (Business Manager ID), not the WhatsApp Business Account ID (product-specific)
- Webhook: The communication bridge between Meta’s WhatsApp Business Platform and Journey Optimizer that receives real-time notifications about message events and user interactions (product-specific)
- Inbound keyword category: The classification (Opt-in, Opt-out, Help, Default) that determines which auto-response is sent based on user text (product-specific)
- WhatsApp Execution Field: The field used to select, among profile attributes, the phone number to use in priority when several numbers are available (product-specific)
- Quality Rating: A rating (Green/High, Yellow/Medium, Red/Low) reflecting customer feedback on messages sent in the past 24 hours (product-specific)
- Throughput: The rate at which your phone number can send messages (product-specific)
Guardrails:
- These steps must be performed by a Journey Optimizer System Administrator.
- Meta tokens expire after about 60 days; renew the token before it lapses.
- The API Token’s System User needs whatsapp_business_management, whatsapp_business_messaging, and business_management permissions, plus asset-level access to your WhatsApp Business Account.
- Meta allows only one webhook, callback URL, and Verify Token per WhatsApp Business Account, even across multiple sandboxes or WhatsApp credentials.
- Feedback events (Sent, Delivered, Read, Error, button click) are captured in every sandbox, but inbound events (replies, opt-in/opt-out/help keywords) are received only in the sandbox whose webhook is registered in Meta; registering the webhook from your production sandbox is recommended to receive inbound events there.
- Without specified opt-in or opt-out keywords, standard consent messages are not enabled.
- A profile must have at least one message sent from Journey Optimizer before incoming messages are captured in the dataset.
- Keywords are not case-sensitive (e.g., stop and STOP are treated the same).
- Configuration names must begin with a letter (A-Z), can only contain alpha-numeric characters, and may also use underscore, dot, and hyphen.
- Do not include a ‘+’ sign before the sender phone number, as this can prevent the opt-out flow from working correctly.
- HTTP 500 troubleshooting: the organization must have the
cjm_whatsappentitlement provisioned; without it, the WhatsApp channel cannot be configured.
Terminology:
- Canonical name: WhatsApp channel configuration — Acronym: n/a — variants: channel configuration, WhatsApp configuration
- Synonyms: “Business Account ID” = “Meta Business portfolio ID” = “Business Manager ID”
- Do not confuse: “Business Account ID” (Meta Business portfolio / Business Manager ID) ≠ “WhatsApp Business Account ID” (not entered in this field)
- Do not confuse: “API Credentials” ≠ “Webhook” ≠ “channel configuration” (three distinct setup steps)
- Do not confuse: “Processing” (status while checks run) ≠ “Active” (status once checks are successful and the configuration is ready to deliver)
FAQ:
- Q: What are the steps to configure the WhatsApp channel? — Create WhatsApp API credentials, create a WhatsApp Webhook, then create a WhatsApp channel configuration.
- Q: Who can configure the WhatsApp channel? — A Journey Optimizer System Administrator.
- Q: When do Meta tokens expire? — Meta tokens expire after about 60 days; renew the token before it lapses.
- Q: Why are my inbound events missing in some sandboxes? — Meta allows only one webhook per WhatsApp Business Account, so inbound events are received only in the sandbox whose webhook is registered in Meta; registering the webhook from your production sandbox is recommended.
- Q: What does the channel configuration status mean? — It shows Processing while checks run and becomes Active once checks are successful, meaning it is ready to deliver messages.
- Q: What can I do about an HTTP 500 error during API credential setup? — Verify that the
cjm_whatsappentitlement is provisioned, validate the API Token and Business Account ID fields, test your credentials directly with the Meta API, enable advanced logs, and contact your Adobe representative if the error persists. - Q: Why should I not add a ‘+’ before the sender phone number? — It can prevent the opt-out flow from working correctly.