Aufgabe · Admin-Konsole

Webhooks für Entwickler einrichten

Empfangen Sie Bridge-Ereignisse in Ihrem eigenen Dienst

Bildschirm
Webhooks
Bereich
HubSpot-Integration
Schritte
9
Version
1.0
Aktualisiert

Auch gesucht als: Webhooks, Entwickler, api, callback url, API-Schlüssel, client secret, hmac, Signatur, Ereignisse, Automatisierungen, eigene Integration, test

Markdown-Version

Sie haben Schritt 5 geöffnet: Die Signatur am Endpunkt prüfen

Was Sie tun können

Empfangen Sie Bridge-Ereignisse in Ihrem eigenen Dienst

Unter Developers › Webhooks registrieren Sie Ihren Endpunkt, schützen jede Zustellung mit einer HMAC-Signatur und wählen die Ereignisse für Ihre Automatisierungen. In 9 Schritten.

  • Ihr Endpunkt in Callback URL
  • HMAC-Signatur mit Client Secret
  • CRM- und eigene Funktionen
  • Prüfen mit Test

Schritte

  1. Schritt 1 von 9

    Developers › Webhooks öffnen

    Webhooks werden im Bereich Developers eingerichtet.

    Webhooks erweitern die Integration um eigene Automatisierungen und richten sich an Entwickler und technische Administratoren. Öffnen Sie in der Bridge-Admin-Konsole im seitlichen Menü Developers › Webhooks.

    • Developers › Webhooks
    • Für Entwickler und technische Administratoren

    Schritt 1 auf dem Bildschirm ansehen

  2. Schritt 2 von 9

    Die Callback URL eingeben

    Bridge sendet die Ereignisse an Ihren Endpunkt.

    Geben Sie unter Callback URL den Endpunkt ein, der die Webhook-Ereignisse empfängt, zum Beispiel https://your-service.example.com/webhook. Es ist ein Pflichtfeld.

    • Der Endpunkt, der die Ereignisse empfängt
    • Pflichtfeld

    Schritt 2 auf dem Bildschirm ansehen

  3. Schritt 3 von 9

    Den Bridge-API-Key eingeben

    Der API-Schlüssel authentifiziert das Abonnement.

    Geben Sie unter Bridge-API-Key den API-Schlüssel ein. Er ist der Authentifizierungs-Header, mit dem Anfragen für Webhook-Abonnements authentifiziert werden. Es ist ein Pflichtfeld.

    • Authentifizierungs-Header
    • Authentifiziert Abonnement-Anfragen
    • Pflichtfeld

    Schritt 3 auf dem Bildschirm ansehen

  4. Schritt 4 von 9

    Das Client Secret eingeben

    Das Geheimnis schützt jede Zustellung.

    Geben Sie unter Client Secret das Geheimnis ein, mit dem eine HMAC-Signatur (hashbasierter Nachrichtenauthentifizierungscode) erstellt wird. Die Signatur prüft die Integrität jeder Webhook-Nutzlast und verhindert Fälschungen. Es ist ein Pflichtfeld.

    • Erstellt die HMAC-Signatur
    • Prüft die Integrität, verhindert Fälschungen
    • Pflichtfeld

    Schritt 4 auf dem Bildschirm ansehen

  5. Schritt 5 von 9

    Die Signatur am Endpunkt prüfen

    Ihr Dienst prüft, dass das Ereignis von Bridge stammt.

    Jede Webhook-Nutzlast wird mit HMAC über das Client Secret signiert. Ihr Endpunkt sollte die Signatur prüfen, bevor er die Nutzlast verarbeitet, um sicherzugehen, dass sie von Bridge stammt.

    • Jede Nutzlast ist mit HMAC signiert
    • Signatur vor der Verarbeitung prüfen

    Schritt 5 auf dem Bildschirm ansehen

  6. Schritt 6 von 9

    Prüfen und speichern

    Speichern Sie die Webhook-Einstellungen.

    Wenn alle drei Felder ausgefüllt sind, klicken Sie auf Verify and save.

    • Alle drei Felder ausfüllen
    • Auf Verify and save klicken

    Schritt 6 auf dem Bildschirm ansehen

  7. Schritt 7 von 9

    CRM Connected Features prüfen

    Manche Funktionen werden mit verbundenem CRM bereits gemeldet.

    CRM Connected Features enthält die Funktionen, die bei verbundenem CRM automatisch gemeldet werden, etwa Contact Updates. Sie können sie auch für einen eigenen Webhook konfigurieren, wenn sie an ein anderes Ziel gehen sollen.

    • Mit verbundenem CRM gemeldet
    • Contact Updates
    • Für einen eigenen Webhook konfigurierbar

    Schritt 7 auf dem Bildschirm ansehen

  8. Schritt 8 von 9

    Custom Integration Features wählen

    Weitere Funktionen aktivieren Sie nach Bedarf.

    Custom Integration Features sind optionale Webhooks für Automatisierungen zu bestimmten Ereignistypen, alle in Version V1. Task Notifications wird ausgelöst, wenn eine Aufgabe erstellt, aktualisiert oder abgeschlossen wird; Call Notifications, wenn ein Anruf in Bridge protokolliert wird; Meeting Notifications, wenn ein Meeting erstellt oder aktualisiert wird; Email Notifications, wenn eine E-Mail-Aktivität erfasst wird; und Conversation Summary Notifications, wenn eine tägliche KI-Zusammenfassung einer Unterhaltung erstellt wird.

    • Optionale Webhooks, Version V1
    • Aufgaben, Anrufe, Meetings, E-Mails und Zusammenfassungen

    Schritt 8 auf dem Bildschirm ansehen

  9. Schritt 9 von 9

    Jede Funktion mit Test prüfen

    Prüfen Sie die Integration, bevor Sie sich darauf verlassen.

    Jede konfigurierte Funktion hat im Webhooks-Bildschirm eine Schaltfläche Test. Senden Sie damit eine Beispiel-Nutzlast an Ihren Endpunkt und prüfen Sie, ob Ihre Integration richtig funktioniert. Wenn Sie Hilfe brauchen, schreiben Sie an den Support unter support@sainapsis.com.

    • Auf Test klicken
    • Ihr Endpunkt erhält eine Beispiel-Nutzlast
    • Prüfen, ob die Integration funktioniert

    Schritt 9 auf dem Bildschirm ansehen