Mithilfe von Konversationsintegrationen können Unternehmen Nachrichten aus allen Kanälen, Chatbots oder Drittanbieter-Apps in einer gemeinsamen Konversation zusammenführen und überall interaktive Erlebnisse schaffen.
- einem Webhook.
- (optional) einem Satz API-Schlüssel für die Interaktion mit der öffentlichen API im Rahmen der Integration. Informationen zum Erstellen der API-Schlüssel finden Sie unter Using Conversations API keys (Englisch).
Hinweis: Konversationsintegrationen waren bisher im Sunshine Conversations-Dashboard unter dem Namen Webhooks bekannt.
Sie können Konversationsintegrationen über die Seite „Konversationsintegrationen“ im Admin Center erstellen.
Außerdem können Sie Ihre Integration mit curl oder Postman erstellen.
Dieser Beitrag enthält die folgenden Abschnitte:
Erstellen und Konfigurieren von Konversationen im Admin Center
Auf der Seite „Konversationsintegrationen“ können Sie folgende Aufgaben ausführen:
Erstellen einer neuen Konversationsintegration
-
Klicken Sie in der Seitenleiste des Admin Centers auf Apps und Integrationen und dann auf Integrationen > Konversationsintegrationen. Die Seite „Konversationsintegrationen“ wird geöffnet. In der Liste sind alle zuvor erstellten Konversationen aufgeführt.
Wenn Sie zum ersten Mal eine Integration im Admin Center erstellen, klicken Sie auf Integration erstellen, um die Seite „Konversationsintegrationen“ anzuzeigen.
- Klicken Sie auf Integration erstellen. Die Seite „Integration erstellen“ wird geöffnet.
- Geben Sie einen eindeutigen Namen für die Integration ein.
- Geben Sie im Abschnitt „Webhook“ die folgenden Informationen ein:
-
Webhook-Endpunkt-URL: Die Ziel-URL. Wenn ein Auslöserereignis eintritt, erkennt der Webhook das Ereignis und sendet die Daten an die Ziel-URL. Die Ziel-URL weist das folgende Format auf:
https://www.yourdomain.com/path
. - Webhook-Textdaten: Geben Sie mit diesen Kontrollkästchen an, ob Sie das Benutzerschema sowie die Client- und Geräteinformationen in die Webhook-Daten aufnehmen möchten.
- Webhook-Abonnements: Wählen Sie die Ereignisse aus, bei denen Sie benachrichtigt werden möchten.
-
Webhook-Endpunkt-URL: Die Ziel-URL. Wenn ein Auslöserereignis eintritt, erkennt der Webhook das Ereignis und sendet die Daten an die Ziel-URL. Die Ziel-URL weist das folgende Format auf:
- Klicken Sie auf Speichern. Das Fenster „Geteilten Schlüssel kopieren“ wird geöffnet.
- (Optional) Kopieren Sie die Webhook-ID und den geteilten Schlüssel. Diese werden von Entwicklern verwendet, um eine weitere Authentifizierungsebene hinzuzufügen, und sind nicht erforderlich.
- Klicken Sie auf Weiter. Die Konfigurationsseite der Integration wird geöffnet. Hier können Sie bei Bedarf einen API-Schlüssel hinzufügen.
Hinzufügen eines API-Schlüssels
In der Registerkarte „API-Schlüssel“ können Sie die Authentifizierung für die Integration konfigurieren. Ein API-Schlüssel identifiziert und authentifiziert eine Anwendung oder einen Benutzer und weist drei Komponenten auf:
- Die App-ID identifiziert Ihr Zendesk-Konto.
- Die Schlüssel-ID wird zusammen mit dem Geheimschlüssel als Legitimation für die Authentifizierung von JWTs und API-Aufrufen.
- Der Geheimschlüssel ist das Authentifizierungskennwort.
So erstellen und teilen Sie einen API-Schlüssel
- Klicken Sie in der Seitenleiste des Admin Centers auf Apps und Integrationen und dann auf Integrationen > Konversationsintegrationen. Die Seite „Konversationsintegrationen“ wird geöffnet.
- Klicken Sie auf die Registerkarte „API-Schlüssel“.
- Klicken Sie auf API-Schlüssel erstellen. Wenn Sie Ihren ersten Schlüssel erstellen, wird diese Schaltfläche unten auf der Seite angezeigt. Haben Sie bereits einen Schlüssel erstellt, erscheint sie in der rechten oberen Ecke.
- Geben Sie im Dialogfeld „Neuen Schlüssel erstellen“ einen aussagekräftigen Namen für den Schlüssel ein und klicken Sie dann auf Weiter.
- Klicken Sie im Dialogfeld „Geteilten Schlüssel kopieren“ für jede ID und jeden Geheimschlüssel auf Kopieren, um die Daten in der Zwischenablage zu speichern, und dann auf Weiter. Sie kehren zum API-Fenster zurück. Der neue Schlüssel ist jetzt in der Liste aufgeführt.
Wenn Sie Ihr Limit von 10 Schlüsseln erreicht haben, werden Sie beim Generieren eines weiteren Schlüssels aufgefordert, einen ungenutzten Schlüssel zu löschen.
So löschen Sie einen ungenutzten Schlüssel
- Klicken Sie in der Seitenleiste des Admin Centers auf Apps und Integrationen und dann auf Integrationen > Konversationsintegrationen.
- Klicken Sie auf die Registerkarte „API-Schlüssel“.
- Setzen Sie den Mauszeiger auf den gewünschten Schlüssel, klicken Sie auf das Optionsmenü () und dann auf Löschen.
Anzeigen, Bearbeiten und Löschen von Integrationen
So verwenden Sie eine vorhandene Integration
- Klicken Sie in der Seitenleiste des Admin Centers auf Apps und Integrationen und dann auf Integrationen > Konversationsintegrationen. Die Seite „Konversationsintegrationen“ wird geöffnet.
- Setzen Sie den Mauszeiger auf die Integration, die Sie aktualisieren möchten, klicken Sie auf das Symbol Optionen () und wählen Sie eine Option aus:
- Details anzeigen: Zeigt die Detailseite der Integration an, auf der Sie die App-, die Integrations- und die Webhook-ID sowie Informationen zu geteilten Schlüsseln, Webhook-Details und API-Schlüsseln anzeigen können.
- Bearbeiten: Öffnet die Seite „Integration erstellen“, auf der Sie den Namen und die Webhook-Details der Integration aktualisieren können.
- Löschen: Startet einen Löschassistenten. Sie können den Assistenten jederzeit abbrechen und verlassen.
Weitere Integrationsmethoden
Diese Methoden stehen nur Benutzern mit einer separaten Sunshine Conversations-Lizenz zur Verfügung und können nicht mit der in Zendesk Suite Professional oder höher enthaltenen Lizenz verwendet werden.
So erstellen Sie eine Konversationsintegration mit curl
- Erstellen Sie eine Integration mit der Create Integration API und setzen Sie
type
aufcustom
. - Geben Sie die in der API angegebenen notwendigen Parameter an. Das Ziel ist die URL Ihres Servers. Die Auslöser in der Liste geben an, welche Ereignisse empfangen werden sollen.
So erstellen Sie eine Konversationsintegration mit Postman
- Erstellen Sie eine Integration mit der Create Integration API und setzen Sie
type
aufcustom
. - Laden Sie die Anwendung Postman herunter und installieren Sie sie.
- Laden Sie die Sunshine Conversations Postman Collection herunter und richten Sie Ihre Umgebung ein.
- Klicken Sie in Postman auf Smooch > Integrations > Create Integrations.
- Geben Sie die durch Ihren Integrationstyp angegebenen notwendigen Parameter ein.
Weitere Informationen zu den Sunshine Conversations APIs finden Sie unter Integrations (Englisch).
Lesen Sie außerdem die Anleitungen zum Senden und Empfangen von Nachrichten. Sie sollten Webhooks mit REST APIs konfigurieren.