Überblick
Webhooks ermöglichen es deinem Callin-Agenten, in Echtzeit mit externen Systemen zu interagieren. Das bedeutet, dass dein Agent jedes Mal, wenn er einen Anruf tätigt oder entgegennimmt, automatisch Daten senden oder anfordern kann — über eine einfache HTTP-Anfrage an einen anderen Service. Das ist hilfreich, wenn du möchtest, dass dein Agent Kundendaten abruft, Datensätze in externen Tools erstellt oder Automatisierungen auslöst — alles während eines laufenden Gesprächs. In Callin werden Webhooks als Tools erstellt. Das sind wiederverwendbare Komponenten, die du jedem Sprachagenten zuweisen kannst.Schritt 1: Ein Webhook-Tool erstellen
Zum Start musst du ein neues Tool im Callin-Dashboard erstellen:- Gehe zu Tools in deinem Callin workspace.
- Klicke auf + Add Tool.
- Fülle die folgenden Felder aus:
- Name:
get-customer-data - Description:
Ruft Kundeninformationen anhand der Telefonnummer ab. - Method: Wähle
GET, wenn du Daten abrufst, oderPOST, wenn du sie sendest. - URL: Gib den externen API-Endpoint an, z. B.
https://api.mycompany.com/customers
- Name:
Stelle sicher, dass die URL HTTPS verwendet und öffentlich erreichbar ist. Andernfalls funktioniert der Webhook nicht.
- Klicke auf Save, um das Tool zu erstellen.
Schritt 2: Das Tool einem Sprachagenten zuweisen
Sobald dein Tool erstellt ist, musst du es mit dem Agenten verbinden, der es nutzen soll:- Gehe zu AI Agents.
- Wähle den Agenten aus, den du konfigurieren möchtest.
- Scrolle zum Abschnitt Tools und klicke auf + Add Tool.
- Wähle das Tool aus, das du gerade erstellt hast, und speichere deine Änderungen.
Schritt 3: Deinen Webhook testen
Bevor du ihn in Produktion nutzt, ist es wichtig zu testen, ob dein Webhook korrekt konfiguriert ist. Du kannst Webhook.site verwenden — ein kostenloses Tool, das dir eine temporäre URL gibt, um Testanfragen zu empfangen und die Daten zu prüfen. Hier ist ein Beispiel für ein Payload, das Callin senden könnte: “call_id”: “ab12cd34”, “agent_name”: “Laura AI”, “duration”: 145, “direction”: “outbound”, “caller_number”: “+34123456789”, “summary”: “Der Kunde hat um ein Follow-up gebeten.” Prüfe, ob das Payload ankommt und ob es zu dem passt, was deine externe API erwartet.Schritt 4: Mit anderen Plattformen automatisieren
Sobald dein Webhook funktioniert, kannst du ihn in Automatisierungstools einbinden, zum Beispiel:- Zapier: Automatisierungen in über 3.000 Apps auslösen.
- n8n: Bedingte Flows und fortgeschrittene Workflows visuell erstellen.
- Make.com: Leistungsstarke Szenarien entwerfen, ohne Code zu schreiben.
Häufige Fehler und wie du sie behebst
| Problem | Wahrscheinliche Ursache | Lösung |
|---|---|---|
| Webhook-URL fehlt | URL-Feld ist leer | Füge einen gültigen HTTPS-Endpoint hinzu |
| Tool wird nicht ausgeführt | Nicht dem Agenten zugewiesen | Gehe zu agent > Tools tab > Tool erneut zuweisen |
| Keine Daten empfangen | API ist nicht erreichbar | Teste die URL mit Webhook.site |
| Timeout-Fehler | API braucht zu lange | Erhöhe das Webhook-Response-Timeout im Tool |
Abschlusstipp
Webhooks sind eine der leistungsstärksten Möglichkeiten, um zu erweitern, was dein Callin-Agent leisten kann. Starte mit etwas Einfachem:Richte einen
GET-Webhook ein, um Kundendaten anhand der Telefonnummer abzurufen. Wenn das funktioniert, gehe zu fortgeschrittenen Flows mit Zapier, n8n oder Make.com über.
Durch die Kombination von Echtzeit-Sprachautomatisierung und Automatisierung kann dein KI-Agent nicht nur sprechen — er kann Daten abrufen, Aktionen auslösen und Ergebnisse über all deine Tools hinweg vorantreiben.