Негізгі мазмұнға өту
Әрекеттер

Қоңырау деректерін жүйеңізге жіберу

Әр қоңыраудан кейін түйінді, транскриптті және жиналған деректерді CRM-ге, вебхукқа немесе дерекқорыңызға жіберіңіз.

API қоңырауы қоңырау аяқталғаннан кейін оны өз жүйеңізге жібереді — түйінді, транскриптті, көңіл-күйді және агент жинаған барлық деректі. Оны CRM-де лид жасау, автоматтандыруды іске қосу немесе өз жазбаларыңызды жүргізу үшін пайдаланыңыз. Жүйеңіз қолжетімсіз болса, сұрау қайталанады және ештеңе жоғалмайды.

Баптау​

  1. Әрекетті қосыңыз

    Агентті ашыңыз → Әрекеттер → Құрал қосу → Post call → API қоңырауы.

  2. Оны эндпоинтіңізге бағыттаңыз
    ӨрісНе енгізу керек
    Атымысалы, CRM лидтерін синхрондау
    ШартҚашан жіберу керек, мысалы, қоңырау шалушы сатып алғысы келсе. Бос болса: әр қоңыраудан кейін
    API соңғы нүктесінің URL-іЭндпоинтіңіз, мысалы https://hooks.example.com/hanc
    HTTP әдісіКөп жүйе үшін POST; GET, PUT, PATCH, DELETE те жұмыс істейді
    Тақырыптар, Query параметрлеріМіндетті емес, мысалы API кілті
  3. Сұраудың пішінін баптаңыз (міндетті емес)
    • Денесі (JSON) — өз өрістеріңіз. Қоңырау айнымалысын қою үшін {{ теріңіз, мысалы {"lead": "{{firstname}} {{lastname}}", "phone": "{{call_from}}"}.
    • Тек менің өрістерімді жіберу — стандартты қоңырау деректерін жібермейді; тек өз құрылымын қабылдайтын жүйе үшін.
  4. Қате кезінде не болатынын шешіңіз
    • Қате кезіндегі қайталаулар — эндпоинтіңіз 2xx кодымен жауап бермесе, әр жаңа әрекет алдындағы үзілістер. Әдепкі: 1 мин, 5 мин, 30 мин, 2 сағ, 6 сағ, 24 сағ, 48 сағ.
    • Сәтсіздік туралы хабарлама — соңғы әрекеттен кейін (әдепкі), әр сәтсіз әрекеттен кейін немесе ешқашан хат жіберіледі. Кімге жіберу: бос болса — аккаунт иесіне.

Редактордағы Менің серверім не алады? батырмасы нақты сұрауды көрсетеді.

Эндпоинтіңіз не алады​

POST, PUT және PATCH үшін JSON денесі — өз өрістеріңіз қоңырау өрістерімен біріктіріледі:

{
  "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 және DELETE үшін сол өрістер query жолына түседі, кірістірілген өрістерсіз (транскрипт, көңіл-күй, жиналған деректер).

Әр сұрауда X-Hanc-Delivery-Id бар — бір жеткізудің барлық әрекеттерінде бірдей, сондықтан қайталанғандарын өткізіп жіберуге болады — және әрекет нөмірі бар X-Hanc-Attempt. Әр әрекет 30 секундтан кейін тоқтатылады. Барлық әрекеттер CRM → Коммуникациялар бөлімінде тізімделеді, онда сәтсіз жеткізуді қайта жіберуге болады. Толығырақ: Вебхуктар және жеткізу.

Қолдану мысалдары​

  • CRM-де лид немесе тикет жасау.
  • Қоңырау деректерімен no-code автоматтандыруды іске қосу.
  • Өз қоңырау мұрағатыңызды жүргізу.
Осы бетте