Für: Administratoren
Richten Sie einen Webhook für die Feed-Aktivität ein.
Sende deinem eigenen System eine Nachricht, sobald ein Feed-Beitrag, ein Kommentar oder ein Anhang hinzugefügt, geändert oder gelöscht wird.
In diesem Artikel8 Abschnitte
Der WebhookWebhook Eine Adresse, die Sie dem Hub geben, damit dieser Ihre eigenen Systeme benachrichtigen kann, sobald sich ein Feed-Beitrag oder ein Kommentar ändert. sendet jedes Mal eine Nachricht an das eigene System aus, wenn etwas auf dem FeedFutter Die Chronologie der Beiträge zu einem Fall, in der die Kanzlei Neuigkeiten teilt und jeder, der an dem Fall beteiligt ist, Kommentare abgeben kann. eines Falls passiert – beispielsweise ein neuer Beitrag oder eine neue Kommentar. Jede Nachricht ist verschlüsselt, sodass das Empfangssystem dazu einen Code des Entwicklers benötigt, um die Nachricht zu entschlüsseln.
Webhooks öffnen
Gehen Sie zu Integration › Webhooks und wählen Sie NEU aus.
Adresse eingeben
Unter URL geben Sie die Adresse ein, auf der die Nachrichten gesendet werden sollen. Dabei handelt es sich um die Adresse Ihres Systems, die dazu dient, die Nachrichten zu empfangen. Die Adresse muss mit https:// oder http:// beginnen und über das Internet zugänglich sein. Großbuchstaben werden bei der Eingabe beibehalten.
Beschreibung ist optional: eine Anmerkung für Ihr Team – beispielsweise Informationen zu Fällen, die in unserem CRM-System gespeichert werden.
Wählen Sie die Ereignisse aus
Unter Veranstaltungen werden alle Elemente ausgewählt, die eine Nachricht senden sollen – also Beitrag wird erstellt und Beitragskommentar wird erstellt. Es gibt insgesamt zehn solcher Elemente: Nachrichten, Kommentare zu Nachrichten sowie Dateien, die hinzugefügt oder entfernt werden können. Websocket-Ereignisse und die enthaltenen Daten beschreiben, welche Informationen jedes dieser Elemente enthält.
Schalten Sie es ein und speichern Sie es.
Aktiv wird automatisch aktiviert. Wenn dieses Feld nicht aktiviert ist, erhält der inaktive Webhook nichts. Was er verpasst, wird später nicht gesendet. Wählen Sie SPEICHERN aus. „Webhook hinzugefügt“ wird angezeigt.
Bewahre das Geheimnis
Die Geheimer Webhook-Fensterzeile zeigt den „Webhook-Secret“ an: Es handelt sich dabei um die private Schlüssel, mit dem jede gesendete Nachricht entschlüsselt werden kann. Dieser Wert wird nur einmal angezeigt. Wählen Sie Als .pem-Datei herunterladen, um ihn als Datei zu speichern, oder In die Zwischenablage kopieren, um den gesamten Inhalt – einschließlich der Zeilenumbrüche – zu kopieren. Übergeben Sie diesen Inhalt sicher an Ihren Entwickler – beispielsweise über einen Passwortmanager. Anschließend wählen Sie Getan.
Teste es
Fügen Sie eine kurze Meldung zu einem Fall hinzu – einem Fall, bei dem es keine echten Kunden gibt. Das kann einer der beiden Beispielfälle sein, mit denen Ihr Entwickler gearbeitet hat. Der Entwickler überprüft, dass die Nachricht angekommen ist und dass das Geheimnis korrekt gelesen wurde.
Was geschieht als Nächstes?
Jedes Mal, wenn ein ausgewählter Ereignis in Ihrem Hub stattfindet, sendet der Webhook eine Nachricht an Ihr System – und zwar an die Person, die den Änderungsvorgang durchgeführt hat: Ihre Teammitglieder, ein Kunde, der Virtual AssistantVirtueller Assistent Ein automatisiertes Teammitglied, das Begrüßungsnachrichten, Check-ins und Statusmeldungen für das Unternehmen veröffentlicht; seine Beiträge sind mit einem Virtual Assistant-Abzeichen versehen., eine Importdatei oder eine API-Schlüssel. Niemand sonst wird darüber informiert.
Wenn zwei Lieferungen hintereinander fehlschlagen, wird der Webhook deaktiviert und jeder Administrator wird per E-Mail informiert. Siehe dazu… Stellen Sie einen Webhook fest, der nicht mehr sendet.. Um die Adresse oder die Ereignisse zu ändern, wählen Sie das Stift-Symbol aus. Webhook bearbeiten, Auf seiner Reihe bleibt das Geheimnis bestehen.
Wenn etwas schiefgeht
- Die Obergrenze für Webhooks wurde erreicht. Ihr Hub kann fünf Webhooks haben. Löschen Sie einen der Webhooks, die Sie nicht mehr benötigen: Wählen Sie das Symbol des Kastens aus. Webhook löschen, Auf seiner Reihe dann. Löschen. Es hört sofort auf zu funktionieren – und kann nicht wieder in Betrieb genommen werden.
- Die URL ist ungültig. Beispiel: https://example.com/hook Geben Sie die gesamte Adresse ein – beginnend mit https:// oder http://. Eine Adresse, die nur auf Ihrem eigenen Computer funktioniert, wird nicht akzeptiert.
- Sie haben den Geheimnissen verloren. Es kann nicht erneut verwendet werden. Fügen Sie einen neuen Webhook hinzu – mit demselben Adress- und Ereignisverzeichnis. Geben Sie das entsprechende Geheimwort an Ihren Entwickler weiter. Anschließend löschen Sie den alten Webhook.