> ## Documentation Index
> Fetch the complete documentation index at: https://docs.costcare.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# KeyCRM та CostCare AI

> Дізнайтеся, як підключити KeyCRM до CostCare AI, запускати AI-агента після переходу ліда на визначений етап воронки та передавати ліда менеджеру.

# KeyCRM та CostCare AI

Підключіть KeyCRM до CostCare AI, щоб автоматизувати обробку лідів за допомогою AI-агентів і підтримувати вашу воронку в KeyCRM актуальною.

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

<Info>
  CostCare AI слухає webhook-події з KeyCRM і може оновлювати етап картки ліда в KeyCRM, коли AI-агент ескалює ліда на менеджера.
</Info>

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

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

Є два основні сценарії:

<CardGroup cols={2}>
  <Card title="KeyCRM до CostCare AI" icon="webhook">
    Коли лід переходить на визначений етап у KeyCRM, KeyCRM надсилає webhook-сигнал до CostCare AI. Цей сигнал повідомляє AI-агенту, що потрібно почати обробку ліда.
  </Card>

  <Card title="CostCare AI до KeyCRM" icon="diagram-project">
    Коли AI-агент ескалює ліда на реального менеджера, CostCare AI може перенести картку ліда в KeyCRM на окремий етап, наприклад “Робота менеджера”.
  </Card>
</CardGroup>

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

<Steps>
  <Step title="Лід створюється або оновлюється в KeyCRM">
    Лід знаходиться у вашій воронці KeyCRM і містить інформацію, яку команда використовує у процесі продажів.
  </Step>

  <Step title="Лід переходить на етап AI-обробки">
    Менеджер або автоматизація переводить ліда на етап, з якого має початися AI-обробка.
  </Step>

  <Step title="KeyCRM надсилає webhook до CostCare AI">
    KeyCRM надсилає дані ліда та подію зміни етапу на webhook URL, згенерований у CostCare AI.
  </Step>

  <Step title="AI-агент починає обробку">
    CostCare AI отримує webhook-сигнал і запускає AI-агента для цього ліда.
  </Step>

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

  <Step title="Лід переноситься на етап роботи менеджера в KeyCRM">
    Під час ескалації CostCare AI може перенести картку ліда на окремий етап у KeyCRM, наприклад “Робота менеджера”.
  </Step>
</Steps>

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

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

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

<CardGroup cols={2}>
  <Card title="Доступ до CostCare AI" icon="user">
    Вам потрібен доступ до робочого простору CostCare AI та розділу інтеграцій.
  </Card>

  <Card title="Доступ до KeyCRM" icon="key">
    Вам потрібен доступ до акаунта KeyCRM, де зберігаються ліди та налаштовані воронки продажів.
  </Card>

  <Card title="API-ключ KeyCRM" icon="lock">
    Вам потрібен API-ключ KeyCRM, щоб підключити акаунт до CostCare AI.
  </Card>

  <Card title="Етап для AI-обробки" icon="diagram-project">
    Визначте, який етап у KeyCRM має запускати AI-агента для обробки ліда.
  </Card>

  <Card title="Етап для роботи менеджера" icon="user-headset">
    Створіть окремий етап у KeyCRM, на який потрібно переносити лідів після ескалації на реального менеджера.
  </Card>
</CardGroup>

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

Перед налаштуванням AI-агента підготуйте потрібні етапи у вашій воронці KeyCRM.

Наприклад, воронка може містити такі етапи:

* **Новий лід** — лід щойно потрапив у воронку.
* **AI-обробка** — етап, який запускає AI-агента в CostCare AI.
* **Робота менеджера** — етап, на який переноситься лід, якщо AI-агент ескалює розмову на реального менеджера.
* **Кваліфікований** — лід успішно кваліфікований.
* **Закрито** — роботу з лідом завершено або лід відхилено.

<Info>
  Ви можете використовувати власні назви етапів. Головне — чітко визначити, який етап запускає AI-обробку, а який використовується для ескалації на менеджера.
</Info>

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

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

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

Оберіть **KeyCRM** зі списку доступних інтеграцій.

Натисніть **Підключити**.

<Frame>
  <img src="https://mintcdn.com/costcare/bMMkRci9_aW6av4A/images/Intergation-KeyCRM_11.png?fit=max&auto=format&n=bMMkRci9_aW6av4A&q=85&s=2d6a3188b3916382d83706646bf605e0" alt="Integration KeyCRM 11" width="12956" height="6600" data-path="images/Intergation-KeyCRM_11.png" />
</Frame>

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

Вставте API-ключ KeyCRM у вікно підключення.

Потім натисніть **Продовжити**.

<Frame>
  <img src="https://mintcdn.com/costcare/kKVe5Hd7SFIeynqU/images/Intergation-KeyCRM_2.png?fit=max&auto=format&n=kKVe5Hd7SFIeynqU&q=85&s=55d0ebdd9bd176a02aeed5650ca507d9" alt="Integration KeyCRM 2" width="3236" height="1780" data-path="images/Intergation-KeyCRM_2.png" />
</Frame>

<Note>
  API-ключ дозволяє CostCare AI підключитися до вашого акаунта KeyCRM, отримувати дані лідів і оновлювати етап картки ліда, якщо це передбачено сценарієм AI-агента.
</Note>

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

Після додавання API-ключа CostCare AI згенерує webhook URL.

Скопіюйте цей webhook URL. Його потрібно буде додати в KeyCRM.

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

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

Вставте webhook URL, скопійований із CostCare AI, у налаштування webhook у KeyCRM.

<Frame>
  <img src="https://mintcdn.com/costcare/bMMkRci9_aW6av4A/images/Intergation-KeyCRM_3.png?fit=max&auto=format&n=bMMkRci9_aW6av4A&q=85&s=f9655ae4888d9d8a3afa41892bcbd91f" alt="Integration KeyCRM 3" width="3242" height="1760" data-path="images/Intergation-KeyCRM_3.png" />
</Frame>

<Info>
  Webhook має бути налаштований на подію зміни етапу, яка означає, що ліда потрібно передати AI-агенту.
</Info>

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

Після додавання webhook у KeyCRM поверніться до CostCare AI та натисніть **Готово**.

Після цього статус інтеграції зміниться на **Підключено**.

<Frame>
  <img src="https://mintcdn.com/costcare/bMMkRci9_aW6av4A/images/Intergation-KeyCRM_4.png?fit=max&auto=format&n=bMMkRci9_aW6av4A&q=85&s=22050b1d08dee7a4e8483d038053940a" alt="Integration KeyCRM 4" width="13096" height="6628" data-path="images/Intergation-KeyCRM_4.png" />
</Frame>

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

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

Ця логіка налаштовується у промпті AI-агента.

Наприклад, ви можете вказати AI-агенту ескалювати ліда, якщо:

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

Коли відбувається ескалація, CostCare AI може перенести картку ліда в KeyCRM на етап, створений для роботи менеджера.

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

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

Ви можете додати таку інструкцію до промпта AI-агента:

<Note>
  Якщо тобі не вистачає інформації, щоб відповісти на запитання клієнта, або якщо клієнт просить зв’язати його з реальним менеджером, ескалюй ліда на менеджера.

  Під час ескалації перенеси ліда на етап “Робота менеджера” в KeyCRM.
</Note>

Використовуйте точну назву етапу з вашої воронки KeyCRM, коли описуєте правило ескалації у промпті AI-агента.

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

Після підключення інтеграції CostCare AI слухає webhook-події з KeyCRM.

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

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

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

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

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

Залежно від налаштувань KeyCRM і webhook, CostCare AI може отримувати:

* дані ліда;
* контактну інформацію;
* інформацію про воронку;
* поточний етап ліда;
* дані про замовлення або заявку;
* кастомні поля, які використовуються у вашому процесі продажів.

<Note>
  Точний набір даних залежить від полів, доступних у KeyCRM, і payload, який передається через webhook.
</Note>

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

<CardGroup cols={2}>
  <Card title="AI стартує з етапу" icon="diagram-project">
    AI-агент починає обробку лише після того, як лід переходить на вибраний етап у KeyCRM.
  </Card>

  <Card title="CostCare AI слухає webhooks" icon="webhook">
    CostCare AI отримує сигнали про зміну етапу з KeyCRM через webhook-події.
  </Card>

  <Card title="Ескалація переносить ліда" icon="user-headset">
    Якщо AI-агент ескалює ліда на реального менеджера, CostCare AI може перенести картку ліда на етап для роботи менеджера в KeyCRM.
  </Card>

  <Card title="Етап потрібно створити заздалегідь" icon="list-check">
    Етап для ескалації на менеджера потрібно створити в KeyCRM до того, як використовувати його у промпті AI-агента.
  </Card>

  <Card title="Логіка агента налаштовується промптом" icon="message-lines">
    Поведінка під час ескалації описується у промпті AI-агента після підключення інтеграції KeyCRM.
  </Card>

  <Card title="Окрема картка чату в KeyCRM не створюється" icon="message-xmark">
    CostCare AI не створює окрему картку в чатах KeyCRM для цієї інтеграції.
  </Card>
</CardGroup>

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

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

<Steps>
  <Step title="Створіть або оберіть тестового ліда в KeyCRM">
    Використайте наявного ліда або створіть нового тестового ліда у вашій воронці KeyCRM.
  </Step>

  <Step title="Перенесіть ліда на етап AI-обробки">
    Перенесіть ліда на етап, який має запускати AI-агента.
  </Step>

  <Step title="Перевірте webhook-подію">
    Переконайтеся, що webhook успішно спрацював у KeyCRM.
  </Step>

  <Step title="Перевірте CostCare AI">
    Переконайтеся, що AI-агент отримав дані ліда та почав обробку.
  </Step>

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

  <Step title="Перевірте етап ліда в KeyCRM">
    Переконайтеся, що картка ліда була перенесена на етап для роботи менеджера, наприклад “Робота менеджера”.
  </Step>
</Steps>

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

Якщо лід не передався до CostCare AI або не був перенесений на потрібний етап, перевірте наступне:

<AccordionGroup>
  <Accordion title="Webhook URL неправильний">
    Переконайтеся, що webhook URL у KeyCRM збігається з URL, згенерованим у CostCare AI.
  </Accordion>

  <Accordion title="API-ключ недійсний або неактивний">
    Перевірте, чи активний API-ключ KeyCRM і чи правильно він скопійований.
  </Accordion>

  <Accordion title="У KeyCRM вибрана неправильна подія">
    Переконайтеся, що webhook спрацьовує на правильну подію зміни етапу ліда.
  </Accordion>

  <Accordion title="Лід перейшов на інший етап">
    AI-агент стартує лише тоді, коли лід переходить на етап, вибраний для AI-обробки.
  </Accordion>

  <Accordion title="Етап для роботи менеджера не існує в KeyCRM">
    Створіть етап для ескалації на менеджера в KeyCRM до того, як налаштовувати AI-агента на перенесення лідів на цей етап.
  </Accordion>

  <Accordion title="Назва етапу в промпті неправильна">
    Переконайтеся, що назва етапу в промпті AI-агента збігається з назвою етапу в KeyCRM.
  </Accordion>

  <Accordion title="У промпті AI-агента немає правила ескалації">
    Додайте чітку інструкцію до промпта AI-агента: коли потрібно ескалювати ліда і який етап KeyCRM використовувати.
  </Accordion>

  <Accordion title="Низький баланс CostCare AI">
    Якщо баланс низький, агенти можуть працювати з перебоями. Поповніть баланс і спробуйте ще раз.
  </Accordion>
</AccordionGroup>

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

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

<Steps>
  <Step title="Відкрийте інтеграції">
    Перейдіть у розділ **Інтеграції** у вашому акаунті CostCare AI.
  </Step>

  <Step title="Оберіть KeyCRM">
    Відкрийте підключену інтеграцію KeyCRM.
  </Step>

  <Step title="Натисніть Відключити">
    Натисніть **Відключити**, щоб припинити отримання даних із KeyCRM.
  </Step>
</Steps>

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

## FAQ

<AccordionGroup>
  <Accordion title="Чи створює CostCare AI картку чату в KeyCRM?">
    Ні. CostCare AI не створює окрему картку в чатах KeyCRM. Інтеграція отримує дані через webhook, коли лід переходить на визначений етап.
  </Accordion>

  <Accordion title="Коли AI-агент починає обробку ліда?">
    AI-агент починає обробку, коли лід переходить на етап KeyCRM, налаштований як тригер для AI-обробки.
  </Accordion>

  <Accordion title="Чи можна вибрати, який етап KeyCRM запускає AI-агента?">
    Так. Ви можете визначити етап у вашій воронці KeyCRM, який має надсилати сигнал до CostCare AI.
  </Accordion>

  <Accordion title="Чи може CostCare AI перенести ліда на інший етап у KeyCRM?">
    Так. Якщо AI-агент ескалює ліда на реального менеджера, CostCare AI може перенести картку ліда на окремий етап для роботи менеджера в KeyCRM.
  </Accordion>

  <Accordion title="Де налаштовується ескалація?">
    Ескалація налаштовується у промпті AI-агента після підключення інтеграції KeyCRM.
  </Accordion>

  <Accordion title="Чи потрібно створити етап для менеджера до налаштування AI-агента?">
    Так. Спочатку створіть етап для ескалації на менеджера в KeyCRM, а потім додайте інструкцію про ескалацію до промпта AI-агента.
  </Accordion>

  <Accordion title="Що робити, якщо лід не передається до CostCare AI?">
    Перевірте API-ключ, webhook URL, налаштування webhook-події, вибраний етап у воронці та баланс CostCare AI.
  </Accordion>

  <Accordion title="Що робити, якщо лід не переноситься на етап менеджера?">
    Перевірте, чи існує етап для менеджера в KeyCRM, чи збігається його назва з промптом AI-агента та чи чітко описане правило ескалації.
  </Accordion>
</AccordionGroup>