Neben dem Senden von Nachrichten und dem Markieren (oder Entmarkieren) Ihrer Kunden können Sie jetzt Aktionen und workflows in anderen Apps und Systemen mit webhooks in Series orchestrieren.
Mit webhooks in Series können Sie jedes Ereignis oder jede Filterkombination in Intercom verwenden, um Dinge wie Folgendes zu tun:
Halten Sie Kundendaten zwischen mehreren Systemen synchron.
Senden Sie interne Benachrichtigungen an Ihr Team, wenn users einen Meilenstein in einer Series erreichen.
Nehmen Sie Aktualisierungen in Ihrer eigenen benutzerdefinierten App oder Datenbank vor.
Was ist ein webhook?
Ein webhook ist eine Nachricht, die von Intercom gesendet wird, wenn ein user die von Ihnen festgelegten Kriterien erfüllt (z. B. das Abschließen eines Ereignisses). Sie enthält eine Nachricht – oder „Payload“ – und wird an eine eindeutige URL Ihrer Wahl gesendet.
Zum Beispiel ist dies eine einfache Series, die einen webhook sendet, nachdem ein user eine bestimmte Aktion ausgeführt hat:
Der webhook enthält den Namen des users, den Firmennamen und die ID. Die webhook-Payload sieht so aus:
POST https://examply.io/webhooks
Content-Type: application/json
{
name: “Lonnie Lynn”
company: “CSense Ltd”
company_id: “c0m5en5e”
}
Die Anwendung, die den webhook empfängt, kann dann etwas (oder vieles) mit den Daten in der Payload machen. 👌
Hinweis: Das Senden von webhooks mit Series ist nur in bestimmten Intercom-Plänen verfügbar. Hier finden Sie unsere Pläne und Preise.
So fügen Sie einer Series einen webhook hinzu
Ziehen Sie einen webhook aus dem Menü rechts und verbinden Sie ihn mit Ihrer Series nach jedem Regelblock, der ihn auslösen soll:
Öffnen Sie den webhook-Block und geben Sie ihm einen Titel:
Jetzt können Sie genau konfigurieren, welche Daten gesendet werden sollen und wohin sie gesendet werden.
Profi-Tipp: Wenn Sie einen webhook an eine andere Anwendung senden (wie zum Beispiel Zapier), finden Sie normalerweise den Anfragetyp, die webhook-URL und alle erforderlichen Header in deren Dokumentation. Wenn Sie einen webhook an Ihre eigene App senden, sollten Ihre Entwickler diese Informationen bereitstellen können. 👌 |
Beginnen wir mit der HTTP-Methode und der webhook-URL:
Für die Methode können Sie zwischen PUT oder POST wählen, und die URL ist für die App, die den webhook empfangen soll.
Tipp: Beim Testen können Sie RequestBin oder einen ähnlichen Dienst verwenden.
Fügen Sie als Nächstes beliebige webhook-Header als Schlüssel-Wert-Paare hinzu:
Nur der Content-Type-Header ist erforderlich, um einen webhook zu senden (JSON oder URL-encoded), jedoch können zusätzliche Header erforderlich sein, um den webhook zu empfangen.
Zum Beispiel müssen Sie sich möglicherweise bei der empfangenden App authentifizieren.
Um neue Header hinzuzufügen, klicken Sie einfach auf „+ Schlüssel-Wert-Paar hinzufügen“:
Optional wählen Sie die Daten aus, die im webhook-Body als Schlüssel-Wert-Paare enthalten sein sollen. In diesem Beispiel senden wir den Namen, den Firmennamen und die Firmen-ID.
Für dynamische Daten fügen Sie Intercom-Attribute über das „{...}“-Menü hinzu:
Testen Ihres webhook
Bevor Sie Ihre Series live schalten, empfehlen wir, Ihren webhook zu testen, um sicherzustellen, dass er wie erwartet gesendet und empfangen wird. Klicken Sie auf „Test“:
Geben Sie den Namen oder die E-Mail-Adresse eines Testusers ein, damit Sie deren Daten in der webhook-Payload sehen können:
Wählen Sie ihn dann aus und klicken Sie auf „Test ausführen“:
Sie sehen die Antwort, die von der empfangenden App zurückgegeben wird:
Hinweis: Sie sollten einen „200“-Erfolgscode sehen, jeder andere Code erfordert möglicherweise eine Fehlerbehebung mit der empfangenden App.
Was passiert, wenn ein webhook fehlschlägt?
Wenn ein webhook erfolgreich ist, zeichnen wir eine „Gesendet“-Statistik auf. Wenn er fehlschlägt, versuchen wir, ihn 2 weitere Male zu senden. Nach dem dritten Versuch wird der Checkpoint als „Fehlgeschlagen“ markiert. Sie können diese Ergebnisse sehen, indem Sie auf den webhook klicken, sobald Ihre Series live ist. 👍