Перейти до основного вмісту

​
KeyCRM та CostCare AI

Підключіть KeyCRM до CostCare AI, щоб автоматизувати обробку лідів за допомогою AI-агентів і підтримувати вашу воронку в KeyCRM актуальною. Завдяки цій інтеграції CostCare AI може отримувати сигнали з KeyCRM, коли лід переходить на визначений етап у воронці. Цей сигнал запускає AI-агента. Якщо AI-агенту потрібна допомога реального менеджера, CostCare AI може перенести картку ліда в KeyCRM на окремий етап для роботи менеджера.
CostCare AI слухає webhook-події з KeyCRM і може оновлювати етап картки ліда в KeyCRM, коли AI-агент ескалює ліда на менеджера.

​
Як працює інтеграція

Інтеграція працює через етапи воронки KeyCRM та webhook-події. Є два основні сценарії:

KeyCRM до CostCare AI

Коли лід переходить на визначений етап у KeyCRM, KeyCRM надсилає webhook-сигнал до CostCare AI. Цей сигнал повідомляє AI-агенту, що потрібно почати обробку ліда.

CostCare AI до KeyCRM

Коли AI-агент ескалює ліда на реального менеджера, CostCare AI може перенести картку ліда в KeyCRM на окремий етап, наприклад “Робота менеджера”.

​
Логіка обробки ліда

1

Лід створюється або оновлюється в KeyCRM

Лід знаходиться у вашій воронці KeyCRM і містить інформацію, яку команда використовує у процесі продажів.
2

Лід переходить на етап AI-обробки

Менеджер або автоматизація переводить ліда на етап, з якого має початися AI-обробка.
3

KeyCRM надсилає webhook до CostCare AI

KeyCRM надсилає дані ліда та подію зміни етапу на webhook URL, згенерований у CostCare AI.
4

AI-агент починає обробку

CostCare AI отримує webhook-сигнал і запускає AI-агента для цього ліда.
5

AI-агент продовжує обробку або ескалює ліда

Якщо AI-агент має достатньо інформації, він продовжує обробку ліда відповідно до налаштованого сценарію. Якщо інформації недостатньо або ситуація потребує участі людини, AI-агент може ескалювати ліда на реального менеджера.
6

Лід переноситься на етап роботи менеджера в KeyCRM

Під час ескалації CostCare AI може перенести картку ліда на окремий етап у KeyCRM, наприклад “Робота менеджера”.
Етап для ескалації на менеджера потрібно створити в KeyCRM до того, як ви налаштуєте AI-агента передавати лідів на цей етап.

​
Перед початком

Перед підключенням KeyCRM до CostCare AI переконайтеся, що у вас є:

Доступ до CostCare AI

Вам потрібен доступ до робочого простору CostCare AI та розділу інтеграцій.

Доступ до KeyCRM

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

API-ключ KeyCRM

Вам потрібен API-ключ KeyCRM, щоб підключити акаунт до CostCare AI.

Етап для AI-обробки

Визначте, який етап у KeyCRM має запускати AI-агента для обробки ліда.

Етап для роботи менеджера

Створіть окремий етап у KeyCRM, на який потрібно переносити лідів після ескалації на реального менеджера.

​
Рекомендоване налаштування воронки KeyCRM

Перед налаштуванням AI-агента підготуйте потрібні етапи у вашій воронці KeyCRM. Наприклад, воронка може містити такі етапи:
  • Новий лід — лід щойно потрапив у воронку.
  • AI-обробка — етап, який запускає AI-агента в CostCare AI.
  • Робота менеджера — етап, на який переноситься лід, якщо AI-агент ескалює розмову на реального менеджера.
  • Кваліфікований — лід успішно кваліфікований.
  • Закрито — роботу з лідом завершено або лід відхилено.
Ви можете використовувати власні назви етапів. Головне — чітко визначити, який етап запускає AI-обробку, а який використовується для ескалації на менеджера.

​
Як підключити KeyCRM до CostCare AI

​
1. Відкрийте інтеграції в CostCare AI

У вашому акаунті CostCare AI перейдіть у розділ Інтеграції. Оберіть KeyCRM зі списку доступних інтеграцій. Натисніть Підключити.
Integration KeyCRM 11

​
2. Додайте API-ключ KeyCRM

Вставте API-ключ KeyCRM у вікно підключення. Потім натисніть Продовжити.
Integration KeyCRM 2
API-ключ дозволяє CostCare AI підключитися до вашого акаунта KeyCRM, отримувати дані лідів і оновлювати етап картки ліда, якщо це передбачено сценарієм AI-агента.

​
3. Скопіюйте webhook URL

Після додавання API-ключа CostCare AI згенерує webhook URL. Скопіюйте цей webhook URL. Його потрібно буде додати в KeyCRM.

​
4. Додайте webhook у KeyCRM

У KeyCRM створіть webhook, який спрацьовує, коли лід переходить на етап, з якого AI-агент має почати обробку. Вставте webhook URL, скопійований із CostCare AI, у налаштування webhook у KeyCRM.
Integration KeyCRM 3
Webhook має бути налаштований на подію зміни етапу, яка означає, що ліда потрібно передати AI-агенту.

​
5. Завершіть підключення

Після додавання webhook у KeyCRM поверніться до CostCare AI та натисніть Готово. Після цього статус інтеграції зміниться на Підключено.
Integration KeyCRM 4

​
Налаштування ескалації AI-агента

Після підключення інтеграції з KeyCRM ви можете налаштувати AI-агента так, щоб він ескалював лідів на реального менеджера. Ця логіка налаштовується у промпті AI-агента. Наприклад, ви можете вказати AI-агенту ескалювати ліда, якщо:
  • клієнт ставить запитання, на яке AI-агент не може відповісти;
  • AI-агенту не вистачає інформації для продовження розмови;
  • клієнт просить зв’язати його з реальною людиною;
  • розмова потребує ручної перевірки;
  • лід готовий до подальшої роботи менеджера.
Коли відбувається ескалація, CostCare AI може перенести картку ліда в KeyCRM на етап, створений для роботи менеджера.
Створіть етап для роботи менеджера в KeyCRM до того, як додасте цю логіку в промпт AI-агента. Якщо такого етапу не існує, лід може не перенестися коректно.

​
Приклад інструкції для промпта AI-агента

Ви можете додати таку інструкцію до промпта AI-агента:
Якщо тобі не вистачає інформації, щоб відповісти на запитання клієнта, або якщо клієнт просить зв’язати його з реальним менеджером, ескалюй ліда на менеджера.Під час ескалації перенеси ліда на етап “Робота менеджера” в KeyCRM.
Використовуйте точну назву етапу з вашої воронки KeyCRM, коли описуєте правило ескалації у промпті AI-агента.

​
Що відбувається після підключення

Після підключення інтеграції CostCare AI слухає webhook-події з KeyCRM. Коли лід переходить на визначений етап AI-обробки, CostCare AI отримує сигнал і запускає AI-агента. Якщо AI-агент успішно продовжує розмову, подальша логіка виконується відповідно до налаштованого сценарію. Якщо AI-агент ескалює ліда на менеджера, CostCare AI оновлює картку ліда в KeyCRM і переносить її на етап для роботи менеджера.
AI-агент не починає автоматично обробляти кожного нового ліда. Він стартує лише тоді, коли лід переходить на етап KeyCRM, налаштований як тригер.

​
Які дані передаються до CostCare AI

Залежно від налаштувань KeyCRM і webhook, CostCare AI може отримувати:
  • дані ліда;
  • контактну інформацію;
  • інформацію про воронку;
  • поточний етап ліда;
  • дані про замовлення або заявку;
  • кастомні поля, які використовуються у вашому процесі продажів.
Точний набір даних залежить від полів, доступних у KeyCRM, і payload, який передається через webhook.

​
Важлива логіка

AI стартує з етапу

AI-агент починає обробку лише після того, як лід переходить на вибраний етап у KeyCRM.

CostCare AI слухає webhooks

CostCare AI отримує сигнали про зміну етапу з KeyCRM через webhook-події.

Ескалація переносить ліда

Якщо AI-агент ескалює ліда на реального менеджера, CostCare AI може перенести картку ліда на етап для роботи менеджера в KeyCRM.

Етап потрібно створити заздалегідь

Етап для ескалації на менеджера потрібно створити в KeyCRM до того, як використовувати його у промпті AI-агента.

Логіка агента налаштовується промптом

Поведінка під час ескалації описується у промпті AI-агента після підключення інтеграції KeyCRM.

Окрема картка чату в KeyCRM не створюється

CostCare AI не створює окрему картку в чатах KeyCRM для цієї інтеграції.

​
Як протестувати інтеграцію

Щоб перевірити, чи інтеграція працює коректно:
1

Створіть або оберіть тестового ліда в KeyCRM

Використайте наявного ліда або створіть нового тестового ліда у вашій воронці KeyCRM.
2

Перенесіть ліда на етап AI-обробки

Перенесіть ліда на етап, який має запускати AI-агента.
3

Перевірте webhook-подію

Переконайтеся, що webhook успішно спрацював у KeyCRM.
4

Перевірте CostCare AI

Переконайтеся, що AI-агент отримав дані ліда та почав обробку.
5

Протестуйте ескалацію

Поставте запитання, яке має запустити ескалацію на менеджера, або змоделюйте ситуацію, коли AI-агенту не вистачає інформації.
6

Перевірте етап ліда в KeyCRM

Переконайтеся, що картка ліда була перенесена на етап для роботи менеджера, наприклад “Робота менеджера”.

​
Вирішення проблем

Якщо лід не передався до CostCare AI або не був перенесений на потрібний етап, перевірте наступне:
Переконайтеся, що webhook URL у KeyCRM збігається з URL, згенерованим у CostCare AI.
Перевірте, чи активний API-ключ KeyCRM і чи правильно він скопійований.
Переконайтеся, що webhook спрацьовує на правильну подію зміни етапу ліда.
AI-агент стартує лише тоді, коли лід переходить на етап, вибраний для AI-обробки.
Створіть етап для ескалації на менеджера в KeyCRM до того, як налаштовувати AI-агента на перенесення лідів на цей етап.
Переконайтеся, що назва етапу в промпті AI-агента збігається з назвою етапу в KeyCRM.
Додайте чітку інструкцію до промпта AI-агента: коли потрібно ескалювати ліда і який етап KeyCRM використовувати.
Якщо баланс низький, агенти можуть працювати з перебоями. Поповніть баланс і спробуйте ще раз.

​
Як відключити KeyCRM

Щоб відключити KeyCRM від CostCare AI:
1

Відкрийте інтеграції

Перейдіть у розділ Інтеграції у вашому акаунті CostCare AI.
2

Оберіть KeyCRM

Відкрийте підключену інтеграцію KeyCRM.
3

Натисніть Відключити

Натисніть Відключити, щоб припинити отримання даних із KeyCRM.
Після відключення CostCare AI більше не отримуватиме webhook-події з KeyCRM і не оновлюватиме етапи лідів у KeyCRM.

​
FAQ

Ні. CostCare AI не створює окрему картку в чатах KeyCRM. Інтеграція отримує дані через webhook, коли лід переходить на визначений етап.
AI-агент починає обробку, коли лід переходить на етап KeyCRM, налаштований як тригер для AI-обробки.
Так. Ви можете визначити етап у вашій воронці KeyCRM, який має надсилати сигнал до CostCare AI.
Так. Якщо AI-агент ескалює ліда на реального менеджера, CostCare AI може перенести картку ліда на окремий етап для роботи менеджера в KeyCRM.
Ескалація налаштовується у промпті AI-агента після підключення інтеграції KeyCRM.
Так. Спочатку створіть етап для ескалації на менеджера в KeyCRM, а потім додайте інструкцію про ескалацію до промпта AI-агента.
Перевірте API-ключ, webhook URL, налаштування webhook-події, вибраний етап у воронці та баланс CostCare AI.
Перевірте, чи існує етап для менеджера в KeyCRM, чи збігається його назва з промптом AI-агента та чи чітко описане правило ескалації.