Einrichtung des WhatsApp-Kanals

Adobe Journey Optimizer B2B edition sendet WhatsApp-Nachrichten über die Cloud-API von Meta. Bevor Marketer WhatsApp-Nachrichten für Account-Journeys erstellen können, muss ein Produktadministrator einen WhatsApp-Kanal konfigurieren.

WhatsApp-Aufgabenfluss für Journey Optimizer B2B edition

Voraussetzungen

Bevor Sie den WhatsApp-Kanal konfigurieren, stellen Sie sicher, dass Sie Folgendes haben:

IMPORTANT
Ihre Nutzung der WhatsApp Messaging Services unterliegt den Nutzungsbedingungen von Meta. Durch den Zugriff auf WhatsApp-Nachrichten über Journey Optimizer B2B edition bestätigen Sie, dass Sie die Meta WhatsApp-Geschäftsrichtlinien überprüft haben und damit einverstanden sind.

Einschränkungen limitations

Für den WhatsApp-Kanal gelten die folgenden Einschränkungen:

  • Adobe Journey Optimizer B2B edition ist nicht HIPAA-kompatibel und nicht HIPAA-fähig. Darüber hinaus werden Drittanbieter nicht von der Adobe-BAA abgedeckt. Kundinnen und Kunden sind für ihre Compliance und Anbietervalidierung selbst verantwortlich.

  • Automatisierte oder vordefinierte Antwortnachrichten werden noch nicht unterstützt.

  • Seit April 2025 hat Meta vorübergehend den Versand aller Nachrichten aus Marketing-Vorlagen an WhatsApp-Benutzer mit einer US-Telefonnummer (einer Nummer bestehend aus einer +1-Wählnummer und einer US-Ortsvorwahl) ausgesetzt. Weitere Informationen finden Sie in der Dokumentation zu Meta

  • Die native Integrationsfunktion ermöglicht keine Integration mit einem Business Service Provider (BSP) eines Drittanbieters.

Abschließen der Kanalkonfiguration

Bevor Sie Ihre WhatsApp-Nachricht senden, müssen Sie Ihre Journey Optimizer B2B edition-Umgebung konfigurieren und mit Ihrem WhatsApp-Konto verbinden.

Führen Sie die folgenden Aufgaben aus:

Erstellen von WhatsApp-API-Anmeldedaten

NOTE
Auf die beschriebenen Einstellungen können nur Benutzer mit Administratorrechten zugreifen.
  1. Erweitern Sie in der linken Navigation den Abschnitt Administration und klicken Sie auf Kanäle.

  2. Erweitern Sie im Bedienfeld WhatsApp-Einstellungen und wählen Sie API-Anmeldeinformationen aus.

    Administration > Kanäle mit erweiterten WhatsApp-Einstellungen {width="800" modal="regular"}

  3. Klicken oben rechts auf Neue API-Anmeldeinformationen erstellen“.

  4. Konfigurieren Sie Ihre API-Anmeldedaten, wie unten beschrieben:

    • Name - Geben Sie einen eindeutigen Namen für die Anmeldeinformationen ein.
    • API-Token - Geben Sie Ihr API-Token ein. Weitere Informationen finden Sie in der Dokumentation zu Meta.
    • Geschäftskonto-ID - Geben Sie die eindeutige Nummer Ihres Geschäftsportfolios ein. Weitere Informationen finden Sie in der Dokumentation zu Meta.

    WhatsApp-Einstellungen API-Anmeldedaten ​ {width="500" modal="regular"}

  5. Klicken Sie auf Fortfahren.

  6. Wählen Sie das WhatsApp Business-Konto, mit dem Sie eine Verbindung zu Ihren WhatsApp-API-Anmeldeinformationen herstellen möchten.

    WhatsApp-Einstellungen API-Anmeldedaten wählen Sie ein Geschäftskonto aus {width="500" modal="regular"}

  7. Wählen Sie den Absendernamen für den Versand von WhatsApp-Nachrichten aus.

    Die Telefonnummerneinstellungen werden automatisch ausgefüllt:

    • Qualitätsbewertung - spiegelt das Kunden-Feedback für Nachrichten wider, die in den letzten 24 Stunden gesendet wurden.

      • Grün: hohe Qualität
      • Gelb: mittlere Qualität
      • Rot: geringe Qualität

      Weitere Informationen finden Sie unter Qualitätsbewertung in der Dokumentation zu Meta.

    • Durchsatz - gibt die Rate an, mit der Ihre Telefonnummer Nachrichten senden kann.

  8. Wenn Sie die Konfiguration Ihrer API-Anmeldedaten abgeschlossen haben, klicken Sie auf Senden.

Wenn Sie auf Senden klicken, werden die Anmeldeinformationen sofort validiert und gespeichert, wodurch Sie zur Auflistungsseite API weitergeleitet werden.

Wenn die gesendeten Anmeldeinformationen ungültig sind, zeigt das System eine HTTP 500-Fehlermeldung an. In diesem Fall können Sie die Konfiguration abbrechen oder aktualisieren und erneut senden.

Fehlerbehebung bei HTTP 500

Wenn beim Konfigurieren der WhatsApp-API-Anmeldedaten ein HTTP-500-Fehler auftritt, führen Sie die folgenden Schritte zur Fehlerbehebung aus:

  1. Überprüfen Sie Ihre Adobe-Berechtigungen : Vergewissern Sie sich, dass für Ihr Unternehmen die Berechtigung cjm whatsapp_ bereitgestellt wurde. Ohne diese Berechtigung kann der WhatsApp-Kanal nicht konfiguriert werden.

  2. Validieren der Felder für das Geschäftskonto : Stellen Sie sicher, dass alle Pflichtfelder korrekt sind:

  3. Testen Sie die Anmeldeinformationen extern - Überprüfen Sie Ihre Anmeldeinformationen direkt mit der Meta-API, um zu bestätigen, ob das Problem mit den Anmeldeinformationen oder mit der Handhabung der Journey Optimizer B2B edition-Anmeldeinformationen zusammenhängt.

  4. Adobe kontaktieren - Wenn die Umgebung und die Berechtigungen bestätigt wurden, der HTTP 500-Fehler jedoch weiterhin auftritt, bitte den Adobe-Support kontaktieren.

Hinzufügen der WhatsApp-Webhooks configure-webhooks

Webhooks ermöglichen es Journey Optimizer B2B edition, eingehende Nachrichten, Einverständnisantworten und Versandbenachrichtigungen von Ihrem WhatsApp Business-Konto zu empfangen. Konfigurieren Sie Webhooks, um eine ordnungsgemäße Einverständnisverwaltung und Nachrichtenverfolgung sicherzustellen.

NOTE
Ohne angegebene Opt-in- oder Opt-out-Keywords sind standardmäßige Einverständnisnachrichten nicht aktiviert.

Wenn die WhatsApp-API-Anmeldeinformationen erfolgreich erstellt wurden, können Sie die Webhooks konfigurieren.

  1. Wählen Sie im Navigationsbereich die Option WhatsApp Webhooks aus.

  2. Klicken Sie Webhook erstellen.

  3. Geben Sie Webhook- einen „Namen“ ein.

  4. Wählen für "" die (in der vorherigen Aufgabe erstellten) API-Anmeldeinformationen aus, die mit dem Webhook verknüpft werden sollen.

  5. Wählen Sie für Kategorie „Eingehendes Keyword eine Kategorie aus, um Keywords und die Antwortnachricht zu definieren:

    • Opt-in - Benutzende müssen aktiv zustimmen, WhatsApp-Nachrichten zu erhalten, die oft über Formulare auf Ihrer Website oder in Ihrer App verwaltet werden.
    • Opt-out - Konfigurieren Sie Ihren Webhook so, dass er auf Ausdrücke wie Stop oder No Message wartet, um Benutzer automatisch als Opt-out zu markieren.
    • Hilfe - Ermöglicht es automatisierten Systemen, zu erkennen, wann ein Benutzer HELP (oder ähnliche Schlüsselwörter wie Unknown) sendet, und automatisch mit bestimmten Informationen zu antworten, z. B. Dienstanweisungen.
    • Standard - Verarbeiten Sie eingehende Nachrichten, die nicht mit speziell definierten Schlüsselwörtern übereinstimmen. Sie dient als Fallback-Kategorie, um Tracking-Ereignisse (z. B. Öffnungen und Versandberichte) in Adobe Experience Platform-Datensätzen zu ermöglichen.

    Wenn Sie die Keyword-Kategorie auswählen, werden die Standard-Keywords ausgefüllt.

  6. Für Keyword eingeben können Sie ein benutzerdefiniertes Keyword eingeben und auf Hinzufügen klicken ( + ).

    Sie können mehrere Keywords pro Kategorie hinzufügen.

    note note
    NOTE
    Bei Schlüsselwörtern wird nicht zwischen Groß- und Kleinschreibung unterschieden (stop und STOP werden gleich behandelt).
  7. Geben Sie die Antwortnachricht ein, die automatisch gesendet werden soll, wenn eine empfangene Nachricht einem Schlüsselwort in dieser Kategorie entspricht.

    Webhooks für WhatsApp-Einstellungen mit Opt-in-Schlüsselwörtern und Antwortnachricht {width="500" modal="regular"}

  8. Klicken Sie für jede zusätzliche Schlüsselwortkategorie, die Sie konfigurieren möchten, oben rechts auf Hinzufügen (+) und wiederholen Sie die Schritte 5 bis 7.

  9. Klicken Sie Senden, um die Webhook-Konfiguration zu speichern.

Token und URL kopieren

Nachdem der Webhook gesendet wurde, können Sie die Token- und URL-Werte abrufen und in Meta registrieren.

  1. Klicken Sie in der WhatsApp Webhooks“ auf das Symbol „Bearbeiten ( Bearbeiten)“ für den von Ihnen erstellten Webhook.

  2. Kopieren Sie die Werte Verifizierungstoken und Webhook-URL.

    Webhook-Einstellungen für WhatsApp, um die URL zu kopieren und das Token zu überprüfen {width="500" modal="regular"}

  3. Navigieren Sie im Meta for DevelopersPortal zu Ihren WhatsApp-Anwendungseinstellungen und konfigurieren Sie den Webhook mithilfe der von Ihnen kopierten Werte.

Kanalkonfiguration erstellen create-channel-configuration

Eine Kanalkonfiguration definiert die Versandeinstellungen, die beim Senden von WhatsApp-Nachrichten von einem Journey-Aktionsknoten verwendet werden.

  1. Wählen Sie im Navigationsbereich unter Allgemeine Einstellungen die Option Kanalkonfigurationen aus.

    Liste der Kanalkonfigurationen {width="600" modal="regular"}

  2. Klicken oben auf „Kanalkonfiguration erstellen“.

  3. Geben Sie einen Name und Beschreibung (optional) für die Konfiguration ein.

    note note
    NOTE
    Der Name muss mit einem Buchstaben (A-Z) beginnen und darf nur alphanumerische Zeichen, Unterstriche (_), Punkte (.) und Bindestriche (-) enthalten.
  4. Wählen für " auswählen“ WhatsApp.

  5. Wählen unter „WhatsApp Einstellungen“ die WhatsApp-Konfiguration (API-Anmeldeinformationen) aus, die Sie in der vorherigen Aufgabe erstellt haben.

  6. Geben Sie die Absender-Telefonnummer ein, die für den Nachrichtenversand verwendet werden soll.

    Konfigurationsdetails des WhatsApp-Kanals {width="500" modal="regular"}

  7. (Derzeit nicht für Journey Optimizer B2B edition anwendbar) Wählen Sie für das WhatsApp-Ausführungsfeld das Profilattribut aus, das als vorrangige Telefonnummer verwendet werden soll, wenn für eine Empfängerin oder einen Empfänger mehrere Telefonnummern verfügbar sind.

  8. Klicken Sie Senden, um die Konfiguration zu speichern, oder Als Entwurf speichern, um sie abzuschließen und zu einem späteren Zeitpunkt zu übermitteln.

Die Konfiguration wird zunächst mit dem Status Verarbeitung angezeigt, während die Validierungsprüfungen ausgeführt werden. Wenn alle Prüfungen erfolgreich sind, ändert sich der Status in Aktiv und die Konfiguration kann ausgewählt werden, wenn Marketing-Experten WhatsApp-Nachrichten in Journey-Aktionen erstellen.

recommendation-more-help
6ef00091-a233-4243-8773-0da8461f7ef0