Дії та інструменти

Вкладка Actions — це місце, де ви керуєте всім, що ваш агент може робити поза розмовою — інструментами, які агент викликає під час живої розмови, prefetch-хуками, що виконуються перед початком дзвінка, та діями після дзвінка, які спрацьовують після завершення дзвінка. Retrieval Variables (поля даних, які агент витягує з кожної розмови) живуть на тій самій вкладці.

Усі тарифи

Усі інструменти, дії та новий pre-fetch hook доступні на кожному тарифі, включно з Free.

Три фази

Кожен запис на вкладці Actions належить до однієї з трьох фаз життєвого циклу. Випадаючий список Add Tool групує їх так, щоб було ясно, коли кожна річ спрацьовує:

Фаза	Коли	Приклади
Pre fetch	Перед тим, як агент скаже привіт	Шукати того, хто телефонує, у вашій CRM за телефоном, витягти останнє замовлення, отримати персоналізоване привітання з вашого backend
Live call	Під час розмови, запускається AI у потрібний момент	Переадресувати дзвінок людині, перевірити доступність календаря, передати іншому агенту, запитати зовнішній API для даних
Post call	Після завершення дзвінка	Надіслати підсумок email, спрацьовує SMS-підтвердження, передати payload дзвінка вашій CRM

Випадаючий список відкривається з Pre fetch угорі, оскільки кожна інша фаза вже має багато опцій — новий pre-fetch запис — це найімовірніша річ, яку ви шукаєте.

Pre fetch

Pre-fetch хуки дозволяють вашому агенту розпочати дзвінок, вже знаючи, хто телефонує. Вони виконуються паралельно з налаштуванням дзвінка і впроваджують відповідь у системний промпт агента перед першим сказаним словом.

Коли використовувати

Розпізнати постійного клієнта за телефонним номером і привітати його на ім'я
Витягти відкрите замовлення того, хто телефонує, останній прийом або рівень членства
Попередньо завантажити бізнес-контекст, що залежить від того, на яку лінію подзвонили
Впровадити нотатки CRM, щоб агент знав етап ліда та історію

Як це працює

Платформа розпізнає телефон того, хто телефонує (з SIP для вхідних, з цільового номера для вихідних).
Кожна активна дія Pre fetch спрацьовує паралельно з жорстким тайм-аутом 1,5 с на запит та загальним бюджетом 2 с.
Успішні відповіді конкатенуються в системний промпт агента як іменовані блоки — агент читає їх на самому першому ході.
Збої тихі — повільний або зламаний ендпоінт ніколи не блокує привітання. Агент просто починає говорити без цього блоку.

Налаштування

Поле	Опис
Name	Обов'язково. Внутрішня мітка та ім'я блоку в промпті — тримайте її короткою та описовою (наприклад, `crm_lookup`, `vip_check`).
API URL	Обов'язково. Ендпоінт для отримання. Підтримує заповнювачі `{phone}`, `{direction}`, `{agent_id}`, `{user_id}`, `{call_id}`.
HTTP Method	`GET` за замовчуванням і найкраще підходить. `POST` / `PUT` / `PATCH` / `DELETE` також працюють.
Headers	Опціонально. Статичні або з шаблонами (заповнювачі тут також працюють).
Query Parameters	Опціонально. Попередньо заповнюється `phone={phone}` для нових pre-fetch дій.

Доступні змінні

Ці токени підставляються в URL, заголовки та параметри запиту/тіла під час запиту:

Змінна	Джерело	Приклад значення
`{phone}`	Телефон того, хто телефонує (E.164) — для вихідних, номер призначення	`+431234567890`
`{direction}`	`inbound` або `outbound`	`inbound`
`{agent_id}`	Внутрішній ID агента	`65f1a2b3c4...`
`{user_id}`	ID власника робочого простору	`65e0b1c2d3...`
`{call_id}`	ID дзвінка (дозволяє вашому backend корелювати пізніше payload після дзвінка)	`65f1f2c4d5...`

Невідомі заповнювачі залишаються verbatim — погане шаблонування ніколи не крашить дзвінок.

Що потрапляє в промпт

Якщо ваш ендпоінт за https://crm.example.com/lookup?phone={phone} повертає:

{ "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 у своєму системному промпті: "If <call_context> contains a customer name, greet them by name."

Важливі обмеження

Тільки телефонні дзвінки. Pre-fetch не виконується для дзвінків через віджет (web) — немає телефонного номера для шаблонування.
8 KB обмеження на тіло відповіді — все довше обрізається перед впровадженням. Обмеження захищає ваш бюджет токенів промпта та обмежує радіус ураження зловмисного ендпоінта.
Без оцінки condition — pre-fetch завжди спрацьовує, коли активний. Ще немає транскрипції для оцінки.

порада

Використовуйте GET з ендпоінтом пошуку за телефоном. Тримайте відповіді невеликими та структурованими (JSON-об'єкт з 3-5 полями). Агенту не потрібен ваш повний запис клієнта — лише ті частини, що змінюють розмову.

Інструменти живого дзвінка

Вони виконуються під час розмови. AI вирішує, коли викликати кожен інструмент на основі його опису та поточного діалогу.

Доступні інструменти

Інструмент	Призначення	Коли використовувати
Call Forwarding	Передача людині-оператору	Клієнт просить людину, складні проблеми
Google Calendar	Перевірка доступності та бронювання прийомів	Клієнт хоче запланувати зустріч
Outlook Calendar	Те ж саме через Microsoft Outlook	Клієнт хоче запланувати зустріч
API Tool RAG	Отримання живих даних з зовнішнього API	Потрібна інформація в реальному часі (замовлення, склад, стан рахунку)
Agent Transfer	Передача іншому AI голосовому агенту	Тому, хто телефонує, потрібен інший відділ або спеціаліст
HubSpot CRM	Читання/запис контактів і угод у HubSpot	Логування дзвінка в HubSpot, пошук ліда
MCP servers	Надати інструменти з будь-якого з ваших зареєстрованих MCP-серверів	Ви запускаєте MCP-сумісний tool-сервер і хочете, щоб агент використовував його інструменти посеред розмови

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.
Додайте інструмент Google Calendar на вкладці Actions агента.
Виберіть календар для використання.
Налаштуйте свої параметри доступності.

Налаштування	Опис	За замовчуванням
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.
Додайте інструмент Outlook Calendar на вкладці Actions агента.
Виберіть календар для використання.
Налаштуйте свої параметри доступності.

Налаштування ідентичні Google Calendar (часовий пояс, робочі години, тривалість слота, робочі дні, розрив).

Agent Transfer

Передача дзвінка іншому AI голосовому агенту у вашому обліковому записі. Корисно, коли у вас є спеціалізовані агенти для різних відділів.

Налаштування	Опис
Target Agent	Обов'язково. Виберіть, якому агенту передати
Trigger Condition	Коли передавати (наприклад, «Caller asks about technical support»)

Приклад: Агент-ресепшеніст передає тих, хто телефонує, до sales-агента, коли вони запитують про ціни, або до агента підтримки, коли у них технічна проблема.

HubSpot CRM

Читайте та записуйте у свою HubSpot CRM під час дзвінка. Дозволяє агенту логувати взаємодії, шукати контакт за телефоном або надсилати оновлення угод без необхідності писати API-виклики.

Налаштування:

Перейдіть на сторінку Integrations і підключіть свій обліковий запис HubSpot.
Додайте інструмент HubSpot CRM на вкладці Actions агента.
Виберіть, який пайплайн та властивості агенту дозволено торкатися.

Після додавання інструменту AI може зіставити того, хто телефонує, з контактом HubSpot за телефоном, отримати етап угоди та оновити поля — все з живої розмови.

MCP servers

Надайте інструменти з будь-якого MCP-сумісного сервера, який ви підключили до Hanc.AI. Один агент може витягувати з кількох MCP-серверів; один MCP-сервер може обслуговувати кількох агентів.

Налаштування:

Підключіть свій MCP-сервер(и) один раз у Integration → MCP servers. Див. спеціальну сторінку MCP-сервери для повних кроків реєстрації.
Додайте запис MCP servers до вкладки Actions цього агента — він згрупований у Live call у випадаючому списку Add Action.
Увімкніть, до яких із ваших зареєстрованих з'єднань цей агент має мати доступ.
Додайте коротку інструкцію «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. Може містити токени `{placeholder}`, які будуть замінені значеннями з Body Parameters Schema (див. нижче).	`"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	Статичні параметри рядка запиту, додані до кожного запиту	`{"apiVersion": "v2"}`
Body Parameters Schema	Обов'язково. JSON Schema, що описує аргументи, які AI має витягти з розмови і передати інструменту. Див. Написання Body Parameters Schema.	Об'єкт JSON Schema

порада

Завжди встановлюйте Loading Message — тиша під час API-викликів відчувається тому, хто телефонує, як зламана.

примітка

Старий чекбокс «Run on call start» на API Tool RAG було замінено спеціальним записом Pre fetch. Використовуйте Pre fetch, коли хочете отримати дані перед початком розмови; використовуйте API Tool RAG, коли агент має вирішувати під час дзвінка, чи робити запит.

Написання Body Parameters Schema

Незважаючи на назву, Body Parameters Schema — це не сирий request body. Це JSON Schema, що описує, що AI має витягти з розмови і передати вашому інструменту. Залежно від HTTP-методу та URL-шаблону ці значення потрапляють до URL, рядка запиту або JSON-тіла:

HTTP-метод	Куди йдуть витягнуті значення
URL містить `{name}`	Відповідне значення підставляється в URL
`GET`, `DELETE`	Решта значень додається до URL як `?key=value`
`POST`, `PUT`, `PATCH`	Решта значень надсилається як JSON-тіло

Мінімальна структура

{
  "type": "object",
  "properties": {
    "param_name": {
      "type": "string",
      "description": "What this value is and how the AI should pick it"
    }
  },
  "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": "Product search keyword — e.g. \"phone\", \"laptop\", \"Apple\", \"Samsung\""
    }
  },
  "required": ["query"]
}

Використовується з URL https://dummyjson.com/products/search?q={query}&limit=5 та GET: значення query йде в заповнювач URL. Нічого не потрапляє в тіло.

Пошук замовлення за ID:

{
  "type": "object",
  "properties": {
    "order_id": {
      "type": "string",
      "description": "Order ID the customer is asking about, usually 6 to 10 digits. Ask the customer if not provided."
    }
  },
  "required": ["order_id"]
}

Використовується з URL https://api.example.com/orders/{order_id} та GET.

Бронювання з кількома обов'язковими полями:

{
  "type": "object",
  "properties": {
    "product_id": {
      "type": "string",
      "description": "Product ID returned by a previous search_products call."
    },
    "quantity": {
      "type": "integer",
      "minimum": 1,
      "maximum": 10,
      "description": "How many items to reserve. Default 1."
    },
    "delivery_method": {
      "type": "string",
      "enum": ["pickup", "home_delivery", "locker"],
      "description": "How the customer wants to receive the item."
    },
    "customer_email": {
      "type": "string",
      "format": "email",
      "description": "Customer's email for order confirmation. Ask if not provided."
    }
  },
  "required": ["product_id", "delivery_method", "customer_email"]
}

Використовується з POST https://api.example.com/reservations: чотири значення йдуть у JSON-тіло. AI запитає клієнта про відсутні required поля перед викликом інструменту.

Інструмент без параметрів:

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

Використовуйте це, коли ендпоінт повністю статичний (наприклад, GET /store/hours) і AI не потрібно нічого передавати.

Найкращі практики для AI голосових агентів

Тримайте схему плоскою. Вкладені об'єкти та масиви працюють, але AI може спіткнутися, говорячи по телефону. Надавайте перевагу максимум 3–5 полям верхнього рівня.
Завжди пишіть description для кожного поля. Включайте приклади (e.g. "phone", "laptop") — приклади ведуть AI надійніше, ніж абстрактні визначення.
Використовуйте enum, коли маєте фіксований список значень. Це усуває ризик того, що AI вигадає значення або надішле "Electronics" замість "electronics".
Позначайте поле required лише якщо інструмент не може працювати без нього. Усе інше опціональне, і AI пропустить його, коли клієнт не згадав — без незручних додаткових запитань.
Використовуйте імена snake_case і точно зіставляйте будь-які токени {placeholder} в URL.
Документуйте поведінку для відсутніх значень у description — наприклад, "Omit if no budget limit", "Default 5".

Дії після дзвінка

Дії після дзвінка спрацьовують після того, як дзвінок завершився і ланцюг аналізу створив підсумок, тональність та витягнуті змінні. Вони споживають дані дзвінка — вони не розмовляють з клієнтом.

Доступні дії

Дія	Призначення
Send Email	Email структурованого підсумку вашій команді або клієнту
Send SMS	Текстове підтвердження тому, хто телефонував
Send WhatsApp	Повідомлення WhatsApp або шаблон (працює всередині та поза 24-годинним вікном)
API Call	Надсилання повного payload дзвінка зовнішньому API (CRM, webhook, ваш data warehouse)

Send Email

Налаштування	Опис
Name	Обов'язково. Ідентифікатор дії
Subject	Обов'язково. Тема email
Message Body	Обов'язково. Тіло email — може містити змінні збору
Trigger Condition	Коли надсилати (порожньо = завжди)
Recipients	Обов'язково. Email-адреси, що завжди отримують email
Conditional Recipients	Мапінг умова-до-одержувача

Використання змінних в email:

New lead from phone call:

Name: {{customer_name}}
Email: {{customer_email}}
Interested in: {{selected_plan}}
Notes: {{call_notes}}

Send SMS

Налаштування	Опис
Name	Обов'язково. Ідентифікатор дії
Sender Name	Відображуване ім'я відправника
Message	Обов'язково. Вміст SMS (може містити змінні)
Trigger Condition	Коли надсилати
Recipients	Обов'язково. Телефонні номери, що завжди отримують SMS
Conditional Recipients	Мапінг умова-до-номера

Send WhatsApp

WhatsApp-повідомлення на HANC використовують попередньо схвалені шаблони з центрального облікового запису Twilio Content — ви не вставляєте Template SID вручну. Редактор дій показує випадаючий список усіх шаблонів, які зараз активні та схвалені, і ви вибираєте один. Заповнювачі всередині шаблону ({{1}}, {{2}}, …) потім заповнюються inline зі змінних дзвінка або статичного тексту, який ви мапите в редакторі.

Налаштування	Опис
Name	Обов'язково. Ідентифікатор дії
Trigger Condition	Коли надсилати
Recipients	Обов'язково. Телефонні номери, що завжди отримують повідомлення
Conditional Recipients	Мапінг умова-до-номера
Template	Обов'язково. Селектор випадаючого списку попередньо схвалених шаблонів WhatsApp, синхронізованих з центрального облікового запису Twilio Content. Кожен запис показує ім'я шаблону, мову та попередній перегляд тіла, щоб ви знали, який вибрати.
Template Variables	Для вибраного вами шаблону редактор перераховує кожен заповнювач (`{{1}}`, `{{2}}`, …) і дозволяє вам мапити його на змінну дзвінка (див. нижче) або статичний рядок.

Доступні змінні дзвінка, які ви можете мапити в заповнювачі шаблону:

Змінна	Опис
`{{call_from}}`	Телефонний номер того, хто телефонує
`{{call_to}}`	Номер, на який дзвонили
`{{call_summary}}`	Згенерований AI підсумок дзвінка
`{{call_sentiment}}`	Тональність (positive/neutral/negative)
`{{call_task_achieved}}`	Чи було досягнуто завдання дзвінка
`{{call_transcription}}`	Повна транскрипція дзвінка

Чому селектор, а не вільний текст

WhatsApp вимагає, щоб кожне ініційоване бізнесом повідомлення поза 24-годинним вікном сервісу клієнтів використовувало попередньо схвалений шаблон. HANC синхронізує список схвалених шаблонів зі спільного облікового запису Twilio Content, тож випадаючий список завжди показує точно те, що зараз дозволено надсилати — ви не можете випадково вибрати чернетку, відхилений шаблон або SID, який не існує. Щоб додати новий шаблон, зв'яжіться з підтримкою; як тільки його схвалить WhatsApp, він з'явиться у випадаючому списку автоматично.

API Call

Post-call API Call action — це ваш загальний webhook у решту вашого стеку. Виберіть метод, встановіть URL, і ми надішлемо весь payload дзвінка — ваш ендпоінт отримує структурований JSON-об'єкт, що описує те, що сталося.

Налаштування	Опис
Name	Обов'язково. Ідентифікатор дії
Trigger Condition	Коли спрацьовувати (порожньо = кожен дзвінок). Оцінюється LLM проти транскрипції.
API URL	Обов'язково. URL API-ендпоінта
HTTP Method	Обов'язково. `GET`, `POST`, `PUT`, `DELETE`, `PATCH`
Headers	Опціональні заголовки запиту
Query Parameters	Опціональні параметри рядка запиту

Що отримує ваш ендпоінт

Для POST / PUT / PATCH ваш ендпоінт отримує JSON-об'єкт у тілі запиту. Ваші налаштовані body params об'єднуються з повним payload дзвінка:

{
  "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": { /* in-call form submissions */ },
  "transfer_history": [ /* if any agent transfer happened */ ],
  "recording_url": "https://…",
  "disconnection_reason": "user_hangup",
  "is_anonymous": false,
  "is_simulation": false,
  "created_at": 1730000000000,
  "updated_at": 1730000187000
}

Для GET / DELETE ті ж самі поля сплющуються в рядок запиту — але вкладені значення, як-от transcription, sentiment та custom_analysis_data, відкидаються (URL не можуть нести структуровані дані розумно). Використовуйте POST/PUT/PATCH, якщо вам потрібен транскрипт.

Кожен запит також отримує заголовок X-Correlation-Id для трасування і тайм-аутиться через 30 секунд.

Pre-fetch проти Post-call API Call

Pre fetch шаблонує {phone} тощо в URL/headers/query/body. Повертає в промпт, перед дзвінком.
Post call API Call надсилає повний дамп дзвінка у тілі або запиті. Без шаблонування URL — ваш ендпоінт отримує статичний URL + динамічне тіло.

Змінні збору

Retrieval Variables — це користувацькі поля даних, які AI автоматично витягує з розмов. Наприклад, агент може захопити ім'я того, хто телефонує, email, телефонний номер або будь-яку іншу інформацію, яку ви визначите.

Змінні за замовчуванням

Кожен новий агент створюється з двома змінними збору за замовчуванням:

Змінна	Тип	Опис
Email	Email	Email-адреса того, хто телефонує
Phone	Phone	Телефонний номер того, хто телефонує

Вони увімкнені за замовчуванням і показуються у формі call-віджета. Ви можете їх редагувати або видаляти, а також додавати власні користувацькі змінні.

Типи змінних

Тип	Випадок використання	Приклад
Text	Імена, адреси, нотатки, вільне введення	Ім'я клієнта, адреса доставки
Number	Кількості, бюджети, ID	Кількість замовлення, сума бюджету
Email	Email-адреси з валідацією	Email клієнта
Phone	Телефонні номери з валідацією	Телефонний номер клієнта
Selector	Вибір із наперед визначених варіантів	Бажаний тариф (Basic/Pro/Enterprise)
Checkbox	Так/ні згода або підтвердження	«Я погоджуюся отримувати маркетингові email»

Налаштування змінної

Поле	Опис	Приклад
Variable Name	Обов'язково. Ідентифікатор змінної	`customer_email`
Instructions for AI	Обов'язково. Інструкції для AI про те, коли і як витягувати це значення	`"The customer's email address. Ask if not provided."`
Example Format	(Опціонально) Приклад очікуваного формату	`"john@example.com"`
Options (for Selector)	(Лише Selector) Список дозволених опцій	`["Basic", "Pro", "Enterprise"]`
Show in Form	Чи відображати це поле у формі call-віджета	Увімкнено за замовчуванням

Show in Form

Коли Show in Form увімкнено, змінна з'являється як видиме поле введення у web-віджеті до і під час дзвінка. Це дозволяє тим, хто телефонує, заповнити свою інформацію безпосередньо, на додаток до того, як AI витягує її з розмови.

порада

AI природно запитуватиме про відсутню інформацію під час розмови. Встановіть чіткий опис на кшталт «Email-адреса клієнта, ввічливо запитайте, якщо не надано», і агент з цим впорається.

Додавання інструментів і дій

Перейдіть на вкладку Actions вашого агента.
Натисніть Add Tool.
Виберіть правильну фазу з випадаючого списку — Pre fetch, Live call або Post call.
Налаштуйте параметри.
Збережіть — зміни застосовуються на наступному дзвінку.

Усі записи перераховані разом у таблиці Actions. Натисніть будь-який рядок, щоб редагувати, або використайте іконку кошика, щоб видалити.

Пов'язане

Огляд AI голосових агентів
Інженерія промптів — Посилайтеся на інструменти у своєму промпті
База знань — Джерела інформації
Інтеграції — Зовнішні системи, з якими можуть розмовляти ваші інструменти

Три фази​

Pre fetch​

Коли використовувати​

Як це працює​

Налаштування​

Доступні змінні​

Що потрапляє в промпт​

Важливі обмеження​

Інструменти живого дзвінка​

Доступні інструменти​

Call Forwarding​

Google Calendar​

Outlook Calendar​

Agent Transfer​

HubSpot CRM​

MCP servers​

API Tool RAG​

Написання Body Parameters Schema​

Мінімальна структура​

Довідник полів​

Приклади​

Найкращі практики для AI голосових агентів​

Дії після дзвінка​

Доступні дії​

Send Email​

Send SMS​

Send WhatsApp​

API Call​

Що отримує ваш ендпоінт​

Змінні збору​

Змінні за замовчуванням​

Типи змінних​

Налаштування змінної​

Show in Form​

Додавання інструментів і дій​

Пов'язане​

Три фази

Pre fetch

Коли використовувати

Як це працює

Налаштування

Доступні змінні

Що потрапляє в промпт

Важливі обмеження

Інструменти живого дзвінка

Доступні інструменти

Call Forwarding

Google Calendar

Outlook Calendar

Agent Transfer

HubSpot CRM

MCP servers

API Tool RAG

Написання Body Parameters Schema

Мінімальна структура

Довідник полів

Приклади

Найкращі практики для AI голосових агентів

Дії після дзвінка

Доступні дії

Send Email

Send SMS

Send WhatsApp

API Call

Що отримує ваш ендпоінт

Змінні збору

Змінні за замовчуванням

Типи змінних

Налаштування змінної

Show in Form

Додавання інструментів і дій

Пов'язане