[Beta]{class="badge informative"}

Créer une connexion source WhatsApp dans l’interface utilisateur

NOTE
La source WhatsApp est en version Beta. Lisez la Présentation des sources pour plus d’informations sur l’utilisation de connecteurs étiquetés Beta.

Ce tutoriel décrit les étapes à suivre pour créer une connexion source WhatsApp à l’aide de l’interface utilisateur de Adobe Experience Platform.

Prise en main getting-started

Ce tutoriel nécessite une compréhension du fonctionnement des composants suivants d’Adobe Experience Platform :

  • Experience Data Model (XDM) Système : Cadre normalisé selon lequel Experience Platform organise les données d’expérience client. Le connecteur attribue automatiquement un schéma ExperienceEvent spécifique à WhatsApp.
  • Real-Time Customer Profile : fournit un profil de consommateur unifié en temps réel, basé sur des données agrégées provenant de plusieurs sources.

Conditions préalables prerequisites

Avant de créer une connexion source WhatsApp, remplissez les Conditions préalables dans la présentation de la source WhatsApp, y compris l’abonnement de votre application à WABA, et préparez les éléments suivants :

  • Votre secret d’application Meta
  • Votre jeton de vérification

Étape 1 : créer un compte create-account

Dans l’interface utilisateur d’Experience Platform, sélectionnez Sources dans le volet de navigation de gauche pour accéder à l’espace de travail Sources.

Dans la catégorie Automatisation marketing, sélectionnez la vignette WhatsApp source, puis Ajouter des données.

Carte source WhatsApp dans la catégorie Automatisation marketing du catalogue de sources.

L’onglet Authentification s’affiche. Sur cet onglet, vous pouvez utiliser un nouveau compte ou un compte existant.

Créer un compte

Sélectionnez Nouveau compte et fournissez les informations suivantes.

table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2
Champ Éléments à renseigner
Nom du compte Nom de cette connexion.
Description (facultatif) Brève description du compte.
Jeton de vérification Le jeton de vérification que vous avez choisi dans Conditions préalables. Il s’agit du secret partagé utilisé lors de la liaison de vérification webhook unique avec Meta.
Secret de l’application (actuel) Votre secret d’application Meta à partir des conditions préalables. Utilisé pour valider la signature X-Hub-Signature-256 sur les Webhooks entrants.
Secret d’application (précédent) (facultatif) Un secret d’application précédent, utilisé uniquement lors de la rotation du secret, afin que vous puissiez déployer le secret d’application sans temps d’arrêt.

Sélectionnez Se connecter à la source pour valider et créer le compte, puis sélectionnez Suivant. Un compte peut être réutilisé sur plusieurs flux de données. Vous ne pouvez donc saisir ces informations d’identification qu’une seule fois par compte.

Nouvelle interface de compte permettant d’authentifier un nouveau compte WhatsApp, affichant le nom du compte, la description, le jeton de vérification et les champs de secret de l’application.

Utiliser un compte existant

Sélectionnez Compte existant, sélectionnez le compte à réutiliser, puis sélectionnez Suivant.

Interface du compte existant dans laquelle vous pouvez sélectionner un compte WhatsApp existant à réutiliser.

Étape 2 : configurer le flux de données configure-dataflow

L’onglet Détails du flux de données s’affiche. Saisissez un Nom du flux de données, un Description facultatif et abonnez-vous éventuellement aux alertes en sélectionnant Début d’exécution du flux de données des sources, Succès de l’exécution du flux de données des sources ou Échec de l’exécution du flux de données des sources.

NOTE
Vous ne sélectionnez pas de jeu de données cible ni de champs de mappage. Le connecteur crée et attribue automatiquement le jeu de données, le schéma et le mappage des champs.

Onglet Détails du flux de données, affichant le nom du flux de données, la description et les options d’abonnement aux alertes.

Sélectionnez Suivant.

L’onglet Vérifier s’affiche. Vérifiez la connexion et l’affectation du jeu de données, puis sélectionnez Terminer.

Onglet Révision , confirmant que le compte est connecté et qu’un jeu de données est affecté.

Étape 3 : récupérer le point d’entrée de diffusion en continu retrieve-streaming-endpoint

Une fois le flux de données créé, accédez à sa page Activité du flux de données et recherchez la section Utilisation de l’API du panneau Propriétés. Copiez les valeurs Point d’entrée de diffusion en continu et Identifiant de flux de données.

Point d’entrée de diffusion en continu et ID de flux de données dans la section Utilisation de l’API du panneau Propriétés.

Combinez les deux valeurs pour créer l’URL de rappel que vous saisissez dans Meta : {STREAMING_ENDPOINT}?x-adobe-flow-id={DATAFLOW_ID}.

Étape 4 : configuration du webhook dans Meta configure-webhook

Dans Meta, accédez à WhatsApp > Configuration et effectuez les étapes ci-après.

  1. Saisissez l’URL de rappel que vous avez créée à l’étape 3 et le même jeton de vérification parmi les conditions préalables.
  2. Sélectionnez Verify and Save. Meta appelle l’URL de rappel avec un défi GET, auquel Platform répond pour terminer l’établissement de la liaison.
  3. Abonnez-vous au champ webhook messages.

Étapes suivantes next-steps

Ce tutoriel vous a permis de configurer un flux de données en continu pour importer vos données WhatsApp dans Experience Platform. Pour surveiller les données ingérées, reportez-vous au guide sur la surveillance des flux de données en flux continu à l’aide de l’interface utilisateur d’Experience Platform.

Si aucune donnée ne s’affiche après l’envoi d’un message de test, consultez Dépannage dans la présentation de la source de WhatsApp.

recommendation-more-help
experience-platform-help-sources