# Підключити KeyCRM

Агент знаходить покупця за номером телефону і створює замовлення у Вашій воронці KeyCRM просто під час розмови.

> Full REST + WebSocket API reference: https://api.happ.tools/reference

## Що знадобиться [#що-знадобиться]

* Акаунт KeyCRM на платному тарифі: API відкрито на всіх платних тарифах.
* Воронка і початковий статус, куди падатимуть нові замовлення.
* Агент у Happ, який спілкується з клієнтами.

<Steps>
  <Step>
    ### Отримайте API-ключ у KeyCRM [#отримайте-api-ключ-у-keycrm]

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

        <img alt="Поле API-ключа в налаштуваннях KeyCRM" src="__img0" />
  </Step>

  <Step>
    ### Підключіть KeyCRM у Happ [#підключіть-keycrm-у-happ]

    Відкрийте **Інтеграції**, знайдіть **KeyCRM** і натисніть **Підключити**. Вставте ключ, позначте згоду на синхронізацію даних і натисніть **Підключити**.
  </Step>

  <Step>
    ### Налаштуйте, що агенту дозволено [#налаштуйте-що-агенту-дозволено]

    На картці KeyCRM відкрийте налаштування. **Пошук**: агент шукає покупця за телефоном. **Створення**: оберіть режим (картка воронки або замовлення), воронку, статус і джерело.
  </Step>

  <Step>
    ### Увімкніть дзвінки за подіями CRM (за бажанням) [#увімкніть-дзвінки-за-подіями-crm-за-бажанням]

    У меню картки KeyCRM оберіть **Дзвінки за подіями CRM**. Вставте посилання з Happ у вебхуки KeyCRM і задайте тригер, наприклад «нове замовлення → дзвінок для підтвердження».
  </Step>
</Steps>

## Якщо не працює [#якщо-не-працює]

| Помилка                | Що зробити                                                                                              |
| ---------------------- | ------------------------------------------------------------------------------------------------------- |
| `INVALID_API_KEY`      | Перекопіюйте ключ з KeyCRM без пробілів, переконайтесь, що його згенеровано.                            |
| `TOKEN_REVOKED` (401)  | Ключ перегенерували. Створіть новий і перепідключіть інтеграцію.                                        |
| Замовлення не доходять | Перевірте воронку і статус у налаштуваннях, а також IP-whitelist у KeyCRM: порожній або з адресою Happ. |

## Далі [#далі]

* [KeyCRM](/docs/integrations/crm/keycrm): повний опис полів і відключення.
* [Тест-кейси](/guides/tests): перевірте, що агент створює замовлення правильно, з моками інструментів.