Замовлення і ліди: KeyCRM
- Що отримаєте:
- агент за номером абонента бачить його замовлення в KeyCRM: статус, товари, суму, доставку й ТТН. Після розмови сам ставить замовленню статус «підтверджено», «відмова» чи «передзвонити» і дописує менеджеру підсумок. Для вхідного звернення без замовлення створює картку у воронці. Наявність товару перевіряє за артикулом.
- Що потрібно заздалегідь:
- акаунт KeyCRM, у якому ви бачите API-ключ (його показують власнику акаунта), права адміністратора проєкту у Voice Agent і кампанія «Голосовий агент».
1. Скопіюйте API-ключ у KeyCRM
У KeyCRM відкрийте «Налаштування» → «Основні» і скопіюйте ключ із рядка «API-ключ». Якщо ключа ще немає, натисніть «Згенерувати API ключ».
2. Підключіть інтеграцію
- 1Ліве меню → «Інтеграції» → «Готові інтеграції» → вкладка «CRM» → картка «KeyCRM» → «Підключити».
- 2Вставте ключ у поле «API-ключ» і натисніть «Зберегти».
- 3Натисніть «Тест підключення». Якщо все правильно, з’явиться «Підключення працює: API-ключ читає статуси ваших замовлень.», а статуси й воронки завантажаться у форму нижче.
3. Зіставте результати дзвінка зі статусами замовлень
У блоці «Замовлення після дзвінка» натисніть «Завантажити статуси з KeyCRM»: поля стануть списками статусів вашого акаунта. До того ID статусів можна вписати вручну.
| Поле | Що задає |
|---|---|
| Дозволити агенту змінювати статуси замовлень | Головний перемикач. Вимкнено: агент лише читає замовлення й залишає коментарі, а мапінг нижче зберігається. Типово увімкнено. |
| Клієнт підтвердив | Статус, який агент ставить, коли клієнт підтвердив замовлення. |
| Клієнт відмовився | Статус для відмови чи скасування. |
| Попросив передзвонити | Статус, коли клієнт просить зателефонувати пізніше. |
| Не відповів | Статус для дзвінка, де клієнт так і не поговорив по суті. Ставиться лише інструментом після дзвінка (див. нижче). |
| Статуси, які агент може змінювати | Замовлення в інших статусах (уже відправлені, оплачені) агент не чіпає. Порожньо — будь-який статус. Зазвичай тут лише «Новий» і «Очікує підтвердження». |
4. Ліди і ліміт запитів
| Поле | Що задає |
|---|---|
| Дозволити агенту створювати ліди | Вимкнено: агент не створює картки у воронці, а обрана воронка зберігається. |
| Воронка для нових лідів | Де агент створює картку для звернення без замовлення. Порожньо — агент не створює лідів. |
| Джерело ліда | Необов’язково. Джерело KeyCRM, яке ставиться новим карткам. |
| Денний ліміт запитів до API | KeyCRM дозволяє 20 запитів на хвилину на ключ, спільно з вашим сайтом і маркетплейсами. Агент використовує не більше 15 на хвилину і не більше цього числа на день (типово 5000). |
Збережіть налаштування.
5. Підключіть до кампанії
- 1
- 2Збережіть кампанію.
| Інструмент | Що робить |
|---|---|
| search_entities_by_phone | Покупець і його останні замовлення за номером абонента: статус, товари, сума, доставка, ТТН. Агент викликає його першим. |
| get_order | Деталі одного замовлення абонента. Коментар менеджера агент бачить як внутрішню примітку й не зачитує клієнту. |
| update_order_status | Ставить замовленню статус за результатом дзвінка: confirmed, declined, callback або no_answer — лише з тих, для яких задано статус. |
| add_order_comment | Дописує менеджеру примітку з датою й позначкою Voice Agent. Наявний коментар зберігається. |
| create_lead, update_lead | Картка у воронці з телефоном абонента, ім’ям, коментарем і товарами за артикулом; зміна її статусу, час передзвону, примітка. |
| list_order_statuses, list_stages | Статуси замовлень і статуси воронки — щоб агент не вигадував ID. |
| check_stock | Чи є товар у наявності за артикулом: назва, ціна і вільний залишок. |
Сценарій 1. Підтвердження нових замовлень
Вихідна кампанія обдзвонює покупців нових замовлень. Завантажте номери CSV-файлом з колонками phone і order_id (можна додати name, total) або через API з customFields. Ці дані агент бачить автоматично в даних клієнта. Приклад інструкції:
Ти дзвониш покупцю, щоб підтвердити замовлення в інтернет-магазині.
1. На початку виклич search_entities_by_phone і знайди замовлення з order_id клієнта.
2. Назви склад замовлення, суму й спосіб доставки. Не зачитуй внутрішній коментар.
3. Клієнт підтвердив → update_order_status з outcome=confirmed і коротким
коментарем (адреса, побажання щодо доставки).
4. Відмовився → запитай причину, update_order_status з outcome=declined
і причиною в коментарі.
5. Просить передзвонити → уточни зручний час, update_order_status
з outcome=callback і часом у коментарі.
Не змінюй статус, поки клієнт не відповів однозначно.Сценарій 2. Відмови і «передзвоніть пізніше»
Та сама кампанія відпрацьовує заперечення: якщо клієнт вагається через товар, агент перевіряє наявність заміни через check_stock і пропонує її. Якщо клієнт усе ж відмовляється, агент ставить «Клієнт відмовився» і пише причину в коментар, щоб менеджер бачив її в замовленні. Приклад доповнення до інструкції:
Якщо клієнт хоче інший розмір чи колір, перевір check_stock за артикулом
з замовлення і назви, що є в наявності. Заміну не оформлюй сам: допиши
побажання через add_order_comment, менеджер перезвонить.
Причину відмови завжди записуй у коментар одним реченням.Сценарій 3. Вхідні дзвінки → ліди
Вхідна кампанія на номері магазину. Якщо у абонента є замовлення, агент відповідає про його статус і ТТН. Якщо замовлення немає, а клієнт цікавиться товаром, агент створює картку у воронці. Приклад інструкції:
Спершу виклич search_entities_by_phone.
- Є замовлення → відповідай про статус, доставку й ТТН.
- Немає замовлення і клієнт хоче купити → уточни ім'я, товар (артикул,
якщо знає) і зручний час для дзвінка менеджера. Створи лід через
create_lead: короткий заголовок, коментар з побажаннями, товари в items.
- Клієнт просить передзвонити в конкретний час → update_lead
з callback_at для щойно створеної картки.Після дзвінка замість агента
Статус можна ставити не під час розмови, а автоматично після неї, за підсумком AI-звіту. Так агент не відволікається на CRM, а статус ставиться навіть тоді, коли клієнт поклав слухавку раніше.
- 1Редактор кампанії → картка «Витягування даних» → «+ Додати поле»: додайте поле order_outcome з описом «confirmed, якщо клієнт підтвердив замовлення; declined, якщо відмовився; callback, якщо просив передзвонити; no_answer, якщо не поговорили по суті» і поле summary для підсумку розмови.
- 2Налаштуйте інструменти KeyCRM з моментом «Після дзвінка» і параметрами-шаблонами. У редакторі кампанії полів для параметрів поки немає, тож це робиться через MCP-сервер Voice Agent (voiceagent_set_campaign_integration_tools) або API.
{ "projectID": 123, "campaignID": 456, "integrationId": "keycrm",
"tools": [ "search_entities_by_phone", "get_order", "check_stock", "add_order_comment",
{ "name": "update_order_status", "usageTiming": "afterCall",
"parameters": { "order_id": "${custom_fields.order_id}",
"outcome": "${report.detailed.order_outcome}",
"comment": "${report.detailed.summary|}" } } ] }Замініть 123 і 456 на ID свого проєкту й кампанії. У tools перелічіть усі інструменти KeyCRM, які мають лишитися в кампанії: ті, яких немає в списку, від’єднуються. Назва без налаштувань (як search_entities_by_phone) лишає інструмент доступним під час розмови. Якщо в номері немає order_id або у звіті немає order_outcome, інструмент не виконується і замовлення не змінюється. Повторний запуск для того самого дзвінка статус і коментар не дублює.
Результати у вебхуку
У шаблоні тіла вебхука кампанії можна передати результати інструментів: {{tools.keycrm_create_lead.lead_id?}} — ID створеної картки, {{tools.keycrm_update_order_status.status_id?}} — поставлений статус. Знак ? означає, що поле буде null, якщо інструмент у розмові не викликався.
Що далі
- Інструкції для агента — де прописати сценарій розмови.
- Номери і тестовий дзвінок — CSV з order_id і перевірка до запуску.
- Вебхуки: результати дзвінків — результати інструментів у вашій системі.
