Zum Hauptinhalt springen
Der Post-Call-Webhook wird automatisch nach Abschluss jedes Anrufs an Ihre angegebene Webhook-URL gesendet. Dieser Webhook enthält Anrufdetails, extrahierte Variablen, Transkript und optional die Aufzeichnungs-URL.

Webhook-Konfiguration

Um Post-Call-Webhooks zu aktivieren:
  1. Konfigurieren Sie die Webhook-URL Ihres Assistenten in den Assistenteneinstellungen
  2. Aktivieren Sie “Post call webhook” in der Assistentenkonfiguration
  3. Definieren Sie Post-Call-Variablen, die die KI extrahieren soll

Anfrage-Format

Der Webhook wird als POST-Anfrage an Ihre konfigurierte URL mit folgender JSON-Payload gesendet:

Payload-Struktur

id
integer
Eindeutiger Bezeichner des Anrufs
customer_phone
string
Telefonnummer des Kunden im E.164-Format (z.B. “+1234567890”) oder null, falls nicht verfügbar
assistant_phone
string
Vom Assistenten verwendete Telefonnummer im E.164-Format oder null, falls nicht verfügbar
duration
integer
Dauer des Anrufs in Sekunden
status
string
Endstatus des Anrufs (z.B. “completed”, “busy”, “failed”)
extracted_variables
object
Von der KI extrahierte Variablen basierend auf Ihrer Post-Call-Schema-Konfiguration
input_variables
object
Variablen, die vor Beginn des Anrufs an den Assistenten übergeben wurden
transcript
string
Vollständiges Transkript der Konversation
recording_url
string
URL zum Herunterladen der Anrufaufzeichnung (nur enthalten, wenn “Include recording in webhook” in den Assistenteneinstellungen aktiviert ist)
created_at
string
ISO 8601-Zeitstempel, wann der Anruf initiiert wurde
finished_at
string
ISO 8601-Zeitstempel, wann der Anruf abgeschlossen wurde (verwendet updated_at aus dem Anrufdatensatz)
lead
object
Lead-Informationen (nur bei Kampagnenanrufen enthalten)
{
  "id": 12345,
  "customer_phone": "+1234567890",
  "assistant_phone": "+1987654321",
  "duration": 125,
  "status": "completed",
  "extracted_variables": {
    "status": true,
    "summary": "Kunde an Produktdemo interessiert",
    "lead_quality": "high",
    "next_action": "schedule_demo"
  },
  "input_variables": {
    "customer_name": "John Doe",
    "product_interest": "Pro Plan"
  },
  "transcript": [
    {
      "text": "Hallo! Hier ist Sarah von Website Excellence Builders. Wie geht es Ihnen heute?",
      "type": "transcript",
      "sender": "bot",
      "timestamp": 1756812511.315143
    },
    {
      "text": "Hallo, mir geht es gut, danke für den Anruf.",
      "type": "transcript",
      "sender": "human",
      "timestamp": 1756812514.104436
    },
    {
      "text": "Ich rufe an, um Ihnen von unseren neuen Produktfunktionen zu erzählen.",
      "type": "transcript",
      "sender": "bot",
      "timestamp": 1756812522.918859
    },
    {
      "text": "Das klingt interessant, erzählen Sie mir mehr.",
      "type": "transcript",
      "sender": "human",
      "timestamp": 1756812525.234567
    }
  ],
  "formatted_transcript": "KI: Hallo! Hier ist Sarah von Website Excellence Builders. Wie geht es Ihnen heute?\nKunde: Hallo, mir geht es gut, danke für den Anruf.\nKI: Ich rufe an, um Ihnen von unseren neuen Produktfunktionen zu erzählen.\nKunde: Das klingt interessant, erzählen Sie mir mehr.",
  "recording_url": "https://ki.web-wb.de/storage/recordings/call-12345.mp4",
  "created_at": "2025-01-15T10:30:00.000000Z",
  "finished_at": "2025-01-15T10:32:05.000000Z",
  "lead": {
    "id": 789,
    "phone_number": "+1234567890",
    "variables": {
      "source": "website",
      "interest_level": "high"
    },
    "status": "contacted",
    "created_at": "2025-01-15T09:00:00.000000Z",
    "updated_at": "2025-01-15T10:32:05.000000Z",
    "campaign": {
      "id": 456,
      "name": "Produktdemo-Kampagne",
      "status": "active",
      "allowed_hours_start_time": "09:00",
      "allowed_hours_end_time": "17:00",
      "allowed_days": ["monday", "tuesday", "wednesday", "thursday", "friday"],
      "max_calls_in_parallel": 5,
      "max_retries": 3,
      "retry_interval": 60,
      "created_at": "2025-01-15T08:00:00.000000Z",
      "updated_at": "2025-01-15T08:00:00.000000Z"
    }
  }
}

Webhook-Einstellungen

Sie können die folgenden Optionen für Ihren Post-Call-Webhook konfigurieren:
  • Send webhook only on completed: Webhook nur für erfolgreich abgeschlossene Anrufe senden
  • Include recording in webhook: Das Feld recording_url in der Payload einschließen
  • Custom variables: Benutzerdefinierte Variablen definieren, die die KI aus der Konversation extrahieren soll

Wichtige Hinweise

  • Die Felder customer_phone und assistant_phone können null sein, wenn die Information nicht verfügbar ist
  • Das Feld recording_url ist nur enthalten, wenn Sie “Include recording in webhook” in Ihren Assistenteneinstellungen aktiviert haben
  • Das Objekt lead ist nur bei Anrufen enthalten, die Teil einer Kampagne sind
  • Das Objekt extracted_variables enthält die Variablen, die Sie in der Post-Call-Schema-Konfiguration Ihres Assistenten definiert haben