Webhook-Ereignisse
POST-Anfrage sendet. Webhooks werden unter Einstellungen > Erweitert > Webhooks erstellt, einer Seite, die Personen vorbehalten ist, die Webhooks verwalten dürfen, ab dem Plan AI Meeting. Diese Seite beschreibt, was Ihre URL empfängt; das Erstellen und Aussetzen eines Webhooks wird in der Anleitung Webhooks erklärt.Ereignis
| Ereignis | Wann es gesendet wird |
|---|---|
call.processed | Sobald das Transkript und die KI-Insights eines Anrufs vollständig generiert sind. |
Es ist das einzige vorhandene Ereignis. Es wird einmal pro Anruf und pro Webhook gesendet; Anrufe, die verarbeitet werden, während ein Webhook inaktiv ist, werden nicht nachgeliefert.
Inhalt der Anfrage
Der Body ist ein JSON-Objekt mit zwei Feldern:
| Feld | Inhalt |
|---|---|
event | Der Name des Ereignisses, call.processed. |
data | Der vollständige Anruf, im selben Format wie das detaillierte Lesen eines Anrufs in der öffentlichen API: Metadaten, Teilnehmer, Transkript, Zusammenfassung. |
Die Felder des Anrufobjekts sind in der Referenz der öffentlichen API beschrieben; die Einstiegsanleitung für Webhooks finden Sie in der Webhooks-Referenz. Die Anfrage ist nicht signiert.
Empfangende Webhooks
Nur aktive Webhooks, deren Zugriffsregeln den Anruf abdecken, erhalten das Ereignis:
| Modus des Webhooks | Empfangene Anrufe |
|---|---|
| Zugriff auf alles | Alle Anrufe des Unternehmens. |
| Mit einem Benutzer verknüpft | Die Anrufe, auf die der gewählte Benutzer Zugriff hat. |
| Benutzerdefinierter Zugriff | Die Anrufe, die durch die Zugriffsregeln geöffnet werden, deren Empfänger der Webhook ist; ohne Regel keine. |
Die Zugriffsregeln speziell für Webhooks sind unter Arten von Zugriffsregeln beschrieben.
Erfolg und erneute Versuche
Ein Versand ist erfolgreich, sobald Ihre URL mit einem HTTP-Code unter 400 antwortet. Jede andere Antwort, eine Zeitüberschreitung oder ein Verbindungsfehler löst einen erneuten Versuch nach folgendem Zeitplan aus:
| Versuch | Wartezeit nach dem vorherigen Fehlschlag |
|---|---|
| 2 | 10 Sekunden |
| 3 | 1 Minute |
| 4 | 5 Minuten |
| 5 | 15 Minuten |
| 6 | 30 Minuten |
| 7 | 1 Stunde |
| 8 | 6 Stunden |
| 9 | 24 Stunden |
| 10 | 24 Stunden |
| 11 | 24 Stunden |
Nach dem elften aufeinanderfolgenden Fehlschlag (der erste Versand, dann seine zehn erneuten Versuche) wird der Webhook deaktiviert, und die aktiven Super admins des Unternehmens erhalten eine E-Mail mit dem Namen des Webhooks und dem Zeitpunkt der Deaktivierung. Der Webhook wird über seine Zeile in der Liste wieder aktiviert, sobald Ihre URL wieder erreichbar ist.
Verwandte Artikel
Vorherige und nächste Seiten
Scopes der API-Schlüssel
Die Berechtigungen, die einem API-Schlüssel zugewiesen werden können, was jede erlaubt, und die drei Modi der Zugriffsregeln, die die sichtbaren Anrufe abgrenzen.
MCP-Tools
Der MCP-Server von Leexi, seine beiden Scopes, die fünf Tools, die Ihrem KI-Assistenten zur Verfügung stehen, ihre Limits und der erforderliche Plan.