Webhooks
Video zur Funktion
Für wen ist das gedacht?
- Für technische Teams, die am Ende jedes Anrufs eine automatische Verarbeitung auslösen wollen.
- Für Administratoren, die ein Data Warehouse, ein internes Tool oder eine selbst gebaute Automatisierung versorgen.
Berechtigungen und Lizenzen
- Erfordert: AI Meeting
- Das Ansehen der Webhooks erfordert die Leseberechtigung für Webhooks, das Erstellen und Ändern die Schreibberechtigung.
- Die gesendeten Daten folgen dem Format der öffentlichen API: Die Webhook-Referenz beschreibt es im Detail.
Anleitung
Die Seite Webhooks öffnen
Gehen Sie zu Einstellungen > Erweitert > Webhooks. Die Liste zeigt für jeden Webhook den Namen, die Zugriffsregeln, die URL, die Beschreibung und den Status.
Einen Webhook erstellen
Klicken Sie auf "Hinzufügen" und geben Sie einen Namen, die URL, die die Ereignisse empfangen soll, und eine Beschreibung ein. Die URL muss aus dem Internet erreichbar sein und darf nur von einem Webhook Ihres Unternehmens verwendet werden.
Die Zugriffsregeln festlegen
Es stehen drei Modi zur Verfügung:
- Mit einem Benutzer verknüpft: Der Webhook erhält nur Ereignisse zu Anrufen, auf die dieser Benutzer zugreifen kann.
- Zugriff auf alles: Der Webhook erhält die Ereignisse aller Anrufe des Unternehmens.
- Benutzerdefinierter Zugriff: Nach dem Speichern werden Sie zur Seite Zugriffsregeln weitergeleitet, um den genauen Umfang festzulegen.
Die empfangenen Ereignisse verarbeiten
Ihr Endpunkt erhält bei jedem verarbeiteten Anruf eine POST-Anfrage. Antworten Sie mit einem Erfolgscode und verarbeiten Sie den Inhalt anschließend auf Ihrer Seite. Ereignis, Inhalt der Anfrage und erneute Versuche: siehe Referenzen › Entwickler › Webhook-Ereignisse.
Einen Webhook aktivieren oder pausieren
Der Schalter in der Spalte "Aktiv" pausiert den Versand der Ereignisse, ohne die Konfiguration zu löschen, zum Beispiel während einer Wartung auf Ihrer Seite.
Weiterführende Informationen
- Heute existiert nur ein Ereignistyp, der gesendet wird, sobald das Transkript und die KI-Insights vollständig erzeugt sind. Sein Inhalt und der Zeitplan der erneuten Versuche sind in der Referenz der Webhook-Ereignisse beschrieben.
- Ein Webhook, dessen Versand auch nach zehn erneuten Versuchen fehlschlägt, wird automatisch deaktiviert: Aktivieren Sie ihn wieder, sobald Ihr Endpunkt erreichbar ist.
- API-Schlüssel decken das umgekehrte Bedürfnis ab: Leexi abfragen, wann es Ihnen passt, statt auf ein Ereignis zu warten.
Häufige Fragen
Wichtige Hinweise
- Die Anfrage ist nicht signiert: Verwenden Sie eine URL, die schwer zu erraten ist, und fragen Sie die öffentliche API erneut ab, wenn Sie die empfangenen Daten validieren müssen.
- Ein langsamer oder nicht verfügbarer Endpunkt führt am Ende zur Deaktivierung des Webhooks: Bestätigen Sie den Empfang besser schnell und verarbeiten Sie den Inhalt danach.
- Ereignisse werden für den Zeitraum, in dem der Webhook inaktiv war, nicht erneut gesendet: In dieser Zeit verarbeitete Anrufe müssen über die öffentliche API abgerufen werden.
- Der gesendete Inhalt umfasst die Daten des Anrufs: Stellen Sie sicher, dass das empfangende System das erwartete Maß an Vertraulichkeit bietet.