Der Schritt API-Aufruf durchführen ermöglicht es einem Konversations-Bot, über eine REST-API-Anfrage Daten von einem externen System wie Shopify oder Salesforce abzurufen.
In diesem Rezept erstellen Sie eine Bot-Antwort, die Wetterdaten für einen vom Endbenutzer angegebenen Ort abruft. Diese Antwort bezieht die Daten von der OpenWeather API. Sie können den in diesem Rezept erstellten Antwort-Konversationsfluss als Grundlage für Ihre eigenen API-gestützten Antworten nutzen.
- Aufgabe 1: Einrichtung überprüfen
- Aufgabe 2: API-Verbindung erstellen
- Aufgabe 3: Angepasstes Ticketfeld erstellen
- Aufgabe 4: Bot-Antwort erstellen
- Aufgabe 5: Änderungen testen
Aufgabe 1: Einrichtung wird überprüft
Für dieses Rezept benötigen Sie Folgendes:
- Ein Zendesk-Konto mit einem veröffentlichten Konversations-Bot. Wenn Sie möchten, können Sie den Konversations-Bot in einer Sandbox testen, bevor Sie ihn in der Produktionsumgebung einsetzen.
Weitere Informationen zum Einrichten eines Konversations-Bots in einem Web- und Mobile-Messaging-Kanal finden Sie im Beitrag Erstellen eines Konversations-Bots für Web- und Mobilkanäle. Informationen zum Verwenden von Messaging in einer Sandbox-Umgebung finden Sie unter Testen von Zendesk Messaging in der Sandbox.
- Einen API-Schlüssel für ein OpenWeather-Konto. Die in diesem Rezept verwendete API wird im Rahmen eines kostenlosen OpenWeather-Plans bereitgestellt.
Informationen zur Anmeldung für ein kostenloses OpenWeather-Konto finden Sie unter openweathermap.org auf der Seite „Create New Account“. Nach der Anmeldung können Sie den API-Schlüssel auf Ihrer OpenWeather-Kontoseite abrufen.
Beim Aktivieren des OpenWeather-API-Schlüssels müssen Sie die E-Mail-Adresse Ihres Kontos bestätigen. Nach der Bestätigung kann es bis zu zwei Stunden dauern, bis der API-Schlüssel aktiviert ist. Weitere Informationen finden Sie in der FAQ auf openweathermap.org.
Aufgabe 2: API-Verbindung erstellen
Erstellen Sie zunächst eine API-Verbindung, um Ihren OpenWeather-API-Schlüssel zu speichern. Über diese Verbindung kann Ihr Konversations-Bot dann Aufrufe an die OpenWeather-PI authentifizieren.
- Klicken Sie in der Seitenleiste des Admin Centers auf Apps und Integrationen und dann auf Verbindungen > Verbindungen.
- Klicken Sie auf Verbindung erstellen.
- Klicken Sie auf den Authentifizierungstyp API-Schlüssel.
- Geben Sie unter Verbindungsname den Wert openweather_api_key ein.
- Geben Sie unter Name der Kopfzeile den Wert x-api-key ein.
- Geben Sie unter Wert Ihren OpenWeather-API-Schlüssel ein.
- Geben Sie unter Zulässige Domäne die Zeichenfolge api.openweathermap.org ein.
- Klicken Sie auf Speichern, um die Verbindung zu erstellen.
Aufgabe 3: Angepasstes Ticketfeld erstellen
Erstellen Sie anschließend ein angepasstes Ticketfeld, in dem der Endbenutzer den gewünschten Ort angeben kann.
- Klicken Sie in der Seitenleiste des Admin Centers auf Objekte und Regeln und dann auf Tickets > Felder.
- Klicken Sie auf Feld hinzufügen.
- Wählen Sie den Feldtyp Text aus.
- Geben Sie unter Anzeigename die Zeichenfolge Ort ein.
- Klicken Sie unter Berechtigungen auf Kunden können bearbeiten.
- Geben Sie unter Kunden in das Feld Für Kunden sichtbarer Titel die Zeichenfolge Ort ein.
- Klicken Sie auf Speichern.
Wenn in Ihrem Konto nur ein Ticketformular verwendet wird, erscheint das neue Feld automatisch in Ihrem Ticketformular. Wie Sie das Feld entfernen, erfahren Sie unter Erstellen von Ticketformularen.
Aufgabe 4: Bot-Antwort erstellen
In diesem Abschnitt erfahren Sie, wie Sie die Antwort erstellen, ihre Absicht festlegen und Schritte für die Antwort im Bot-Builder hinzufügen. Er umfasst die folgenden Schritte:
- Schritt 1: Antwort erstellen
- Schritt 2: Absicht der Antwort festlegen
- Schritt 3: Schritt für die anfängliche Nachricht hinzufügen
- Schritt 4: Endbenutzer nach einem Ort fragen
- Schritt 5: Wetterdaten für den Ort abrufen
- Schritt 6: Wetterbericht an den Endbenutzer senden
- Schritt 7: Fehlermeldung hinzufügen
- Schritt 8: Aktualisierten Bot veröffentlichen
Schritt 1: Antwort erstellen
Mit dem Bot-Builder können Sie eine Antwort für den Konversations-Bot erstellen.
- Klicken Sie in der Seitenleiste des Admin Centers auf Kanäle und dann auf AI Agents und Automatisierung > AI Agents.
- Klicken Sie auf Konversations-Bots verwalten.
- Klicken Sie auf den gewünschten Konversations-Bot.
- Klicken Sie in der Registerkarte „Antworten“ auf Antwort erstellen.
Schritt 2: Absicht der Antwort festlegen
Legen Sie die Absicht der Antwort und die Trainingssätze fest. Hierzu gehören Sätze und Wörter, die in einer Konversation als Auslöser für die Antwort dienen.
- Klicken Sie in der Registerkarte „Antworten“ der Bearbeitungsseite des Bots auf Antwort erstellen.
- Klicken Sie auf Erstellen Sie Ihre eigene Antwort und dann auf Weiter.
- Geben Sie unter Absicht die Zeichenfolge Wetter abrufen ein.
- Geben Sie unter Trainingssätze die Zeichenfolgen Wettervorhersage anzeigen und Aktuelle Temperatur anzeigen ein.
- Klicken Sie auf Weiter.
Die Antwort wird im Bot-Builder geöffnet. Dort können Sie die Antwort weiter bearbeiten.
Schritt 3: Schritt für die anfängliche Nachricht hinzufügen
Fügen Sie den Schritt Nachricht senden hinzu, um den Benutzer zu bitten, einen Ort einzugeben. Das ist der erste Schritt im Antwort-Konversationsfluss.
- Klicken Sie im Bot-Builder auf Schritt hinzufügen.
- Klicken Sie unter Schritt auswählen auf Nachricht senden.
- Geben Sie unter Bot-Nachricht den folgenden Text ein:
What location would you like to get the weather for? Include the country code. For example: "Melbourne, AU" or "San Francisco, US"
Schritt 4: Endbenutzer nach einem Ort fragen
Fügen Sie nach der anfänglichen Nachricht den Schritt Details anfordern hinzu, damit für den Endbenutzer ein einfaches Formular angezeigt wird. Dieses Formular enthält ein Textfeld für den Wert des Ticketfelds Ort.
- Klicken Sie im Bot-Builder auf das Symbol Schritt hinzufügen ().
- Klicken Sie unter Schritt auswählen auf Details anfordern.
- Geben Sie unter Name die Zeichenfolge Ort abfragen ein.
- Wählen Sie unter Felder das Ticketfeld Ort aus.
Schritt 5: Wetterdaten für den Ort abrufen
Fügen Sie den Schritt API-Aufruf durchführen hinzu, um die Wetterdaten zum jeweiligen Ort vom Endpunkt Current weather data der OpenWeather API abzurufen.
- Klicken Sie im Bot-Builder auf Schritt hinzufügen.
- Klicken Sie unter Schritt auswählen auf API-Aufruf durchführen.
- Geben Sie unter Name die Zeichenfolge Wetter abrufen ein.
- Geben Sie unter API-Details
https://api.openweathermap.org/data/2.5/weather?units=metric&q=
als Endpunkt-URL ein. - Klicken Sie auf das Symbol Variable hinzufügen (), um die Feldvariable Ort an den Wert Endpunkt-URL anzuhängen.
Die fertige Endpunkt-URL sollte in etwa so aussehen:
- Klicken Sie unter Authentifizierung auf die Verbindung openweather_api.
- Klicken Sie auf API-Aufruf durchführen, um die API-Anfrage zu testen.
- Geben Sie unter Testdaten als Ort die Zeichenfolge Melbourne, AU ein.
- Klicken Sie auf API-Aufruf durchführen.
- Speichern Sie die folgenden Variablen unter ihren Standardnamen:
- main > temp
- weather > item 1 > description
Schritt 6: Wetterbericht an den Endbenutzer senden
Verwenden Sie nach Abruf der Wetterdaten den Schritt Nachricht senden, um mit einer Nachricht zu antworten, die die Wetterdaten enthält.
- Klicken Sie im Bot-Builder unter der Verzweigung API-Aufruf erfolgreich des Schritts Wetter abrufen auf Schritt hinzufügen.
- Klicken Sie unter Schritt auswählen auf Nachricht senden.
- Geben Sie unter Bot-Nachricht den folgenden Text ein:
It's {{temp}}° C with {{description}} in
- Klicken Sie auf das Symbol Variable hinzufügen (), um die Feldvariable Ort an den Wert Bot-Nachricht anzuhängen. Fügen Sie anschließend einen Punkt (.) hinzu.
Die Bot-Nachricht sollte in etwa so aussehen:
Schritt 7: Fehlermeldung hinzufügen
Es kann vorkommen, dass die Anfrage im Schritt API-Aufruf durchführen fehlschlägt. Dies geschieht zum Beispiel, wenn sie einen Ort enthält, der nicht existiert. Fügen Sie zur Verzweigung API-Aufruf fehlgeschlagen den Schritt Nachricht senden hinzu. Dieser Schritt gibt eine Nachricht zurück, wenn der Aufruf der OpenWeather API fehlschlägt.
- Klicken Sie im Bot-Builder unter der Verzweigung API-Aufruf fehlgeschlagen des Schritts Wetter abrufen auf Schritt hinzufügen.
- Klicken Sie unter Schritt auswählen auf Nachricht senden.
- Geben Sie unter „Bot-Nachricht“ den folgenden Text ein:
I'm sorry. I wasn't able to get weather data for
- Klicken Sie auf das Symbol Variable hinzufügen (), um die Feldvariable Ort an den Wert Bot-Nachricht anzuhängen. Fügen Sie anschließend einen Punkt (.) hinzu.
Die Bot-Nachricht sollte in etwa so aussehen:
Schritt 8: Aktualisierten Bot veröffentlichen
Veröffentlichen Sie den aktualisierten Bot, um die Antwort zu aktivieren.
- Klicken Sie oben rechts im Bot-Builder auf Fertig.
- Klicken Sie auf der Seite des Bots auf Bot veröffentlichen.
- Klicken Sie auf Veröffentlichen.
Aufgabe 5: Änderungen testen
Nachdem Sie Ihre Änderungen veröffentlicht haben, können Sie die neue Antwort testen, indem Sie in einer Konversation mit dem aktualisierten Bot die Frage „Wie ist das Wetter?“ stellen. Weitere Informationen zum Testen von Konversations-Bots finden Sie unter Testen des Messaging-Erlebnisses der Endbenutzer.