Commencer la configuration WhatsApp whatsapp-config
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 identifiants d'API WhatsApp créés avec succès, vous pouvez configurer les Webhooks pour :
- Capture 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 agissent comme le pont de communication entre la plateforme commerciale WhatsApp 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.
-
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
pour ajouter un mot-clé entrant. -
Cliquez sur Envoyer lorsque vous avez terminé la configuration de votre webhook WhatsApp.
-
Dans le menu Webhooks, cliquez sur l’
pour supprimer votre webhook WhatsApp.
-
Pour modifier la configuration existante et accéder à votre URL de webhook ou à votre jeton de vérification de webhook, recherchez le webhook souhaité, puis cliquez sur l’option Modifier pour apporter les modifications nécessaires.
-
Copiez votre jeton de vérification de webhook généré ici, puis collez-le dans l’interface Meta dans le cadre de votre configuration de webhook.
Pour obtenir des instructions détaillées pour l’ajout de ce jeton de vérification et l’emplacement où le faire, reportez-vous à la documentation Meta.
-
Accédez à la nouvelle URL du webhook et copiez-la à partir du webhook WhatsApp que vous avez précédemment envoyé.
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 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.
{width="80%"}
-
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.
{width="80%"}
-
Saisissez le numéro de téléphone de l’expéditeur ou de l’expéditrice à utiliser lors de vos communications.
-
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 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 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.