DocumentationExperience PlatformGuide des connecteurs sources

[Beta]{class="badge informative"}

WhatsApp

Dernière mise à jour : 29 octobre 2026

Créé pour :

  • Développeur
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.
IMPORTANT
Cette source est en version bêta privée et disponible pour un nombre limité de clients. Contactez votre représentant Adobe pour demander l’accès.

Adobe Experience Platform permet d’ingérer des données à partir de sources externes tout en vous offrant la possibilité de structurer, d’étiqueter et d’améliorer les données entrantes à l’aide des services d’Experience Platform. Vous pouvez ingérer des données provenant de diverses sources telles que les applications Adobe, le stockage dans le cloud, les bases de données, etc.

Experience Platform prend en charge l’ingestion de données provenant d’applications de diffusion en continu. La prise en charge des fournisseurs de messagerie inclut WhatsApp.

WhatsApp Business est une plateforme de messagerie que les entreprises utilisent pour communiquer avec les clients via WhatsApp. La source WhatsApp diffuse en temps quasi réel les messages entrants que vos clients envoient à votre numéro de téléphone WhatsApp Business dans Experience Platform.

Meta diffuse chaque message à un point d’entrée de diffusion en continu de Platform (webhook), où il est capturé en tant qu’enregistrement brut d’événement d’expérience et ajouté à un jeu de données dans le lac de données pour une utilisation en aval. Le connecteur ingère la payload webhook brute en l’état, de sorte que chaque type de message WhatsApp est conservé.

Fonctionnement du connecteur how-it-works

La source WhatsApp suit cette séquence pour importer un message dans Experience Platform :

  1. Un client envoie un message à votre numéro de téléphone WhatsApp Business.
  2. Meta signe la payload webhook avec votre secret d’application (X-Hub-Signature-256) et l’envoie à l’URL de rappel que vous avez configurée sur le point d’entrée de diffusion en continu de Platform.
  3. Platform valide la signature, capture la payload brute en tant qu’événement d’expérience et l’ajoute à votre jeu de données WhatsApp.

Conditions préalables prerequisites

Avant de créer une connexion source WhatsApp, procédez comme suit sur Meta à l’adresse developers.facebook.com :

  • Créez une application Meta de type Entreprise et ajoutez-y le produit WhatsApp.
  • Créez un compte professionnel WhatsApp (WABA) avec un numéro de téléphone enregistré.
  • Assurez-vous que l’application dispose des autorisations whatsapp_business_management et whatsapp_business_messaging.
  • Dans Paramètres de l’application > De base, copiez le secret de l’application. Meta utilise le secret d’application pour signer les payloads webhook.
  • Choisissez un jeton de vérification. Il peut s’agir de n’importe quelle chaîne et il s’agit d’un secret partagé que vous saisissez sur Platform et Meta.

Le tableau suivant décrit où trouver chaque information d’identification et à quoi elle sert.

Informations d’identification
Où l’obtenir
Utilisé pour
Secret de l’application
Meta > Paramètres de l’application > De base
Validation de la signature X-Hub-Signature-256 sur chaque webhook entrant.
Jeton de vérification
Vous le choisissez
L’authentification unique entre Meta et Platform.

Abonner votre application à la WABA subscribe-app

Abonnez votre application Meta au compte professionnel WhatsApp afin que Meta achemine les événements de WABA vers votre application. Cette étape est obligatoire et se produit entièrement sur Meta, mais la diffusion ne commence qu’après la configuration de l’URL de rappel. Voir Connexion de WhatsApp Business à Experience Platform.

IMPORTANT
Si vous ignorez cette étape, les messages ne sont jamais diffusés et aucune erreur n’est affichée dans Platform. Un abonnement WABA manquant est la cause la plus courante des problèmes « aucune donnée ingérée ». Voir Dépannage.

Abonnez votre application à l’aide de l’API Graph :

POST https://graph.facebook.com/{VERSION}/{WHATSAPP_BUSINESS_ACCOUNT_ID}/subscribed_apps

Vérifiez l’abonnement avec :

GET https://graph.facebook.com/{VERSION}/{WHATSAPP_BUSINESS_ACCOUNT_ID}/subscribed_apps

Les deux appels nécessitent un jeton avec l’autorisation whatsapp_business_management et l’accès à WABA. Remplacez {VERSION} par une version actuelle de l’API Graph, par exemple v21.0 ou une version ultérieure.

Ce que le connecteur met automatiquement en place automatic-provisioning

Lorsque vous avez terminé de créer un flux de données WhatsApp, le connecteur crée et lie les entités suivantes. Vous ne sélectionnez pas vous-même de jeu de données cible ou de champ de mappage.

Entité
Nom ou identifiant
Créé ou réutilisé
Remarques
Schéma
Événements bruts WhatsApp Webhook (classe XDM ExperienceEvent)
Réutilisé s’il est présent, sinon créé une fois par sandbox
Le premier flux de données WhatsApp dans un sandbox le crée. Chaque flux de données ultérieur réutilise le même schéma.
Groupe de champs
Payload Webhook WhatsApp V2
Réutilisé (standard)
Le connecteur fait référence au groupe de champs standard existant. Il n’en crée jamais.
Jeu de données
Événements bruts WhatsApp Webhook
Créé par flux de données
Jeu de données brut d’événements d’expérience de destination pour les messages entrants.
Mappage de champs
Généré par le système
Créé par flux de données
Mappe la payload webhook brute dans le schéma et est connectée au flux de données sous la forme d’une transformation.
Point d’entrée de diffusion en continu (inlet)
Est apparu comme URL de rappel
Créé par flux de données
Applique la validation de la signature X-Hub-Signature-256 et l’authentification à l’aide du jeton de vérification.
Connexion à Target (lac de données)
Généré par le système
Créé par flux de données
Achemine les données mappées dans le jeu de données.

Rotation des secrets rotate-secrets

Vous pouvez faire pivoter votre secret d’application ou jeton de vérification à tout moment en mettant à jour la connexion. Platform prend en charge un secret principal et un secret secondaire afin que vous puissiez déployer le secret de l’application sans temps d’arrêt. Ajoutez la nouvelle valeur en tant que secret principal tout en conservant la valeur précédente en tant que secret secondaire pendant la transition. La mise à jour de la connexion applique la modification à tous les flux de données qui l’utilisent.

Dépannage troubleshooting

Le tableau suivant décrit les problèmes courants et la manière de les résoudre.

Symptôme
Cause probable et solution
Tout semble sain dans Platform, mais aucune donnée n’est ingérée.
L’application n’est pas abonnée à la WABA. Complétez l’abonnement WABA décrit dans Abonnez votre application à WABA. Il s’agit de la cause la plus courante qui échoue en silence. Si l’application est abonnée, vérifiez que le secret d’application dans Platform correspond au secret d’application actuel dans Meta sous Paramètres de l’application > De base.
Échec de « Vérifier et enregistrer » dans Meta.
Le jeton de vérification dans Meta doit correspondre exactement au jeton de vérification saisi dans Platform.

Connexion de WhatsApp à Experience Platform connect-to-platform

La documentation ci-dessous fournit des informations sur la création d’un connecteur de diffusion en continu WhatsApp pour se connecter à Experience Platform à l’aide de l’interface utilisateur :

Connexion d’WhatsApp à Experience Platform à l’aide de l’interface utilisateur connect-to-platform-using-ui

Ressources supplémentaires additional-resources

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