Ugrás a fő tartalomhoz
Műveletek

Hívásadatok küldése a saját rendszeredbe

Minden hívás után küldd el az összefoglalót, az átiratot és az összegyűjtött adatokat a CRM-edbe, webhookodra vagy adatbázisodba.

Az API hívás a hívás végeztével elküldi a hívást a saját rendszeredbe — az összefoglalót, az átiratot, a hangulatot és mindent, amit az ügynök összegyűjtött. Használd lead létrehozására a CRM-edben, automatizálás indítására vagy saját nyilvántartás vezetésére. Ha a rendszered nem érhető el, a kérés újrapróbálkozik, így semmi sem vész el.

Beállítás​

  1. Add hozzá a műveletet

    Nyisd meg az ügynököt → Műveletek → Eszköz hozzáadása → Post call → API hívás.

  2. Irányítsd a végpontodra
    MezőMit írj be
    Névpl. CRM lead-szinkron
    FeltételMikor küldje, pl. ha a hívó vásárolni szeretne. Üresen: minden hívás után
    API végpont URLA végpontod, pl. https://hooks.example.com/hanc
    HTTP metódusA legtöbb rendszerhez POST; a GET, PUT, PATCH és DELETE is működik
    Fejlécek, Lekérdezési paraméterekOpcionális, pl. egy API-kulcs
  3. Alakítsd a kérést (opcionális)
    • Törzs (JSON) — a saját mezőid. Írd be a {{ jeleket egy hívásváltozó beszúrásához, pl. {"lead": "{{firstname}} {{lastname}}", "phone": "{{call_from}}"}.
    • Csak a saját mezőim küldése — kihagyja a szokásos hívásadatokat; olyan rendszerhez, amely csak a saját szerkezetét fogadja el.
  4. Döntsd el, mi történjen hiba esetén
    • Újrapróbálkozások hiba esetén — a szünetek minden új próbálkozás előtt, ha a végpontod nem 2xx kóddal válaszol. Alapértelmezés: 1 perc, 5 perc, 30 perc, 2 óra, 6 óra, 24 óra, 48 óra.
    • Értesítés hiba esetén — e-mail az utolsó próbálkozás után (alapértelmezés), minden sikertelen próbálkozás után, vagy soha. Címzett: üresen a fiók tulajdonosa.

A szerkesztőben a Mit kap a végpontom? gomb a pontos kérést mutatja.

Mit kap a végpontod​

POST, PUT és PATCH esetén egy JSON-törzset — a saját mezőidet a hívás mezőivel összefésülve:

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

GET és DELETE esetén ugyanezek a mezők a lekérdezési karakterláncba kerülnek, a beágyazottak nélkül (átirat, hangulat, összegyűjtött adatok).

Minden kérés tartalmazza az X-Hanc-Delivery-Id fejlécet — egy kézbesítés minden próbálkozásánál ugyanaz, így kiszűrheted a duplikátumokat —, valamint az X-Hanc-Attempt fejlécet a próbálkozás sorszámával. Minden próbálkozás 30 másodperc után lejár. Minden próbálkozás megjelenik a CRM → Kommunikáció alatt, ahol egy sikertelen kézbesítés újraküldhető. Részletek: Webhookok és kézbesítés.

Felhasználási példák​

  • Lead vagy jegy létrehozása a CRM-edben.
  • No-code automatizálás indítása a hívás adataival.
  • Saját hívásarchívum vezetése.
Ezen az oldalon