Ringostat
Вхід

Замовлення і ліди: KeyCRM

~8 хв · Агент знаходить замовлення абонента в KeyCRM, підтверджує чи скасовує їх, залишає менеджеру коментар і створює ліди з вхідних дзвінків.
Що отримаєте:
агент за номером абонента бачить його замовлення в KeyCRM: статус, товари, суму, доставку й ТТН. Після розмови сам ставить замовленню статус «підтверджено», «відмова» чи «передзвонити» і дописує менеджеру підсумок. Для вхідного звернення без замовлення створює картку у воронці. Наявність товару перевіряє за артикулом.
Що потрібно заздалегідь:
акаунт KeyCRM, у якому ви бачите API-ключ (його показують власнику акаунта), права адміністратора проєкту у Voice Agent і кампанія «Голосовий агент».

1. Скопіюйте API-ключ у KeyCRM

У KeyCRM відкрийте «Налаштування» → «Основні» і скопіюйте ключ із рядка «API-ключ». Якщо ключа ще немає, натисніть «Згенерувати API ключ».

2. Підключіть інтеграцію

  1. 1
    Ліве меню → «Інтеграції» → «Готові інтеграції» → вкладка «CRM» → картка «KeyCRM» → «Підключити».
  2. 2
    Вставте ключ у поле «API-ключ» і натисніть «Зберегти».
  3. 3
    Натисніть «Тест підключення». Якщо все правильно, з’явиться «Підключення працює: API-ключ читає статуси ваших замовлень.», а статуси й воронки завантажаться у форму нижче.
Ключ зберігається зашифрованим і після збереження не показується. Щоб замінити його, введіть новий; порожнє поле залишає збережений. Після нового ключа спершу збережіть його, а потім завантажуйте статуси: списки читаються зі збереженим ключем.

3. Зіставте результати дзвінка зі статусами замовлень

У блоці «Замовлення після дзвінка» натисніть «Завантажити статуси з KeyCRM»: поля стануть списками статусів вашого акаунта. До того ID статусів можна вписати вручну.

Дозволити агенту змінювати статуси замовленьГоловний перемикач. Вимкнено: агент лише читає замовлення й залишає коментарі, а мапінг нижче зберігається. Типово увімкнено.
Клієнт підтвердивСтатус, який агент ставить, коли клієнт підтвердив замовлення.
Клієнт відмовивсяСтатус для відмови чи скасування.
Попросив передзвонитиСтатус, коли клієнт просить зателефонувати пізніше.
Не відповівСтатус для дзвінка, де клієнт так і не поговорив по суті. Ставиться лише інструментом після дзвінка (див. нижче).
Статуси, які агент може змінюватиЗамовлення в інших статусах (уже відправлені, оплачені) агент не чіпає. Порожньо — будь-який статус. Зазвичай тут лише «Новий» і «Очікує підтвердження».
Результат без статусу агенту недоступний: він не змінить замовлення, якщо статус для цього результату не задано. Статуси змінюються в робочій базі магазину, тож перші тестові дзвінки робіть з вимкненим перемикачем або на тестових замовленнях.

4. Ліди і ліміт запитів

Дозволити агенту створювати лідиВимкнено: агент не створює картки у воронці, а обрана воронка зберігається.
Воронка для нових лідівДе агент створює картку для звернення без замовлення. Порожньо — агент не створює лідів.
Джерело лідаНеобов’язково. Джерело KeyCRM, яке ставиться новим карткам.
Денний ліміт запитів до APIKeyCRM дозволяє 20 запитів на хвилину на ключ, спільно з вашим сайтом і маркетплейсами. Агент використовує не більше 15 на хвилину і не більше цього числа на день (типово 5000).

Збережіть налаштування.

5. Підключіть до кампанії

  1. 1
    Редактор кампанії → картка «Інструменти AI» → оберіть KeyCRM: усі інструменти або лише позначені.
    Інструменти AI
    Інструменти AI
  2. 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Чи є товар у наявності за артикулом: назва, ціна і вільний залишок.
Агент працює лише із замовленнями, де номер покупця або отримувача збігається з номером абонента. Чуже замовлення недоступне навіть за точним номером. Шукати картки воронки за телефоном KeyCRM не дозволяє, тому агент змінює лише картку, створену в цьому дзвінку, або ту, ID якої передано в номері як lead_id.

Сценарій 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, менеджер перезвонить.
Причину відмови завжди записуй у коментар одним реченням.
Дзвінки, на які не відповіли взагалі, Voice Agent у KeyCRM не позначає. Їх видно в статистиці кампанії, а у свою систему їх можна передати вебхуком.

Сценарій 3. Вхідні дзвінки → ліди

Вхідна кампанія на номері магазину. Якщо у абонента є замовлення, агент відповідає про його статус і ТТН. Якщо замовлення немає, а клієнт цікавиться товаром, агент створює картку у воронці. Приклад інструкції:

Спершу виклич search_entities_by_phone.
- Є замовлення → відповідай про статус, доставку й ТТН.
- Немає замовлення і клієнт хоче купити → уточни ім'я, товар (артикул,
  якщо знає) і зручний час для дзвінка менеджера. Створи лід через
  create_lead: короткий заголовок, коментар з побажаннями, товари в items.
- Клієнт просить передзвонити в конкретний час → update_lead
  з callback_at для щойно створеної картки.

Після дзвінка замість агента

Статус можна ставити не під час розмови, а автоматично після неї, за підсумком AI-звіту. Так агент не відволікається на CRM, а статус ставиться навіть тоді, коли клієнт поклав слухавку раніше.

  1. 1
    Редактор кампанії → картка «Витягування даних» → «+ Додати поле»: додайте поле order_outcome з описом «confirmed, якщо клієнт підтвердив замовлення; declined, якщо відмовився; callback, якщо просив передзвонити; no_answer, якщо не поговорили по суті» і поле summary для підсумку розмови.
  2. 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, якщо інструмент у розмові не викликався.

Що далі