Zum Hauptinhalt springen
Aktionen

Anrufdaten an Ihr System senden

Senden Sie nach jedem Anruf die Zusammenfassung, das Transkript und die gesammelten Daten an Ihr CRM, Ihren Webhook oder Ihre Datenbank.

API-Aufruf sendet den Anruf nach seinem Ende an Ihr eigenes System — die Zusammenfassung, das Transkript, die Stimmung und alles, was der Agent gesammelt hat. Nutzen Sie es, um einen Lead in Ihrem CRM anzulegen, eine Automatisierung zu starten oder eigene Aufzeichnungen zu führen. Ist Ihr System nicht erreichbar, wird die Anfrage wiederholt, und nichts geht verloren.

Einrichten​

  1. Die Aktion hinzufügen

    Öffnen Sie den Agenten → Aktionen → Tool anlegen → Post call → API-Aufruf.

  2. Auf Ihren Endpunkt richten
    FeldWas Sie eintragen
    Namez. B. Lead-Sync ins CRM
    BedingungWann gesendet wird, z. B. wenn der Anrufer kaufen möchte. Leer: nach jedem Anruf
    API-Endpunkt-URLIhr Endpunkt, z. B. https://hooks.example.com/hanc
    HTTP-MethodePOST für die meisten Systeme; GET, PUT, PATCH, DELETE funktionieren auch
    Header, AbfrageparameterOptional, z. B. ein API-Schlüssel
  3. Die Anfrage gestalten (optional)
    • Body (JSON) — Ihre eigenen Felder. Tippen Sie {{, um eine Anrufvariable einzufügen, z. B. {"lead": "{{firstname}} {{lastname}}", "phone": "{{call_from}}"}.
    • Nur meine Felder senden — lässt die Standard-Anrufdaten weg, für ein System, das nur seine eigene Struktur akzeptiert.
  4. Festlegen, was bei Fehlern passiert
    • Wiederholungen bei Fehlern — die Pausen vor jedem neuen Versuch, wenn Ihr Endpunkt nicht mit 2xx antwortet. Standard: 1 Min., 5 Min., 30 Min., 2 Std., 6 Std., 24 Std., 48 Std.
    • Benachrichtigung bei Fehlern — eine E-Mail nach dem letzten Versuch (Standard), nach jedem fehlgeschlagenen Versuch oder nie. Senden an: leer bedeutet der Kontoinhaber.

Was empfängt mein Endpunkt? im Editor zeigt die genaue Anfrage.

Was Ihr Endpunkt empfängt​

Bei POST, PUT und PATCH einen JSON-Body — Ihre Felder zusammengeführt mit den Feldern des Anrufs:

{
  "id": "6ac7ea6eca60c6024b465c70",
  "agent_id": "6ac2a93e36bad261cf088684",
  "call_from": "+431234567890",
  "call_to": "+439876543210",
  "direction": "inbound",
  "call_type": "phone",
  "call_status": "success",
  "start_timestamp": 1730000000000,
  "end_timestamp": 1730000187000,
  "duration": 187000,
  "transcription": [
    { "speaker": "agent", "content": "Hello…", "timestamp": 1730000001000 },
    { "speaker": "user", "content": "Hi…", "timestamp": 1730000003000 }
  ],
  "call_summary": "Customer asked about pricing…",
  "task_achieved": true,
  "sentiment": { "sentiment": "positive", "explanation": "…" },
  "custom_analysis_data": { "name": "John", "email": "john@example.com" },
  "collected_data": {},
  "transfer_history": [],
  "recording_url": "https://…",
  "disconnection_reason": "user_hangup",
  "is_anonymous": false,
  "is_simulation": false,
  "created_at": 1730000000000,
  "updated_at": 1730000187000
}

Bei GET und DELETE kommen dieselben Felder in den Query-String, ohne die verschachtelten (Transkript, Stimmung, gesammelte Daten).

Jede Anfrage enthält X-Hanc-Delivery-Id — bei allen Versuchen einer Zustellung gleich, sodass Sie Duplikate überspringen können — sowie X-Hanc-Attempt mit der Nummer des Versuchs. Jeder Versuch läuft nach 30 Sekunden ab. Alle Versuche sind unter CRM → Kommunikation aufgeführt, wo sich eine fehlgeschlagene Zustellung erneut senden lässt. Details: Webhooks & Zustellung.

Anwendungsfälle​

  • Einen Lead oder ein Ticket in Ihrem CRM anlegen.
  • Eine No-Code-Automatisierung mit den Daten des Anrufs starten.
  • Ein eigenes Anrufarchiv führen.
Auf dieser Seite