Přeskočit na hlavní obsah
Akce

Odeslání dat o hovoru do vašeho systému

Po každém hovoru odešlete shrnutí, přepis a sesbíraná data do svého CRM, webhooku nebo databáze.

API volání po skončení hovoru odešle hovor do vašeho vlastního systému — shrnutí, přepis, náladu a vše, co agent sesbíral. Použijte ho k vytvoření leadu ve svém CRM, ke spuštění automatizace nebo k vedení vlastních záznamů. Pokud je váš systém nedostupný, požadavek se zopakuje a nic se neztratí.

Nastavení​

  1. Přidejte akci

    Otevřete agenta → Akce → Přidat nástroj → Post call → API volání.

  2. Nasměrujte ji na svůj endpoint
    PoleCo zadat
    Názevnapř. Synchronizace leadů do CRM
    PodmínkaKdy odeslat, např. pokud chce volající nakoupit. Prázdné: po každém hovoru
    URL API endpointuVáš endpoint, např. https://hooks.example.com/hanc
    HTTP metodaPOST pro většinu systémů; fungují i GET, PUT, PATCH, DELETE
    Hlavičky, Query parametryVolitelné, např. API klíč
  3. Upravte podobu požadavku (volitelné)
    • Tělo (JSON) — vaše vlastní pole. Napište {{ a vložte proměnnou hovoru, např. {"lead": "{{firstname}} {{lastname}}", "phone": "{{call_from}}"}.
    • Odesílat jen moje pole — vynechá standardní data o hovoru; pro systém, který přijímá jen vlastní strukturu.
  4. Určete, co se stane při chybě
    • Opakování při chybě — prodlevy před každým dalším pokusem, když váš endpoint neodpoví kódem 2xx. Výchozí: 1 min, 5 min, 30 min, 2 h, 6 h, 24 h, 48 h.
    • Oznámení o selhání — e-mail po posledním pokusu (výchozí), po každém neúspěšném pokusu, nebo nikdy. Odeslat na: prázdné znamená vlastníka účtu.

Tlačítko Co obdrží můj endpoint? v editoru ukáže přesný požadavek.

Co přijme váš endpoint​

U POST, PUT a PATCH tělo JSON — vaše pole sloučená s poli hovoru:

{
  "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
}

U GET a DELETE jdou stejná pole do query stringu, bez vnořených polí (přepis, nálada, sesbíraná data).

Každý požadavek nese X-Hanc-Delivery-Id — stejné u všech pokusů jednoho doručení, takže můžete přeskočit duplicity — a navíc X-Hanc-Attempt s číslem pokusu. Každý pokus vyprší po 30 sekundách. Všechny pokusy jsou uvedené v CRM → Komunikace, kde lze neúspěšné doručení odeslat znovu. Podrobnosti: Webhooky a doručování.

Příklady použití​

  • Vytvoření leadu nebo tiketu ve vašem CRM.
  • Spuštění no-code automatizace s daty z hovoru.
  • Vedení vlastního archivu hovorů.
Na této stránce