Әрекеттер мен құралдар

Actions қойындысы — агентіңіз сөйлесуден тыс істей алатын барлық нәрсені басқаратын жер: тікелей сөйлесу барысында агент шақыратын құралдар, қоңырау басталғанға дейін іске қосылатын pre-fetch ілмектері және қоңырау аяқталғаннан кейін іске қосылатын қоңыраудан кейінгі әрекеттер. Шығарып алу айнымалылары (агент әр сөйлесуден шығарып алатын деректер өрістері) сол қойындыда орналасқан.

Барлық жоспарлар

Барлық құралдар, әрекеттер және жаңа pre-fetch ілмегі Free қоса барлық жоспарларда қолжетімді.

Үш фаза

Actions қойындысындағы әр жазба үш өмірлік цикл фазасының біріне жатады. Add Tool ашылмалы тізімі әр нәрсенің қашан іске қосылатынын анық көрсету үшін оларды топтастырады:

Фаза	Қашан	Мысалдар
Pre fetch	Агент сәлемдеспес бұрын	CRM-нен қоңырау шалушыны телефон бойынша іздеу, соңғы тапсырысты алу, backend-тен дербестендірілген сәлемдесу алу
Live call	Сөйлесу кезінде, AI сәт дұрыс болғанда іске қосады	Қоңырауды адамға беру, күнтізбе қолжетімділігін тексеру, басқа агентке беру, сыртқы API-дан деректерді сұрау
Post call	Қоңырау аяқталғаннан кейін	Қорытынды поштасын жіберу, SMS растауын іске қосу, қоңырау деректерін CRM-ге жіберу

Ашылмалы тізім жоғарғы жағында Pre fetch-пен ашылады, өйткені басқа әр фазада көптеген опциялар бар — жаңа pre-fetch жазбасы — сіз іздеп жатқан ең ықтимал нәрсе.

Pre fetch

Pre-fetch ілмектері агентіңізге қоңырауды кім қоңырау шалғанын білген күйде бастауға мүмкіндік береді. Олар қоңырау орнатуымен параллель іске қосылады және алғашқы сөз айтылмас бұрын жауапты агенттің жүйелік промптына енгізеді.

Қашан қолдану керек

Қайта оралатын клиентті телефон нөмірі бойынша тану және оларды атымен сәлемдеу
Қоңырау шалушының ашық тапсырысын, соңғы кездесуін немесе мүшелік деңгейін алу
Қай желіге терілгенге байланысты бизнес контекстін алдын ала жүктеу
Агентке лидтің кезеңі мен тарихын білуі үшін CRM ескертпелерін енгізу

Қалай жұмыс істейді

Платформа қоңырау шалушының телефонын анықтайды (кіріс үшін SIP-тен, шығыс үшін теру мақсатынан).
Әр белсенді Pre fetch әрекеті 1.5 с қатаң сұраныс бойынша тайм-аутымен және 2 с жалпы бюджетімен параллель іске қосылады.
Сәтті жауаптар атымен берілген блоктар ретінде агенттің жүйелік промптына біріктіріледі — агент оларды өзінің алғашқы кезегінде оқиды.
Сәтсіздіктер үнсіз — баяу немесе бұзылған endpoint сәлемдесуді ешқашан бөгемейді. Агент сол блоксыз сөйлей бастайды.

Конфигурация

Өріс	Сипаттама
Name	Міндетті. Ішкі жапсырма және промптағы блок аты — оны қысқа және сипаттамалы ұстаңыз (мысалы, `crm_lookup`, `vip_check`).
API URL	Міндетті. Алынатын endpoint. `{phone}`, `{direction}`, `{agent_id}`, `{user_id}`, `{call_id}` толтырғыштарын қолдайды.
HTTP Method	`GET` — әдепкі және ең қолайлы. `POST` / `PUT` / `PATCH` / `DELETE` де жұмыс істейді.
Headers	Опциялы. Статикалық немесе шаблондалған (толтырғыштар осында да жұмыс істейді).
Query Parameters	Опциялы. Жаңа pre-fetch әрекеттері үшін `phone={phone}` мәнімен алдын ала толтырылады.

Қолжетімді айнымалылар

Бұл токендер сұраныс уақытында URL-ге, тақырыптарға және сұраныс/body параметрлеріне ауыстырылады:

Айнымалы	Дереккөзі	Мысал мәні
`{phone}`	Қоңырау шалушы телефоны (E.164) — шығыс үшін мақсатты нөмір	`+431234567890`
`{direction}`	`inbound` немесе `outbound`	`inbound`
`{agent_id}`	Ішкі агент id	`65f1a2b3c4...`
`{user_id}`	Жұмыс кеңістігі иесінің id	`65e0b1c2d3...`
`{call_id}`	Қоңырау id (backend-ке кейінгі қоңыраудан кейінгі деректерді сәйкестендіруге мүмкіндік береді)	`65f1f2c4d5...`

Белгісіз толтырғыштар сол қалпында қалады — нашар шаблондау қоңырауды ешқашан бұзбайды.

Промптқа не түседі

https://crm.example.com/lookup?phone={phone} мекенжайындағы endpoint-іңіз мынаны қайтарса:

{ "name": "Sarah Johnson", "tier": "Gold", "open_orders": 1 }

Агенттің жүйелік промптына әрекет атымен берілген XML-ге оралған блок қосылады:

<call_context>
  <block name="crm_lookup">
  { "name": "Sarah Johnson", "tier": "Gold", "open_orders": 1 }
  </block>
</call_context>

Агентке оны қалай қолдану керектігін айтудың қажеті жоқ — LLM контекстті табиғи түрде қабылдайды. Опциялы түрде, жүйелік промпта pre-fetch туралы айтыңыз: "Егер <call_context> ішінде клиент аты болса, оны атымен сәлемдеңіз."

Маңызды шектеулер

Тек телефон қоңыраулары. Pre-fetch виджет (веб) қоңыраулары үшін іске қосылмайды — шаблондауға арналған телефон нөмірі жоқ.
Жауап body-сіне 8 КБ шек — ұзынырақ кез келген нәрсе енгізуден бұрын кесіледі. Шек промпт токен бюджетін қорғайды және зиянды endpoint-тің зақым ауқымын шектейді.
condition бағалау жоқ — pre-fetch белсенді болғанда әрқашан іске қосылады. Әлі де бағалауға арналған транскрипция жоқ.

кеңес

Телефонмен индекстелген іздеу endpoint-імен GET қолданыңыз. Жауаптарды кіші және құрылымдалған ұстаңыз (3-5 өрісі бар JSON объектісі). Агентке толық клиент жазбаңыз қажет емес — тек сөйлесуді өзгертетін бөліктер.

Жанды қоңырау құралдары

Бұлар сөйлесу барысында іске қосылады. AI әр құралды оның сипаттамасы мен ағымдағы диалогқа негізделе отырып шақыратын уақытты шешеді.

Қолжетімді құралдар

Құрал	Мақсаты	Қашан қолдану керек
Call Forwarding	Адам операторға беру	Клиент адамды сұрайды, күрделі мәселелер
Google Calendar	Қолжетімділікті тексеру және кездесулерді жоспарлау	Клиент кездесу жоспарлағысы келеді
Outlook Calendar	Сондай, Microsoft Outlook арқылы	Клиент кездесу жоспарлағысы келеді
API Tool RAG	Сыртқы API-дан тікелей деректер алу	Нақты уақыттағы ақпарат қажет (тапсырыстар, қор, тіркелгі күйі)
Agent Transfer	Басқа дауыстық агентке беру	Қоңырау шалушыға басқа бөлім немесе маман керек
HubSpot CRM	HubSpot-та контактілер мен мәмілелерді оқу/жазу	Қоңырауды HubSpot-қа тіркеу, лидті іздеу
MCP servers	Тіркелген MCP серверлеріңіздің кез келгенінен құралдарды ашу	MCP-сәйкес құрал серверін басқарасыз және агенттің оның құралдарын сөйлесу барысында қолданғанын қалайсыз

Call Forwarding

Белгілі бір шарттар орындалғанда қоңырауларды адамға бағыттаңыз.

Параметр	Сипаттама	Мысал
Name	Міндетті. Адам немесе бөлім атауы	`"Sales Manager"`
Forwarding Number	Бағыттауға арналған әдепкі телефон нөмірі	`"+49 123 456 789"`
Trigger Condition	Агент қашан беру керек	`"Customer asks for manager or issue cannot be resolved"`
Conditional Routing Numbers	Бағыттау үшін шарттан нөмірге сәйкестендіру	`{"billing": "+49 111 222", "technical": "+49 333 444"}`

Қалай жұмыс істейді:

Сөйлесу барысында AI Trigger Condition-ды бағалайды.
Шартты бағыттау нөмірлері орнатылса, сәйкес шарт қай нөмірге қоңырау шалу керектігін анықтайды.
Әйтпесе, Forwarding Number қолданылады.
Агент қоңырау шалушыны беру туралы хабардар етеді.
Қоңырау бағытталады — жауап болмаса, ол агентке оралады.

кеңес

Әр түрлі бөлімдер үшін бірнеше Call Forwarding құралдарын қосуға болады — біреуі «Sales» үшін, екіншісі «Technical Support» үшін әр түрлі шарттармен және нөмірлермен.

Google Calendar

Google Calendar-ыңызды қосыңыз — агент қоңыраулар кезінде қолжетімділікті тексеріп, кездесулерді жоспарлай алады.

Баптау:

Integration → Calendars бөліміне өтіп, алдымен Google тіркелгіңізді қосыңыз.
Агенттің Actions қойындысында Google Calendar құралын қосыңыз.
Қолданылатын күнтізбені таңдаңыз.
Қолжетімділік параметрлеріңізді конфигурациялаңыз.

Параметр	Сипаттама	Әдепкі
Calendar	Міндетті. Қай күнтізбені қолдану керек	Сіздің негізгі күнтізбеңіз
Timezone	Кездесулерге арналған уақыт белдеуі (IANA форматы)	Авто-анықталады
Work Start Time	Жұмыс сағаттарының басталуы	9:00
Work End Time	Жұмыс сағаттарының аяқталуы	18:00
Slot Duration	Кездесу ұзақтығы минутпен	30
Working Days	Аптаның қолжетімді күндері	Дүйсенбі–Жұма
Buffer Between Appointments	Кездесулер арасындағы буфер (0–60 мин)	0

Қолдау көрсетілетін слот ұзақтығы: 15, 30, 45, 60, 75, 90, 105, 120 минут.

кеңес

Жұмыс сағаттарыңыз бен күндеріңізді дәл орнатыңыз — агент тек конфигурацияланған қолжетімділігіңіз шегінде уақыт слоттарын ұсынады.

Outlook Calendar

Қоңыраулар кезінде кездесулерді жоспарлау үшін Outlook Calendar-ыңызды қосыңыз. Google Calendar-мен бірдей жұмыс істейді.

Баптау:

Integration → Calendars бөліміне өтіп, алдымен Outlook тіркелгіңізді қосыңыз.
Агенттің Actions қойындысында Outlook Calendar құралын қосыңыз.
Қолданылатын күнтізбені таңдаңыз.
Қолжетімділік параметрлеріңізді конфигурациялаңыз.

Параметрлер Google Calendar-мен бірдей (уақыт белдеуі, жұмыс сағаттары, слот ұзақтығы, жұмыс күндері, буфер).

Agent Transfer

Қоңырауды тіркелгіңіздегі басқа дауыстық агентке беріңіз. Әр түрлі бөлімдер үшін мамандандырылған агенттер болғанда пайдалы.

Параметр	Сипаттама
Target Agent	Міндетті. Қандай агентке беру керектігін таңдаңыз
Trigger Condition	Қашан беру керек (мысалы, «Қоңырау шалушы техникалық қолдау туралы сұрайды»)

Мысал: Ресепшен агенті қоңырау шалушыларды баға туралы сұраған кезде сату агентіне немесе техникалық мәселелер болғанда қолдау агентіне береді.

HubSpot CRM

Қоңырау барысында HubSpot CRM-нен оқыңыз және оған жазыңыз. Агентке өзара әрекеттесулерді тіркеуге, контактіні телефон бойынша іздеуге немесе сіз API қоңырауларын сценарийлеу қажетсіз мәміле жаңартуларын жіберуге мүмкіндік береді.

Баптау:

Integrations бетіне өтіп, HubSpot тіркелгіңізді қосыңыз.
Агенттің Actions қойындысында HubSpot CRM құралын қосыңыз.
Агентке қандай құбыр мен қасиеттерге тиісуге рұқсат етілетінін таңдаңыз.

Құрал қосылғаннан кейін AI қоңырау шалушыны телефон бойынша HubSpot контактісімен сәйкестендіріп, мәміле кезеңін алып, өрістерді жаңарта алады — бәрі тікелей сөйлесуден.

MCP серверлер

Hanc.AI-ға қосылған кез келген MCP-сәйкес серверден құралдарды ашыңыз. Бір агент бірнеше MCP серверлерден тарта алады; бір MCP серверы бірнеше агентке қызмет көрсете алады.

Баптау:

MCP серверлеріңізді Integration → MCP servers астында бір рет қосыңыз. Толық тіркеу қадамдары үшін арнайы MCP Servers бетін қараңыз.
Бұл агенттің Actions қойындысына MCP servers жазбасын қосыңыз — ол Add Action ашылмалы тізімінде Live call астында топтастырылған.
Бұл агенттің қандай тіркелген қосылымдарға қатынасы болуы керектігін қосыңыз.
Агентке бұл құралдарды қашан қолдану керектігін білуі үшін қысқа «When to use it» нұсқауын қосыңыз.

Агент әр қоңыраудың басында әр қосылған MCP серверден құрал жинағын қайта табады, осылайша сервер жағында жасаған өзгерістерің келесі қоңырауда автоматты түрде пайда болады. Әртүрлі серверлердегі ұқсас атаулы құралдар соқтығыспауы үшін құралдар қосылым жапсырмасымен префикс ретінде атаулары өзгертіледі.

API Tool RAG

Қоңыраулар барысында нақты уақыттағы ақпаратты алу үшін сыртқы API-ларға қосылыңыз — тапсырыстарды іздеу, түгендеуді тексеру, тіркелгілерді тексеру немесе API арқылы қолжетімді кез келген деректерге қатынасу.

Параметр	Сипаттама	Мысал
Name	Міндетті. Құрал атауы	`"Order Lookup"`
Description / When to Use	Міндетті. API-ға қашан сұраныс жасау керек	`"Customer asks about order status"`
API URL	Міндетті. API endpoint-і. Body Parameters Schema-дан мәндермен ауыстырылатын `{placeholder}` токендерін қамтуы мүмкін (төменде қараңыз).	`"https://api.yourshop.com/orders/{order_id}"`
HTTP Method	Міндетті. HTTP әдісі	`GET`, `POST`, `PUT`, `DELETE`, `PATCH`
Loading Message	Күтіп тұрғанда агент не айтады	`"Let me check that for you..."`
Timeout	Максималды күту уақыты (мс)	`5000` (әдепкі)
Headers	Әр сұраныспен жіберілетін статикалық HTTP тақырыптары	`{"Authorization": "Bearer KEY"}`
Query Parameters	Әр сұранысқа қосылған статикалық query string параметрлері	`{"apiVersion": "v2"}`
Body Parameters Schema	Міндетті. AI сөйлесуден шығарып алуы және құралға беруі тиіс аргументтерді сипаттайтын JSON Schema. Body Parameters Schema жазу қараңыз.	JSON Schema объектісі

кеңес

Әрқашан Loading Message орнатыңыз — API қоңыраулары кезіндегі үнсіздік қоңырау шалушыға бұзылған сияқты сезіледі.

ескертпе

API Tool RAG-тағы ескі «Run on call start» құсбелгісі арнайы Pre fetch жазбасымен ауыстырылды. Деректерді сөйлесу басталмас бұрын қалағанда Pre fetch қолданыңыз; агент қоңырау барысында алу керек пе екенін шешуі керек болғанда API Tool RAG қолданыңыз.

Body Parameters Schema жазу

Атына қарамастан, Body Parameters Schema — бұл шикі сұраныс body-сі емес. Бұл AI сөйлесуден не шығарып алуы және құралыңызға беруі тиіс екенін сипаттайтын JSON Schema. HTTP әдісі мен URL шаблонына байланысты, бұл мәндер URL-ге, query string-ке немесе JSON body-ге түседі:

HTTP әдісі	Шығарып алынған мәндер қайда барады
URL-да `{name}` бар	Сәйкес мән URL-ге ауыстырылады
`GET`, `DELETE`	Қалған мәндер URL-ге `?key=value` ретінде қосылады
`POST`, `PUT`, `PATCH`	Қалған мәндер JSON body ретінде жіберіледі

Минималды құрылым

{
  "type": "object",
  "properties": {
    "param_name": {
      "type": "string",
      "description": "Бұл мән не және AI оны қалай таңдау керек"
    }
  },
  "required": ["param_name"]
}

Түбірлік type әрқашан "object". properties әр аргументті тізеді. required AI әрқашан беруі тиіс мәндерді белгілейді — клиент әлі айтпаса, AI құралды шақырмас бұрын сұрайды.

Өріс сілтемесі

Өріс	Мақсаты
`type`	Мәннің JSON түрі: `"string"`, `"number"`, `"integer"`, `"boolean"`, `"array"`, `"object"`
`description`	Ең маңыздысы. AI-ға мән нені білдіретінін, қандай форматты қолдану керектігін және қашан беру керектігін айтады. Мүмкіндігінше мысалдар қосыңыз.
`enum`	Мәнді бекітілген тізімнің біріне шектейді. AI табиғи сөйлеуді ең жақын опцияға салыстырады (мысалы, `"the blue one"` → `"blue"`).
`minimum`, `maximum`	Сандық шекаралар. AI ауқымнан тыс мәндерден бас тартады/қысады.
`default`	AI бұл өрісті бермеген кезде қолданылатын мән. Міндетті емес, бірақ имплицитті мәнді құжаттайды.
`format`	Тексеру кеңесі, мысалы, `"email"`, `"date"` (YYYY-MM-DD), `"uri"`.

Мысалдар

Өнім іздеу (тек кілт сөз):

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "Өнім іздеу кілт сөзі — мысалы, \"phone\", \"laptop\", \"Apple\", \"Samsung\""
    }
  },
  "required": ["query"]
}

https://dummyjson.com/products/search?q={query}&limit=5 URL-імен және GET-пен қолданылады: query мәні URL толтырғышына барады. Body-ге ештеңе түспейді.

ID бойынша тапсырыс іздеу:

{
  "type": "object",
  "properties": {
    "order_id": {
      "type": "string",
      "description": "Клиент сұрап жатқан тапсырыс ID, әдетте 6-дан 10 цифрға дейін. Берілмесе, клиенттен сұраңыз."
    }
  },
  "required": ["order_id"]
}

https://api.example.com/orders/{order_id} URL-імен және GET-пен қолданылады.

Бірнеше міндетті өріспен брондау:

{
  "type": "object",
  "properties": {
    "product_id": {
      "type": "string",
      "description": "Алдыңғы search_products шақыруымен қайтарылған өнім ID."
    },
    "quantity": {
      "type": "integer",
      "minimum": 1,
      "maximum": 10,
      "description": "Қанша элементті брондау керек. Әдепкі 1."
    },
    "delivery_method": {
      "type": "string",
      "enum": ["pickup", "home_delivery", "locker"],
      "description": "Клиент элементті қалай алғысы келеді."
    },
    "customer_email": {
      "type": "string",
      "format": "email",
      "description": "Тапсырысты растау үшін клиенттің email-і. Берілмесе, сұраңыз."
    }
  },
  "required": ["product_id", "delivery_method", "customer_email"]
}

POST https://api.example.com/reservations мен қолданылады: төрт мән JSON body-ге барады. AI құралды шақырмас бұрын клиенттен жетіспейтін required өрістерді сұрайды.

Параметрсіз құрал:

{
  "type": "object",
  "properties": {}
}

Endpoint толық статикалық болғанда (мысалы, GET /store/hours) және AI ештеңе беруі қажет болмағанда мұны қолданыңыз.

Дауыстық агенттерге арналған үздік тәжірибелер

Схеманы тегіс ұстаңыз. Кірістірілген объектілер мен массивтер жұмыс істейді, бірақ AI телефонмен сөйлегенде сырғуы мүмкін. Максимум 3-5 жоғары деңгейдегі өрісті таңдаңыз.
Әр өріске description әрқашан жазыңыз. Мысалдарды қосыңыз (мысалы, "phone", "laptop") — мысалдар абстрактілі анықтамаларға қарағанда AI-ды сенімдірек басқарады.
Бекітілген мәндер тізімі болғанда enum қолданыңыз. Бұл AI-дың мәндерді ойдан шығаратын немесе "electronics" орнына "Electronics" жіберетін қаупін жояды.
Өрісті құрал онсыз жұмыс істей алмайтын жағдайда ғана required ретінде белгілеңіз. Қалғаны опциялы, ал клиент айтпаған кезде AI оны өткізіп жібереді — ыңғайсыз қосымша сұрақтар жоқ.
snake_case атауларын қолданыңыз және URL-дегі кез келген {placeholder} токендерімен дәл сәйкестендіріңіз.
description-да жетіспейтін мәндерге арналған әрекетті құжаттаңыз — мысалы, "Бюджет шегі болмаса өткізіп жіберіңіз", "Әдепкі 5".

Қоңыраудан кейінгі әрекеттер

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

Қолжетімді әрекеттер

Әрекет	Мақсаты
Send Email	Командаңызға немесе клиентке құрылымдалған қорытындыны электронды пошта арқылы жіберу
Send SMS	Қоңырау шалушыға мәтіндік растау
Send WhatsApp	WhatsApp хабарламасы немесе шаблоны (24 сағаттық терезеде де, сыртында да жұмыс істейді)
API Call	Толық қоңырау деректерін сыртқы API-ға (CRM, веб-құжат, дерекқорыңыз) жіберу

Send Email

Параметр	Сипаттама
Name	Міндетті. Әрекет идентификаторы
Subject	Міндетті. Электронды пошта тақырыбы
Message Body	Міндетті. Электронды пошта мазмұны — шығарып алу айнымалыларын қамтуы мүмкін
Trigger Condition	Қашан жіберу керек (бос = әрқашан)
Recipients	Міндетті. Электронды поштаны әрқашан алатын электронды пошта мекенжайлары
Conditional Recipients	Шарттан алушыға сәйкестендіру

Электронды поштада айнымалыларды қолдану:

Телефондық қоңыраудан жаңа лид:

Аты: {{customer_name}}
Email: {{customer_email}}
Қызығатыны: {{selected_plan}}
Ескертпелер: {{call_notes}}

Send SMS

Параметр	Сипаттама
Name	Міндетті. Әрекет идентификаторы
Sender Name	Көрсетілетін жіберуші аты
Message	Міндетті. SMS мазмұны (айнымалыларды қамтуы мүмкін)
Trigger Condition	Қашан жіберу керек
Recipients	Міндетті. SMS-ті әрқашан алатын телефон нөмірлері
Conditional Recipients	Шарттан нөмірге сәйкестендіру

Send WhatsApp

HANC-тағы WhatsApp хабарламасы орталық Twilio Content тіркелгісінен алдын ала мақұлданған шаблондарды қолданады — Template SID-ті қолмен қоймайсыз. Әрекет редакторы қазір белсенді және мақұлданған әр шаблонның ашылмалы тізімін көрсетеді, ал сіз біреуін таңдайсыз. Шаблон ішіндегі толтырғыштар ({{1}}, {{2}}, …) кейін редакторда сәйкестендірілген қоңырау айнымалыларынан немесе статикалық мәтіннен ішкі түрде толтырылады.

Параметр	Сипаттама
Name	Міндетті. Әрекет идентификаторы
Trigger Condition	Қашан жіберу керек
Recipients	Міндетті. Хабарламаны әрқашан алатын телефон нөмірлері
Conditional Recipients	Шарттан нөмірге сәйкестендіру
Template	Міндетті. Орталық Twilio Content тіркелгісінен синхрондалған алдын ала мақұлданған WhatsApp шаблондарының ашылмалы таңдағышы. Әр жазба қайсысын таңдау керектігін білу үшін шаблон атауын, тілін және body-нің алдын ала көрінісін көрсетеді.
Template Variables	Таңдалған шаблон үшін редактор әр толтырғышты (`{{1}}`, `{{2}}`, …) тізеді және оны қоңырау айнымалысына (төменде қараңыз) немесе статикалық жолға сәйкестендіруге мүмкіндік береді.

Шаблон толтырғыштарына сәйкестендіруге болатын қолжетімді қоңырау айнымалылары:

Айнымалы	Сипаттама
`{{call_from}}`	Қоңырау шалушының телефон нөмірі
`{{call_to}}`	Қоңырау шалынған нөмір
`{{call_summary}}`	AI жасаған қоңырау қорытындысы
`{{call_sentiment}}`	Көңіл-күй (оң/бейтарап/теріс)
`{{call_task_achieved}}`	Қоңырау тапсырмасы орындалды ма
`{{call_transcription}}`	Толық қоңырау транскрипциясы

Неліктен таңдағыш, еркін мәтін емес

WhatsApp 24 сағаттық клиенттерге қызмет көрсету терезесінен тыс әр бизнес бастаған хабарлама алдын ала мақұлданған шаблонды қолдануды талап етеді. HANC мақұлданған шаблондар тізімін ортақ Twilio Content тіркелгісінен синхрондайды, осылайша ашылмалы тізім қазір жіберуге құқылы дәл нәрсені әрқашан көрсетеді — кездейсоқ жобаны, қабылданбаған шаблонды немесе жоқ SID-ті таңдай алмайсыз. Жаңа шаблонды қосу үшін қолдау қызметіне хабарласыңыз; WhatsApp оны мақұлдағаннан кейін ол ашылмалы тізімде автоматты түрде пайда болады.

API Call

Қоңыраудан кейінгі API Call әрекеті — стек қалғанына жалпы веб-құжатыңыз. Әдісті таңдаңыз, URL-ді орнатыңыз, ал біз толық қоңырау деректерін жібереміз — endpoint-іңіз не болғанын сипаттайтын құрылымдалған JSON объектісін алады.

Параметр	Сипаттама
Name	Міндетті. Әрекет идентификаторы
Trigger Condition	Қашан іске қосу керек (бос = әр қоңырау). LLM транскрипцияға қарсы бағалайды.
API URL	Міндетті. API endpoint URL-і
HTTP Method	Міндетті. `GET`, `POST`, `PUT`, `DELETE`, `PATCH`
Headers	Опциялы сұраныс тақырыптары
Query Parameters	Опциялы query string параметрлері

Endpoint-іңіз не алады

POST / PUT / PATCH үшін endpoint-іңіз сұраныс body-сінде JSON объектісін алады. Сіздің конфигурацияланған body параметрлеріңіз толық қоңырау деректерімен біріктіріледі:

{
  "call_from": "+431234567890",
  "call_to":   "+439876543210",
  "direction": "inbound",
  "call_type": "phone",
  "call_status": "ended",
  "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 string-ке тегістеледі — бірақ transcription, sentiment және custom_analysis_data сияқты кірістірілген мәндер түсіріледі (URL-дер құрылымдалған деректерді қалыпты түрде сақтай алмайды). Транскрипт қажет болса, POST/PUT/PATCH қолданыңыз.

Әр сұраныс сонымен қатар бақылау үшін X-Correlation-Id тақырыбын алады және 30 секундтан кейін тайм-аут жасайды.

Pre-fetch пен Post-call API Call

Pre fetch {phone} т.б. URL/тақырыптар/query/body-ге шаблондайды. Қоңыраудан бұрын промптқа қайтарады.
Post call API Call body-де немесе query-де бүкіл қоңырау деректерін жібереді. URL шаблонсыз — endpoint-іңіз статикалық URL + динамикалық body алады.

Шығарып алу айнымалылары

Шығарып алу айнымалылары — AI сөйлесулерден автоматты түрде шығарып алатын теңшелетін деректер өрістері. Мысалы, агент қоңырау шалушының атын, email-ін, телефон нөмірін немесе анықтаған кез келген басқа ақпаратты жинай алады.

Әдепкі айнымалылар

Әр жаңа агент екі әдепкі шығарып алу айнымалысымен жасалады:

Айнымалы	Түрі	Сипаттама
Email	Email	Қоңырау шалушының email мекенжайы
Phone	Phone	Қоңырау шалушының телефон нөмірі

Бұлар әдепкі бойынша қосылған және қоңырау виджеті формасында көрсетіледі. Оларды өңдеуге немесе жоюға және өзіңіздің теңшелетін айнымалыларыңызды қосуға болады.

Айнымалы түрлері

Түрі	Қолдану жағдайы	Мысал
Text	Атаулар, мекенжайлар, ескертпелер, еркін енгізу	Клиент аты, жеткізу мекенжайы
Number	Сандар, бюджеттер, ID	Тапсырыс саны, бюджет сомасы
Email	Тексерумен email мекенжайлары	Клиент email-і
Phone	Тексерумен телефон нөмірлері	Клиент телефон нөмірі
Selector	Алдын ала анықталған опциялардан таңдау	Қалаулы жоспар (Basic/Pro/Enterprise)
Checkbox	Иә/жоқ келісімі немесе растауы	«Мен маркетингтік email алуға келісемін»

Айнымалыны конфигурациялау

Өріс	Сипаттама	Мысал
Variable Name	Міндетті. Айнымалы идентификаторы	`customer_email`
Instructions for AI	Міндетті. AI үшін бұл мәнді қашан және қалай шығарып алу керектігі туралы нұсқаулар	`"Клиенттің email мекенжайы. Берілмесе, сұраңыз."`
Example Format	(Опциялы) Күтілетін форматтың мысалы	`"john@example.com"`
Options (for Selector)	(Тек Selector) Рұқсат етілген опциялар тізімі	`["Basic", "Pro", "Enterprise"]`
Show in Form	Бұл өрісті қоңырау виджеті формасында көрсету керек пе	Әдепкі бойынша қосылған

Show in Form

Show in Form қосылғанда айнымалы веб-виджетте қоңырау алдында және барысында көрінетін енгізу өрісі ретінде пайда болады. Бұл қоңырау шалушыларға ақпаратын тікелей толтыруға мүмкіндік береді, оған қоса AI оны сөйлесуден шығарып алады.

кеңес

AI сөйлесу барысында жетіспейтін ақпаратты табиғи түрде сұрайды. «Клиенттің email мекенжайы, берілмесе сыпайылықпен сұраңыз» сияқты анық сипаттаманы орнатыңыз, агент оны өңдейді.

Құралдар мен әрекеттерді қосу

Агентіңіздің Actions қойындысына өтіңіз.
Add Tool батырмасын басыңыз.
Ашылмалы тізімнен дұрыс фазаны таңдаңыз — Pre fetch, Live call немесе Post call.
Параметрлерді конфигурациялаңыз.
Сақтаңыз — өзгерістер келесі қоңырауда қолданылады.

Барлық жазбалар Actions кестесінде бірге тізілген. Өңдеу үшін кез келген жолды басыңыз немесе жою үшін қоқыс жәшігі белгішесін қолданыңыз.

Қатысты

Дауыстық агенттерге шолу
Промпт инженериясы — Промптағы құралдарға сілтеме
Білім базасы — Ақпарат көздері
Интеграциялар — Құралдарыңыз сөйлесе алатын сыртқы жүйелер

Үш фаза​

Pre fetch​

Қашан қолдану керек​

Қалай жұмыс істейді​

Конфигурация​

Қолжетімді айнымалылар​

Промптқа не түседі​

Маңызды шектеулер​

Жанды қоңырау құралдары​

Қолжетімді құралдар​

Call Forwarding​

Google Calendar​

Outlook Calendar​

Agent Transfer​

HubSpot CRM​

MCP серверлер​

API Tool RAG​

Body Parameters Schema жазу​

Минималды құрылым​

Өріс сілтемесі​

Мысалдар​

Дауыстық агенттерге арналған үздік тәжірибелер​

Қоңыраудан кейінгі әрекеттер​

Қолжетімді әрекеттер​

Send Email​

Send SMS​

Send WhatsApp​

API Call​

Endpoint-іңіз не алады​

Шығарып алу айнымалылары​

Әдепкі айнымалылар​

Айнымалы түрлері​

Айнымалыны конфигурациялау​

Show in Form​

Құралдар мен әрекеттерді қосу​

Қатысты​

Үш фаза

Pre fetch

Қашан қолдану керек

Қалай жұмыс істейді

Конфигурация

Қолжетімді айнымалылар

Промптқа не түседі

Маңызды шектеулер

Жанды қоңырау құралдары

Қолжетімді құралдар

Call Forwarding

Google Calendar

Outlook Calendar

Agent Transfer

HubSpot CRM

MCP серверлер

API Tool RAG

Body Parameters Schema жазу

Минималды құрылым

Өріс сілтемесі

Мысалдар

Дауыстық агенттерге арналған үздік тәжірибелер

Қоңыраудан кейінгі әрекеттер

Қолжетімді әрекеттер

Send Email

Send SMS

Send WhatsApp

API Call

Endpoint-іңіз не алады

Шығарып алу айнымалылары

Әдепкі айнымалылар

Айнымалы түрлері

Айнымалыны конфигурациялау

Show in Form

Құралдар мен әрекеттерді қосу

Қатысты