Allgemeine Einstellungen
Webhooks
Automatisch ein Ereignis in Ihren eigenen Systemen erhalten, sobald ein Leexi-Anruf transkribiert und analysiert wurde.
Definition: Ein Webhook benachrichtigt Ihre Systeme, ohne dass Sie Leexi abfragen müssen. Sobald ein Anruf transkribiert und seine KI-Insights erzeugt sind, sendet Leexi eine Anfrage an die von Ihnen konfigurierte URL, zusammen mit dem Inhalt des Anrufs.
Video zur Funktion
Derzeit ist kein Video verfügbar.
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
- 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 > Erweiterte Einstellungen > 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 eine POST-Anfrage mit dem Ereignistyp und den Daten des Anrufs. Antworten Sie mit einem Erfolgscode und verarbeiten Sie den Inhalt anschließend auf Ihrer Seite.
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,
call.processed, der gesendet wird, sobald das Transkript und die KI-Insights vollständig erzeugt sind. - Der Anfragekörper enthält den Namen des Ereignisses und die Daten des Anrufs, im gleichen Format wie der detaillierte Anruf der öffentlichen API.
- Antwortet Ihr Endpunkt nicht oder gibt er einen Fehler zurück, versucht Leexi es bis zu zehn Mal erneut, mit zunehmender Verzögerung: 10 Sekunden, 1 Minute, 5, 15 und 30 Minuten, 1 Stunde, 6 Stunden, dann alle 24 Stunden.
- Nach diesen zehn Versuchen wird der Webhook automatisch deaktiviert und die Administratoren des Unternehmens erhalten eine E-Mail darüber. 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
Jede Erfolgsantwort genügt. Jede Fehlerantwort löst, wie auch das Ausbleiben einer Antwort, einen neuen Versuch aus.
Weil zehn Sendeversuche in Folge fehlgeschlagen sind. Prüfen Sie, ob Ihre URL erreichbar ist und korrekt antwortet, und aktivieren Sie den Webhook anschließend wieder.
Nein, beide funktionieren unabhängig voneinander. Ein API-Schlüssel bleibt nützlich, wenn Sie nach dem Empfang eines Ereignisses zusätzliche Daten abrufen möchten.
Ja, indem Sie benutzerdefinierten Zugriff und die entsprechenden Zugriffsregeln konfigurieren.
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.