Zum Hauptinhalt springen
Webhooks senden itellicoAI-Echtzeitereignisse an ein anderes System, das du betreibst. Zugriff: Gehe zu Einstellungen → Entwickler → Webhooks.
Diese Seite wird in der Regel von einem technischen Teammitglied eingerichtet, auch wenn Betriebs-, Vertriebs- oder Support-Teams entscheiden, welche Ereignisse Folgemaßnahmen auslösen sollen.

​
Was du konfigurierst

Jedes Webhook-Abonnement enthält:
  • Name
  • Ziel-URL
  • Aktiv/Inaktiv-Status
  • Optionales Signing-Secret
  • Optionaler Agentenbereich
  • Ereignisabonnements
Wenn du keine Agenten auswählst, gilt der Webhook für alle Agenten im aktuellen Account.

​
Einen Webhook erstellen

1

Webhooks öffnen

Navigiere zu Einstellungen → Entwickler → Webhooks.
2

Webhook erstellen

Klicke auf Webhook erstellen.
3

Erstellungsformular prüfen

Der Erstellungsdialog enthält Steuerungselemente für Ziel, Signing-Secret, Agentenbereich und Ereignisauswahl.
4

Ziel festlegen

Füge einen beschreibenden Namen und die HTTPS-Adresse ein, die Zustellungen empfangen soll.
5

Signing-Secret generieren

Verwende die Aktion Neu generieren, um ein Signing-Secret zu erstellen.
6

Agentenbereich wählen

Schränke den Webhook optional auf einen oder mehrere Agenten ein. Lasse das Feld leer, um Ereignisse für alle Agenten zu empfangen.
7

Ereignisse auswählen

Wähle die Ereignisgruppen und einzelnen Ereignisse aus, die du empfangen möchtest.
8

Abonnement speichern

Erstelle den Webhook und stelle sicher, dass das empfangende System Ereignisse schnell bestätigen kann.
Wenn du ein Secret generierst oder neu generierst, kopiere es sofort und speichere es sicher, bevor du den Dialog schließt. Die aktuelle Benutzeroberfläche erlaubt es nicht, einen benutzerdefinierten Secret-Wert direkt einzufügen.

​
Schnellster Weg zum Testen

Wenn du Webhooks zum ersten Mal einrichtest, beginne mit einem temporären Inspektionsendpunkt, bevor du dein Produktionssystem verbindest.
1

Temporären Endpunkt erstellen

Verwende einen Anfragen-Inspektionsdienst wie Webhook.site oder RequestBin, um eine eindeutige HTTPS-URL zu erhalten.
2

Enges Abonnement erstellen

Abonniere nur ein oder zwei Ereignisse, z. B. conversation.ended oder conversation.analysis.completed.
3

Ein echtes Ereignis auslösen

Starte einen Testanruf oder schließe den Workflow ab, der das ausgewählte Ereignis auslösen soll.
4

Payload prüfen

Überprüfe Header, Signaturfelder, Ereignistyp und die data-Payload-Struktur, bevor du deinen echten Endpunkt verbindest.
5

Zum Produktionsendpunkt wechseln

Nachdem du Struktur und Timing validiert hast, ersetze die temporäre URL durch dein echtes Ziel.

​
Implementierungsmodell

Die besten Webhook-Empfänger folgen einem einfachen Muster:
  1. Signatur anhand des Roh-Bodys verifizieren
  2. Schnell bestätigen
  3. Langsame Verarbeitung in eigene Hintergrundjobs auslagern
Wenn du den Empfangsendpunkt selbst entwickelst, lies den Webhook-Implementierungsleitfaden.

​
Ereignisauswahl

Die Ereignisauswahl ist nach Entität gruppiert, sodass du auf verschiedenen Ebenen abonnieren kannst:
  • alle Ereignisse auswählen oder abwählen
  • eine gesamte Entitätsgruppe auswählen oder abwählen
  • einzelne Ereignisse innerhalb einer Gruppe auswählen
Verwende für jedes Ziel einen engen Ereignissatz, damit nachgelagerte Systeme nur die Daten erhalten, die sie benötigen.

​
Webhook-Übersicht

Die Tabelle zeigt die aktuellen Abonnements mit:
  • Name
  • Ziel-URL
  • Status
  • Anzahl abonnierter Ereignisse
  • Agentenbereich
Über die Tabelle kannst du:
  • ein Abonnement bearbeiten
  • ein Abonnement löschen
  • prüfen, ob ein Signing-Secret gesetzt ist
Wenn keine Agenten ausgewählt sind, zeigt die Tabelle das Abonnement als für Alle Agenten gültig an.

​
Sicherheitsempfehlungen

Zustellungen sollten über HTTPS erfolgen, damit Secrets und Ereignisdaten während der Übertragung geschützt sind.
Validiere die Webhook-Signatur und den Zeitstempel bei jeder Anfrage, bevor du dem Payload vertraust.
Bestätige das Ereignis schnell und lagere länger dauernde Arbeiten in eigene Hintergrundjobs aus.
Verwende verschiedene Webhook-Abonnements für CRM-Synchronisierung, Auswertungen oder Benachrichtigungen, damit du Ereignisbereich und Zugangsdaten unabhängig voneinander anpassen kannst.

​
Fehlerbehebung

Überprüfe, ob der Webhook aktiv ist, die Ziel-URL erreichbar ist und der ausgewählte Ereignissatz zur getesteten Aktivität passt.
Stelle sicher, dass dein Endpunkt den Roh-Request-Body und das aktuelle Signing-Secret für die HMAC-Signaturberechnung verwendet.
Bearbeite den Webhook und befülle das Feld Agenten, anstatt es leer zu lassen.

​
Nächste Schritte

Webhook-Ereignisreferenz

Ereignisnamen, Payload-Envelopes, Header und Wiederholungsverhalten prüfen

Webhook-Implementierungsleitfaden

Einen Empfänger erstellen, der schnell, sicher und leicht zu debuggen ist

Integrationstests

Endpunkt und End-to-End-Ereignisverarbeitung validieren

Integrationen

Andere Account-Integrationen im selben Account verbinden

Secrets

Wiederverwendbare Zugangsdaten für unterstützte Konfigurationen verwalten