Bisher wurden Ziele verwendet, um Informationen an externe cloudbasierte Anwendungen und Dienste zu übergeben und sie über Änderungen in Zendesk zu informieren. In diesem Beitrag wird beschrieben, wie Sie die meisten vorhandene URL-Ziele in Webhooks umwandeln.
Überblick über das Konvertieren von Zielen in Webhooks
- Erstellen eines neuen Webhooks anhand Ihres Ziels
- Konfigurieren eines Auslösers für den Versand der Webhook-Benachrichtigungen
- Vergewissern Sie sich, dass der neue Webhook und der Auslöser wie erwartet funktionieren, und deaktivieren Sie Ihr Ziel sowie alle mit dem Ziel verknüpften Auslöser.
Konvertieren von Clickatell-, Pivotal-, Twilio-, X Corp- und Yammer-Zielen
Clickatell-, Pivotal-, Twilio-, X Corp- (ehemals Twitter) und Yammer-Zielkonfigurationen können Webhooks nicht direkt zugeordnet werden. Wir empfehlen Ihnen, sich auf dem Zendesk Marketplace nach Apps umzusehen, die Ihren Anforderungen entsprechen.
Erstellen eines neuen Webhooks anhand Ihres Ziels
Für die Umwandlung Ihrer Ziele in Webhooks sollten Sie die Details des Ziels in einem und den Webhook in einem anderen Fenster öffnen.
So erstellen Sie einen Webhook anhand eines URL-Ziels
- Öffnen Sie das URL-Ziel in einem Browserfenster.
- Klicken Sie in der Seitenleiste des Admin Centers auf
Apps und Integrationen und dann auf Ziele > Ziele. - Wählen Sie das Ziel aus, das Sie in einen Webhook umwandeln möchten, und klicken Sie auf Bearbeiten.
- Klicken Sie in der Seitenleiste des Admin Centers auf
- Öffnen Sie die Seite „Webhooks“ in einem separaten Browserfenster.
- Klicken Sie in der Seitenleiste des Admin Centers auf Apps und Integrationen und dann auf Aktionen und Webhooks > Webhooks.
- Klicken Sie in der Seitenleiste des Admin Centers auf
- Klicken Sie auf Webhook erstellen.
- Wählen Sie die Verbindungsart Auslöser oder Automatisierung aus und klicken Sie auf Weiter.
- Ordnen Sie die Zielwerte den Webhook-Feldern zu. Detaillierte Anweisungen hierzu finden Sie unter:
- Klicken Sie auf Webhook erstellen.
Zuordnen von Basecamp-Zielkonfigurationen zu Webhooks
- Titel: Der Name des Webhooks
- URL: Die Endpunkt-URL des Webhooks
- Wählen Sie eine der folgenden Methoden der Webhook-Authentifizierung aus:
- Benutzername und Kennwort: Stellen Sie die Authentifizierung des Webhooks auf Standardauthentifizierung ein und geben Sie den Basecamp-Benutzernamen und das dazugehörige Kennwort ein. Das Kennwort kann nicht kopiert und eingefügt werden.
- API-Token: Stellen Sie die Authentifizierung des Webhooks auf API-Schlüssel ein und geben Sie das API-Token des Campfire-Ziels ein.
- Projekt-ID: Hängen Sie an die Endpunkt-URL des Webhooks die Zeichenfolge /projects/[ID] ein. Beispiel: https://corp.basecamphq.com/projects/2612430.
-
Ressourcen: Hängen Sie an die Projekt-ID in der Endpunkt-URL des Webhooks Folgendes an:
-
Nachricht: Hängen Sie /posts/[ID]/comments an. Beispiel:
https://corp.basecamphq.com/projects/2612430/posts/25611692/comments - Aufgabe: Hängen Sie /todo_lists/[ID] an. Beispiel: https://corp.basecamphq.com/projects/2612430/todo_lists/25611692.
-
Nachricht: Hängen Sie /posts/[ID]/comments an. Beispiel:
Zuordnen von Campfire-Zielkonfigurationen zu Webhooks
- Titel: Der Name des Webhooks
- Subdomäne: Die Endpunkt-URL des Webhooks
- API-Token: Stellen Sie die Authentifizierung des Webhooks auf API-Schlüssel ein und geben Sie das API-Token des Campfire-Ziels ein.
- Room: Hängen Sie diese Information an die Endpunkt-URL des Webhooks an.
- SSL: Beim Erstellen eines Webhooks nicht anwendbar.
- Format beibehalten: Beim Erstellen eines Webhooks nicht anwendbar.
Zuordnen von Get Satisfaction-Zielkonfigurationen zu Webhooks
- Titel: Der Name des Webhooks
-
Unternehmensname: Binden Sie den Namen in die Endpunkt-URL des Webhooks ein. Beispiel:
https://getsatisfaction.com/yourcompany/ - E-Mail und Kennwort: Setzen Sie die Authentifizierung des Webhooks auf Standardauthentifizierung und geben Sie den Get Satisfaction-Benutzernamen und das dazugehörige Kennwort ein. Das Kennwort kann nicht kopiert und eingefügt werden.
Zuordnen von Jira-Zielkonfigurationen zu Webhooks
- Titel: Der Name des Webhooks
- URL: Die Endpunkt-URL des Webhooks
- Benutzername und Kennwort: Stellen Sie die Authentifizierung des Webhooks auf Standardauthentifizierung ein und geben Sie den Jira-Benutzernamen und das dazugehörige Kennwort ein. Das Kennwort kann nicht kopiert und eingefügt werden.
Zuordnen von URL-Zielkonfigurationen zu Webhooks
- Titel: Der Name des Webhooks
- URL: Die Endpunkt-URL des Webhooks
- Methode: Die Anfragemethode des Webhooks
- Attributname: Beim Erstellen des Webhooks nicht erforderlich, wird aber beim Konfigurieren der Auslöseraktionen verwendet.
- Standardauthentifizierung Stellen Sie die Authentifizierung des Webhooks auf Standardauthentifizierung ein und geben Sie den Benutzernamen und das Kennwort des URL-Ziels ein. Das Kennwort kann nicht kopiert und eingefügt werden.
- Außerdem müssen Sie das Anfrageformat des Webhooks auf Formularcodiert einstellen.
Konfigurieren eines Auslösers für den Versand der Webhook-Benachrichtigungen
Sie sollten bereits einen Auslöser für den Versand von Benachrichtigungen konfiguriert haben, der auf dem Ziel basiert. Diesen Auslöser können Sie bearbeiten oder klonen. Sie haben aber auch die Möglichkeit, einen neuen Auslöser zu erstellen.
- Klicken Sie in der Seitenleiste des Admin Centers auf
Objekte und Regeln und dann auf Business-Regeln > Auslöser. -
Bearbeiten oder klonen Sie einen vorhandenen Auslöser.
Notieren Sie den Wert im Feld Message für die Aktion Benachrichtigen von > Ziel. Sie benötigen ihn für Ihre neue Webhook-basierte Aktion.
- Klicken Sie unter Aktionen auf Aktion hinzufügen und dann auf Benachrichtigen von > Aktiver Webhook.
- Wählen Sie in der Dropdownliste den Webhook aus, den Sie als Ersatz für das Ziel erstellt haben.
- Konfigurieren Sie den Webhook für den Versand der gewünschten Informationen.
Wenn Sie beispielsweise ein URL-Ziel ersetzen, führen Sie unter URL-Parameter folgende Aufgaben aus:
- Setzen Sie den Schlüssel auf den Attributnamen des URL-Ziels.
- Setzen Sie den Wert auf die Nachricht der Aktion Benachrichtigen von > Ziel.
- Klicken Sie auf Speichern.
- Kehren Sie zum Webhook zurück und testen Sie seine Funktion.
Deaktivieren Ihrer Ziele und der zugehörigen Auslöser
Nachdem Sie den Webhook erstellt und den zugehörigen Auslöser aktualisiert haben, testen Sie den Webhook gründlich, indem Sie die entsprechenden Bedingungen auslösen. Während der Auslöser mit zwei Benachrichtigen von-Aktionen konfiguriert ist – einer für das Ziel und einer für den Webhook – sollten Sie in Ihrer externen Anwendung oder Ihrem System doppelte Nachrichten erhalten.
Nachdem Sie sich vergewissert haben, dass der Webhook und der Auslöser ordnungsgemäß funktionieren, bearbeiten Sie den Auslöser, um die Aktion Benachrichtigen durch > Ziel zu entfernen, und deaktivieren oder löschen Sie dann Ihr Ziel.