DokumentationExperience PlatformAnleitung zu Quell-Connectoren

[Beta]{class="badge informative"}

WhatsApp

Letzte Aktualisierung: 29. Oktober 2026

Erstellt für:

  • Entwicklerin/Entwickler
NOTE
Die WhatsApp-Quelle befindet sich in der Beta-Phase. Weitere Informationen zur Verwendung von Betagekennzeichneten Connectoren finden ​ unter „Quellen - Übersicht“ .
IMPORTANT
Diese Quelle befindet sich in der privaten Beta-Phase und steht einer begrenzten Anzahl von Kunden zur Verfügung. Wenden Sie sich an den Adobe-Support, um Zugriff zu erhalten.

Adobe Experience Platform ermöglicht die Aufnahme von Daten aus externen Quellen und bietet spezielle Experience Platform-Services, mittels derer Sie eingehende Daten strukturieren, beschriften und erweitern können. Daten können aus verschiedensten Quellen aufgenommen werden, darunter etwa Adobe-Programme, Cloud-basierte Datenspeicher und Datenbanken.

Experience Platform unterstützt die Aufnahme von Daten aus Streaming-Anwendungen. Der Support für Messaging-Anbieter umfasst WhatsApp.

WhatsApp Business ist eine Messaging-Plattform, mit der Unternehmen über WhatsApp mit ihren Kunden kommunizieren. Die WhatsApp-Quelle streamt eingehende Nachrichten, die Ihre Kunden an Ihre WhatsApp Business Telefonnummer senden, nahezu in Echtzeit an Experience Platform.

Meta sendet jede Nachricht an einen Platform-Streaming-Endpunkt (einen Webhook), wo sie als unformatierter Erlebnisereignisdatensatz erfasst und zu einem Datensatz im Data Lake hinzugefügt wird, um nachgelagert verwendet zu werden. Der Connector nimmt die unformatierte Webhook-Payload unverändert auf, sodass jeder WhatsApp beibehalten wird.

Funktionsweise des Connectors how-it-works

Die WhatsApp folgt dieser Sequenz, um eine Nachricht in Experience Platform zu importieren:

  1. Ein Kunde sendet eine Nachricht an Ihre WhatsApp Business.
  2. Meta signiert die Webhook-Payload mit Ihrem App Secret (X-Hub-Signature-256) und sendet sie an die Callback-URL, die Sie am Platform-Streaming-Endpunkt konfiguriert haben.
  3. Platform validiert die Signatur, erfasst die unformatierte Payload als Erlebnisereignis und fügt sie zu Ihrem WhatsApp-Datensatz hinzu.

Voraussetzungen prerequisites

Bevor Sie eine WhatsApp-Quellverbindung erstellen, führen Sie Folgendes auf Meta unter developers.facebook.com aus:

  • Erstellen Sie eine Meta-App vom Typ Business und fügen Sie ihr WhatsApp-Produkt hinzu.
  • Erstellen Sie ein WhatsApp Business Account (WABA) mit einer registrierten Telefonnummer.
  • Stellen Sie sicher, dass die App über die whatsapp_business_management und whatsapp_business_messaging Berechtigungen verfügt.
  • Kopieren Sie „App Einstellungen“ > Allgemein Ihr App-Geheimnis. Meta verwendet das App Secret, um Webhook-Payloads zu signieren.
  • Wählen Sie ein Verifizierungs-Token aus. Es kann sich um eine beliebige Zeichenfolge handeln, und es ist ein gemeinsames Geheimnis, das Sie sowohl in Platform als auch in Meta eingeben.

In der folgenden Tabelle wird beschrieben, wo die einzelnen Anmeldeinformationen zu finden sind und wofür sie verwendet werden.

Anmeldedaten
Bezugsquellen
Verwendet für
App-Geheimnis
Meta > App-Einstellungen > Standard
Validieren der X-Hub-Signature-256 Signatur bei jedem eingehenden Webhook.
Verifizierungs-Token
Sie wählen es aus
Der Handshake mit einmaliger Überprüfung zwischen Meta und Platform.

Mobile App bei der WABA abonnieren subscribe-app

Abonnieren Sie Ihre Meta-App beim WhatsApp Business-Konto, damit Meta die WABA-Ereignisse an Ihre App weiterleitet. Dieser Schritt ist erforderlich und erfolgt vollständig in Meta. Die Bereitstellung beginnt jedoch erst, nachdem Sie die Callback-URL konfiguriert haben. Siehe Verbinden von WhatsApp Business mit Experience Platform.

IMPORTANT
Wenn Sie diesen Schritt überspringen, werden Nachrichten nie zugestellt und in Platform wird kein Fehler angezeigt. Ein fehlendes WABA-Abonnement ist die häufigste Ursache für „keine Daten aufgenommen“-Probleme. Siehe Fehlerbehebung.

Mobile App mit der Graph API abonnieren:

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

Überprüfen des Abonnements mit:

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

Für beide Aufrufe ist ein Token mit der Berechtigung whatsapp_business_management und Zugriff auf die WABA erforderlich. Ersetzen Sie {VERSION} durch eine aktuelle Graph API-Version, z. B. v21.0 oder höher.

Was der Connector automatisch bereitstellt automatic-provisioning

Wenn Sie die Erstellung eines WhatsApp Datenflusses abgeschlossen haben, erstellt der Connector die folgenden Entitäten und verdrahtet sie. Sie wählen keinen Zieldatensatz aus und ordnen auch keine Felder nicht selbst zu.

Entität
Name oder Kennung
Erstellt oder wiederverwendet
Anmerkungen
Schema
Rohereignisse des WhatsApp-Webhooks (XDM ExperienceEvent-Klasse)
Wiederverwendet, falls vorhanden, andernfalls einmal pro Sandbox erstellt
Der erste WhatsApp Datenfluss in einer Sandbox erstellt ihn. Bei jedem späteren Datenfluss wird dasselbe Schema wiederverwendet.
Feldergruppe
WhatsApp Webhook Payload v2
Wiederverwendet (Standard)
Der Connector verweist auf die vorhandene Standardfeldgruppe. Es schafft nie eine.
Datensatz
WhatsApp Webhook-Rohereignisse
Erstellt pro Datenfluss
Raw-Landing-Experience-Ereignis-Datensatz für die eingehenden Nachrichten.
Feld-Mapping
systemgeneriert
Erstellt pro Datenfluss
Ordnet die rohe Webhook-Payload dem Schema zu und wird als Transformation in den Datenfluss verkabelt.
Streaming-Endpunkt (Inlet)
Als Callback-URL angezeigt
Erstellt pro Datenfluss
Erzwingt X-Hub-Signature-256 Signaturvalidierung und den Verifizierungs-Token-Handshake.
Zielverbindung (Data Lake)
systemgeneriert
Erstellt pro Datenfluss
Leitet die zugeordneten Daten in den Datensatz weiter.

Rotieren von geheimen Daten rotate-secrets

Sie können Ihr App-Geheimnis oder Verifizierungs-Token jederzeit rotieren, indem Sie die Verbindung aktualisieren. Platform unterstützt ein primäres und ein sekundäres Geheimnis, sodass Sie das App-Geheimnis ohne Ausfallzeiten rollieren können. Fügen Sie den neuen Wert als primäres Geheimnis hinzu, während Sie den vorherigen Wert während der Transition als sekundäres Geheimnis beibehalten. Beim Aktualisieren der Verbindung wird die Änderung auf alle Datenflüsse angewendet, die sie verwenden.

Fehlerbehebung troubleshooting

In der folgenden Tabelle werden häufige Probleme und deren Behebung beschrieben.

Symptom
Wahrscheinliche Ursache und Problembehebung
In Platform sieht alles einwandfrei aus, es werden jedoch keine Daten aufgenommen.
Die App ist nicht für die WABA abonniert. Schließen Sie das WABA-Abonnement ab, das unter Abonnieren Sie Ihre App bei der WABA beschrieben ist. Dies ist die häufigste Ursache und schlägt leise fehl. Wenn die App abonniert ist, überprüfen Sie, ob das App-Geheimnis in Platform mit dem aktuellen App-Geheimnis in Meta unter App-Einstellungen > Standard übereinstimmt.
"Überprüfen und Speichern schlägt in Meta fehl.
Das Verify-Token in Meta muss genau mit dem in Platform eingegebenen Verify-Token übereinstimmen.

Verbinden von WhatsApp mit Experience Platform connect-to-platform

Die folgende Dokumentation enthält Informationen zum Erstellen eines WhatsApp Streaming-Connectors für die Verbindung mit Experience Platform über die Benutzeroberfläche:

Verbinden von WhatsApp mit Experience Platform über die Benutzeroberfläche connect-to-platform-using-ui

Zusätzliche Ressourcen additional-resources

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