Vorbereitende Schritte

Um Whatsapp mit Ihrem Assistenten zu integrieren, benötigen Sie Zugriff auf Twilio und mindestens eine Entwicklerrolle. Weitere Informationen finden Sie unter Unterschied bei Rollen für Twilio.

1. Rufen Sie die Twilio-Websiteauf.

2. Erstellt ein Konto.

3. Klicken Sie auf der Registerkarte Entwickeln auf Telefonnummern.

4. Folgen Sie den Anweisungen, um eine Telefonnummer zu erhalten.

   Die von Twilio bereitgestellte Telefonnummer bietet automatisch Unterstützung für Sprach-, SMS- und MMS-Nachrichten. Ihre neue Telefonnummer wird als aktive Rufnummer aufgelistet. Geben Sie bei Bedarf mehrere Telefonnummern an, um den Genehmigungsprozess für diese Nummern parallel abzuwickeln. Wenn Ihre Telefonnummer zuvor von einem anderen Unternehmen genutzt wurde (z. B. weil Twilio Ihnen einen Nummer zugeteilt hat, die bisher anderweitig genutzt wurde), wird die Nummer von WhatsApp abgelehnt.

Lassen Sie die Twilio-Webseite für die spätere Verwendung in einem Web-Browser geöffnet.

WhatsApp um Erlaubnis bitten, Ihre Twilio-Nummer für WhatsApp zu aktivieren

WhatsApp hat ein strenges Verfahren zur Überprüfung aller Unternehmen, die über ihr Netzwerk mit Kunden interagieren möchten. WhatsApp,, das zu Meta (früher Facebook) gehört, verlangt, dass Sie Ihr Unternehmen im Meta-Unternehmensverzeichnis registrieren.

1. Um sich zu registrieren, gehen Sie zur Seite Meta Business Tools und klicken Sie auf "Neues Konto erstellen ". Befolgen Sie die Anweisungen zum Erstellen eines Kontos.

2. Holen Sie sich Ihre Meta Business Manager-ID. Klicken Sie in den Einstellungen auf die Registerkarte "Geschäftsinformationen ". Die ID des Geschäftsführers befindet sich oben auf der Seite.

3. Aktivieren Sie Ihre Twilio-Nummern für WhatsApp über die Webseite WhatsApp, dem einzigen offiziell von Meta unterstützten Weg, um Ihre Kunden ab dem 1. Januar 2025 in WhatsApp einzubinden. Weitere Informationen finden Sie unter "Überblick über WhatsApp ".

   Tipps zum Angeben der folgenden Werte:

   • SID des Twilio-Kontos: Klicken Sie auf der Twilio-Site auf das Home-Symbol, um zu Ihrem Projektdashboard zu wechseln und nach der SID zu suchen.

   • Meta Business Manager ID: Fügen Sie die ID für das Konto hinzu, das Sie im vorherigen Schritt erstellt haben.

   • Bieten Sie Ihren Kunden eine Selbstbedienungs-Onboarding-Funktion an? Nr. auswählen Durch die Einführung des Tech Provider-Programms werden Ihre Kunden mithilfe WhatsApp von Meta WhatsApp aufgenommen.

4. Klicken Sie auf Übergeben.

Geben Sie WhatsApp Zeit, Ihren Antrag zu prüfen und zu genehmigen. Es kann bis zu 7 Tage dauern, bis Ihre Anfrage genehmigt wird.

Integration einrichten

Führen Sie die folgenden Schritte aus, um die Integration einzurichten:

1. Rufen Sie die Seite Integrationen auf, indem Sie im linken Menü auf das Integrationssymbol () klicken.

2. Klicken Sie auf Hinzufügen auf der Kachel WhatsApp mit Twilio.

3. Klicken Sie auf Bestätigen.

4. Klicken Sie auf der Twilio-Website im Menü oben links auf Ihren Kontonamen, um das Dashboard Ihres Kontos aufzurufen.

   Kopieren Sie die folgenden Werte und speichern Sie sie vorübergehend, damit Sie sie in den nächsten Schritten auf der Seite für die Konfiguration der WhatsApp mit Twilio-Integration einfügen können.

   • Konto-SID
   • Authentifizierungstoken

5. Kehren Sie zur Konfigurationsseite für die WhatsApp mit Twilio-Integration zurück. Klicken Sie auf Weiter, um zu Schritt 1 der Konfiguration der WhatsApp mit Twilio-Integration zu gelangen.

6. Geben Sie die Informationen zu Ihrer Konto-SID ein. Klicken Sie auf Weiter, um Schritt 2 der Konfiguration der WhatsApp mit Twilio-Integration aufzurufen.

7. Geben Sie die Informationen zu Ihrem Authentifizierungstoken ein. Klicken Sie auf Weiter, um Schritt 3 der Konfiguration der WhatsApp mit Twilio-Integration aufzurufen.

8. Kopieren Sie den Wert aus dem Feld Webhook-URI.

   Sie können diesen Webhook-URI verwenden, um Ihre Integration im folgenden Abschnitt zu testen.

9. Klicken Sie auf Beenden.

Wenn ein für die Authentifizierung erforderliches Feld geändert wird, müssen alle Einträge in zugehörigen Feldern ausgefüllt und erneut validiert werden.

Testen der Integration

Während Sie auf die Genehmigung Ihres Antrags WhatsApp warten, können Sie die Integration mithilfe der Twilio-Sandbox testen. Mit der Sandbox können Sie vorab genehmigte Vorlagen-Nachrichten an Nummern senden und empfangen, die Ihrer Sandbox beitreten, und zwar über eine gemeinsam genutzte, vorab bereitgestellte Twilio-Testnummer.

Verwenden Sie die Twilio-Sandbox nicht in der Produktionsumgebung. Sandbox-Sitzungen laufen nach 3 Tagen ab.

1. Um einen Sandkasten zu erstellen, gehen Sie auf die Twilio-Konsolen-Webseite und melden Sie sich mit Ihren Twilio-Zugangsdaten an. Eine Eingabeaufforderung zum Aktivieren Ihrer Sandbox (Activate your sandbox) wird angezeigt. Stimmen Sie der Sandbox-Erstellung zu und bestätigen Sie Ihre Auswahl.

2. Folgen Sie den Anweisungen zum Erstellen der Sandbox.

3. Stellen Sie die Verbindung zur Sandbox her, indem Sie eine WhatsApp-Nachricht von Ihrem Gerät an die Sandbox-Telefonnummer senden.

4. Klicken Sie auf der Registerkarte Entwickeln auf Messaging > Einstellungen > Sandbox-Einstellungen für WhatsApp.

5. Fügen Sie im Abschnitt Sandbox-Konfiguration den zuvor kopierten Webhook-URI in das Feld Wenn eine Nachricht eingeht ein. Klicken Sie auf Speichern.

6. Sie können die Integration testen, indem Sie eine Nachricht von WhatsApp an die gemeinsam genutzte Telefonnummer senden, die Ihrer Twilio-Sandbox zugeordnet ist.

Ausführliche Informationen finden Sie unter Erste Schritte mit der Twilio-Sandbox für WhatsApp.

Produktintegration fertigstellen

Nachdem WhatsApp die Berechtigung und den Zugriff auf WhatsApp erteilt hat, aktualisieren Sie die Integration, um Ihre dedizierte Twilio-Telefonnummer anstelle der Sandbox-Nummer zu verwenden.

1. Blättern Sie auf der Konfigurationsseite der WhatsApp mit Twilio-Integration zum Abschnitt Webhook der Registerkarte Basiskonfiguration. Kopieren Sie den Wert aus dem Feld WhatsApp Webhook.

2. Rufen Sie die Webseite Ihres Twilio-Kontos auf und fügen Sie den kopierten Webhook zur Twilio-Konfiguration hinzu, um die Verbindung zur WhatsApp-Integration in Twilio herzustellen.

Geben Sie Kunden schnellen Zugang zu Ihrem Assistenten

Sie können auf Ihrer Webseite ein Symbol hinzufügen, auf das die Kunden klicken können, um über WhatsApp einen Dialog mit Ihrem Assistenten zu beginnen.

Führen Sie die folgenden Schritte aus, um ein Symbol auf Ihrer Webseite hinzuzufügen:

1. Klicken Sie auf der Konfigurationsseite der WhatsApp with Twilio-Integration auf die Registerkarte Klicken und chatten.

2. Fügen Sie im Feld Vordefinierte Nachricht Text hinzu, der im Namen des Kunden per WhatsApp an Ihren Assistenten gesendet werden soll, um den Dialog einzuleiten.

   Geben Sie eine Nachricht an, auf die Ihr Assistent eine hilfreiche Antwort finden kann.

3. Kopieren Sie den eingebetteten Link und fügen Sie den Link auf Ihrer Webseite hinzu. Ziehen Sie in Betracht, vor dem Symbol Text einzufügen, der den Verwendungszweck des Symbols beschreibt. Sie können zum Beispiel einen HTML-Tag <span> vor dem Element <span> des Symbols hinzufügen, der den folgenden Text enthält: Have a question? Ask watsonx Assistant for help.

   Wenn ein Benutzer auf das Symbol auf Ihrer Webseite klickt, wird eine WhatsApp-Messaging-Sitzung geöffnet, die mit Ihrem Assistenten verbunden ist. Der von Ihnen angegebene Text wird in das Textfeld des Benutzers eingefügt und kann abgeschickt werden.

Hinweise zu Aktionen

Für ein optimiertes Kundenerlebnis sollten Sie beim Entwerfen Ihrer Aktionen die Leistungsmerkmale der WhatsApp-Integration berücksichtigen:

• Eine Textantwort, die mehr als 1.600 Zeichen enthält, wird in mehrere Antworten aufgeteilt.
• Verzichten Sie in den Textantworten auf HTML-Elemente.
• WhatsApp mit Twilio unterstützt keine Chat-Weiterleitungen, die mit dem Antworttyp "Mit Agent verbinden " initiiert werden.
• Wenn Sie die Markdown-Syntax verwenden, lesen Sie die Informationen in der Tabelle Unterstützte Markdown-Syntax.
• Wenn Sie einen Hypertext-Link in eine Textantwort einfügen möchten, geben Sie die URL direkt an. Verwenden Sie die Markdown-Syntax nicht für Links. Geben Sie zum Beispiel Folgendes an: Contact us at https://www.ibm.com.