WhatsApp von EngageLab

Sie können einen Flow-Agenten so konfigurieren, dass er innerhalb von WhatsApp funktioniert. So können Ihre Kund:innen direkt über WhatsApp mit einem KI-Flow-Agenten kommunizieren.

Diese Anleitung richtet sich an Nutzer:innen, die eine WhatsApp-Business-Account-ID im EngageLab-Backend registrieren möchten.

EngageLab ist ein offizieller WhatsApp Business Solution Provider (BSP).

EngageLab-Konto erstellen und einrichten

EngageLab-Konto erstellen

Gehen Sie zur EngageLab-Registrierung, geben Sie Ihre E-Mail-Adresse, Ihr Passwort und Ihre Telefonnummer ein und klicken Sie anschließend auf „Registrieren“.

Nachdem Sie den E-Mail-Bestätigungscode eingegeben haben, müssen Sie den Namen der Organisation, den Namen der Website angeben und die Zeitzone der Organisation auswählen.

Hinweis: Die Zeitzone kann nachträglich nicht mehr geändert werden! Auch beim Erstellen eines WhatsApp-Business-Kontos muss die Zeitzone ausgewählt werden und übereinstimmen.

Klicken Sie auf „Weiter“, um zur Hauptseite von EngageLab zu gelangen.

WhatsApp-Dienst aktivieren

Suchen Sie im Bereich „Pending Services“ nach WhatsApp und klicken Sie auf „Starten“.

Zugriff auf die Subsite

Klicken Sie auf „Nachricht senden“, um die Subsite für diesen Dienst aufzurufen. Sie werden zur Übersichtsseite weitergeleitet, auf der Sie mit der Registrierung des WhatsApp-Kontos beginnen.

WhatsApp-Business-Konto und Absendernummer registrieren

Klicken Sie auf der Übersichtsseite auf „Registrieren“, um zur offiziellen Registrierungsseite von Meta weitergeleitet zu werden. Nachdem Sie sich mit Ihrem Facebook-Konto angemeldet haben, folgen Sie dem offiziellen Prozess Schritt für Schritt, um die Registrierung abzuschließen. Die Schritte 1 und 2 werden dabei gleichzeitig abgeschlossen.

Sollten Sie noch kein Facebook-Konto haben, erstellen Sie bitte zunächst ein Konto.

Hinweis: Verwenden Sie ein neu erstelltes Facebook-Konto nicht sofort für die Registrierung eines WhatsApp-Kontos. Führen Sie zunächst einige Tage lang normale Aktivitäten wie Anmelden, Posten und das Bearbeiten Ihres Profils durch. Die sofortige Nutzung eines neuen Kontos kann zur Sperrung führen. Weitere Informationen finden Sie unter Facebook Account Exception.

Autorisierung bestätigen

Nach Auswahl Ihres Facebook-Kontos wird Ihnen ein Autorisierungshinweis angezeigt, den Sie bestätigen müssen.

Meta-Business-Konto erstellen/auswählen

Wenn Sie bereits ein Meta-Business-Konto erstellt haben, insbesondere wenn dieses im Meta-Business-Manager verifiziert wurde, wird empfohlen, dieses direkt auszuwählen. Andernfalls geben Sie die erforderlichen Informationen ein, um ein neues Konto zu erstellen. Bitte beachten Sie:

• Verwenden Sie eine Firmen-E-Mail-Adresse statt einer QQ-E-Mail-Adresse.
• Nutzen Sie eine Website-Adresse, die das legitime Geschäft Ihres Unternehmens repräsentiert, da diese von Meta überprüft wird.
• Scheitert die Erstellung trotz korrekter Angaben, liegt dies meist an Einschränkungen des Facebook-Werbekontos. Siehe Facebook Troubleshooting Solutions.

WhatsApp-Business-Konto erstellen/auswählen

Wenn Sie bereits ein WhatsApp-Business-Konto in EngageLab erstellt haben:

• Möchten Sie eine neue Nummer hinzufügen, wählen Sie „Bestehendes Konto“ und erstellen Sie eine neue WhatsApp-Business-Seite.
• Möchten Sie eine Telefonnummer im Konto verifizieren, wählen Sie „Bestehendes Konto“ und die entsprechende Business-Seite (Telefonnummer) aus.

Falls nicht, wählen Sie bei allen Optionen „Erstellen“. Bitte beachten Sie:

• Der Kontoname ist für Ihre Nutzer:innen nicht sichtbar.
• Der Anzeigename Ihres Unternehmensprofils (muss den Namensregeln entsprechen), die Website und weitere Angaben sind für Ihre Nutzer:innen sichtbar.
• Die Zeitzone muss mit der EngageLab-Organisation und dem Standort des Unternehmens (Nutzer:innen, Geschäftssysteme) übereinstimmen. Abrechnung und weitere Informationen basieren auf dieser Zeitzone. Sie kann vor dem Livegang noch geändert werden.

Telefonnummer hinzufügen und verifizieren

Verwenden Sie für die Registrierung eine völlig neue Telefonnummer, die SMS empfangen kann und bisher weder in der WhatsApp-App noch in bestehenden WhatsApp-Business-Konten verwendet wurde. Weitere Anforderungen finden Sie unter WhatsApp-Telefonnummern-Anforderungen.

Die Verifizierung kann per SMS oder Sprachanruf erfolgen, wobei der Sprachanruf empfohlen wird. Sollten Sie nach mehreren Versuchen keinen Code erhalten:

• Brechen Sie den Prozess ab und versuchen Sie es nach einigen Tagen erneut. Wählen Sie ein bestehendes Meta-Business-Konto, WhatsApp-Konto oder eine Business-Seite (Telefonnummer) und versuchen Sie die Verifizierung erneut.
• Brechen Sie den Prozess ab und wählen Sie „Konto hinzufügen“ auf der Business Account Management-Seite und verifizieren Sie die Nummer anschließend auf der Absendernummern-Verwaltung.

Hinweis: Diese Telefonnummer ist für Nutzer:innen sichtbar. Pro WhatsApp-Business-Konto können bis zu 20 Telefonnummern erstellt werden. Jede Nummer kann unterschiedliche Anzeigenamen, Beschreibungen und Website-Informationen für Nutzer:innen haben.

Nach Abschluss der Registrierung werden Sie automatisch von der „Meta-Registrierungsseite“ zur „Übersicht“ weitergeleitet. Nun sehen Sie, dass die Schritte 1 und 2 des Leitfadens abgeschlossen sind (falls der Status noch nicht aktualisiert wurde, bitte die Seite aktualisieren) und das soeben registrierte WhatsApp-Konto oben links ausgewählt ist. Fahren Sie nun mit Schritt 3 – der Verifizierung der Absendernummer – fort.

Absendernummer verifizieren

Klicken Sie in Schritt 3 auf „Verifizieren“, um zur Seite „Sending Number“ zu gelangen. Hier müssen Sie die in EngageLab erfolgreich registrierte Telefonnummer verifizieren.

Klicken Sie auf „Nummer verifizieren“ und wählen Sie als Verifizierungsmethode „WhatsApp Business Cloud API“:

• Haben Sie die Eingabe des Verifizierungscodes im offiziellen Meta-Registrierungsprozess innerhalb von 14 Tagen nach der Verifizierungsaktion abgeschlossen, erfolgt die Verifizierung direkt.
• Haben Sie den Code im offiziellen Meta-Registrierungsprozess nicht innerhalb von 14 Tagen eingegeben, müssen Sie einen neuen Code anfordern und per Telefon verifizieren.
• Wird der Anzeigename mit „Wird überprüft“ angezeigt, können Sie „Nummer verifizieren“ derzeit nicht anklicken. Bitte warten Sie und versuchen Sie es später erneut.

Nach erfolgreicher Verifizierung ändert sich der Betriebsstatus auf „Verbunden“ und Sie können diese Absendernummer zum Versenden von Nachrichten nutzen.

API-Schlüssel generieren

Gehen Sie auf die Seite „Configuration Management“ – „API Keys“ und klicken Sie auf „Jetzt erstellen“, um die Schlüssel zu generieren.

Geben Sie eine Beschreibung für den API-Schlüssel, das Ablaufdatum, eine IP-Whitelist und die gewünschten API-Berechtigungen an.

• Wählen Sie ein möglichst langes Ablaufdatum.
• Es wird empfohlen, keine IP-Beschränkung zu setzen. Falls Sie aus Sicherheitsgründen eine IP-Whitelist benötigen, fügen Sie die IP-Adresse von GPTBots hinzu.
• Aktivieren Sie die API-Berechtigung „Message Sending API“ und wählen Sie die gewünschte Absendernummer aus.

Nach erfolgreicher Erstellung werden DevKey und DevSecret automatisch generiert.

Klicken Sie auf die gesamte Zeile, um zur Detailseite zu gelangen. Dort können Sie DevKey und DevSecret abrufen und für die Konfiguration der GPTBots-WhatsApp-Einstellungen kopieren.

GPTBots-WhatsApp konfigurieren

Öffnen Sie die WhatsApp-Konfigurationsseite des Flow-Agenten und tragen Sie „DevKey“, „DevSecret“ und die Telefonnummer aus den vorherigen Schritten ein. Klicken Sie auf „Absenden“, um die darunter stehende „Callback-URL“ zu erhalten.

Callback-URL konfigurieren

Gehen Sie zu „Configuration Management“ – „Callback Settings“ und klicken Sie auf „Callback konfigurieren“.

Tragen Sie die Callback-URL von GPTBots in das Feld für die Callback-Adresse ein, aktivieren Sie alle Callback-Events und klicken Sie auf „OK“, um zu speichern.

Damit sind alle Konfigurationen abgeschlossen und der Flow-Agent ist mit dem WhatsApp-Konto verknüpft.

Mit dem Flow-Agenten chatten

Senden Sie eine Nachricht an die im „EngageLab WhatsApp-Konto“ konfigurierte Telefonnummer, um mit dem Flow-Agenten zu chatten.

Hinweis: Ist das EngageLab-Guthaben nicht ausreichend, können keine Nachrichten gesendet werden. Sie können das Guthaben im „Product Market“ von EngageLab aufladen.

Meta-Business-Verifizierung

Wenn Ihr Meta-Business-Manager noch keine Unternehmensverifizierung abgeschlossen hat, können Sie täglich nur 250 Nachrichten versenden. Soll Ihr Dienst offiziell starten und Sie benötigen ein höheres Versandvolumen, folgen Sie bitte dem Leitfaden zur Unternehmensverifizierung.

Nummern zu EngageLab migrieren

Meta unterstützt die Migration registrierter Telefonnummern zwischen verschiedenen WhatsApp-Business-Konten (WABAs) in folgenden Szenarien:

• Ihr Unternehmen nutzt aktuell die Dienste eines anderen Meta-Partners und möchte zu EngageLab wechseln.
• Ihr Unternehmen hat eine eigene Lösung implementiert und möchte zu EngageLab wechseln.

Wenn Sie dies benötigen, können Sie den „Konto-Registrierung“-Prozess abschließen und anschließend das EngageLab-Supportteam für Unterstützung bei der Migration kontaktieren.