---
title: Як підключити KeyCRM
description: "Посилання на оплату саме зʼявляється в замовленні KeyCRM: як створити в KeyCRM поле для посилання й API-ключ, як пройти майстер «Підключити KeyCRM» на сторінці «Підключення CRM» (ключ, поле, реквізити, призначення платежу з номером замовлення й іменем покупця), як налаштувати тригер «Відправити HTTP запит» на адресу вебхука, що показує журнал подій і кнопка «Повторити», як змінити поле, замінити ключ, створити нову адресу вебхука чи відключити KeyCRM, що означає «Призупинено», і як попроситися в бету SalesDrive і Sitniks."
audience: seller
plans:
  - trial
  - premium
addons: []
availability: beta
verified: 2026-10-27
canonical: https://ibanoplata.com/help/integrations/connect-keycrm.html
---

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

> Доступно на ознайомчому періоді та тарифі Преміум
> Бета: можливість поки доступна не всім користувачам

Після підключення KeyCRM посилання на оплату зʼявляється в замовленні саме: менеджер переводить замовлення в статус, у якому ви просите оплату, KeyCRM повідомляє про це IBAN oplata, і за кілька секунд у полі замовлення лежить готове посилання на суму замовлення. Підключення займає кілька хвилин: у KeyCRM ви створюєте поле й ключ доступу, у кабінеті проходите майстер із чотирьох кроків, а потім додаєте в KeyCRM тригер, який кличе IBAN oplata.

## Коли це потрібно {#when}

- Ви ведете замовлення в KeyCRM і щоразу створюєте посилання на оплату вручну, копіюючи суму й номер замовлення.
- Ви хочете, щоб покупець отримував посилання одразу, як менеджер підтвердив замовлення, без участі людини.

Одне посилання відповідає одному замовленню: якщо сума замовлення в KeyCRM зміниться і замовлення знову перейде в той самий статус, сума посилання оновиться, а адреса лишиться тією самою. Якщо за посиланням уже оплатили, суму не змінюємо.

## Підготувати KeyCRM: поле і ключ {#prepare}

1. У KeyCRM відкрийте **Налаштування → Додатково → Користувацькі поля** і натисніть **Додати поле**.
2. Сутність — «Замовлення», тип поля — «Посилання», назва — будь-яка зручна вам, наприклад «Посилання на оплату IBAN». Збережіть поле.
3. Відкрийте **Налаштування → Основні** і внизу сторінки натисніть **Згенерувати API ключ**. Скопіюйте ключ кнопкою праворуч від поля.

Ключ дає доступ до замовлень, тож не пересилайте його в месенджерах. IBAN oplata зберігає ключ зашифрованим і показує лише 4 останні символи.

## Підключити KeyCRM у кабінеті {#connect}

1. У меню акаунта оберіть **Підключення CRM**. На картці KeyCRM натисніть **Підключити**. Відкриється вікно «Підключити KeyCRM».

   ![Сторінка «Підключення CRM» без підключень: картки KeyCRM, SalesDrive і Sitniks з кнопками «Підключити» і блок «Як це працює»](https://help-media.ibanoplata.com/d8116a788dae5e380bf01bc434a93acf23395d40611becbd3a264d12d7999dc5.png)

2. На кроці «Ключ доступу» вставте ключ у поле **API-ключ** і натисніть **Далі**. Ми перевіримо ключ запитом до KeyCRM і завантажимо список полів замовлення.

   ![Крок 1 з 4 «Ключ доступу»: поле «API-ключ» з підказкою, де взяти ключ у KeyCRM, і блок «Як ми зберігаємо ключ»](https://help-media.ibanoplata.com/9eec621b9afe4b19c70a5e34868a43d931ee8044b06177c4e7c1e6624b326eb6.png)

3. На кроці «Поле в замовленні» оберіть у полі **Поле замовлення для посилання** поле, створене в KeyCRM, і натисніть **Далі**. Немає потрібного поля — створіть його в KeyCRM і натисніть **Оновити список**.

   ![Крок 2 з 4 «Поле в замовленні»: обрано поле «Посилання на оплату IBAN» і посилання «Оновити список»](https://help-media.ibanoplata.com/9406c7acc40b7b2de9e0aae2a2810d5fb43d46bd0b3f3b119179b751c96724e5.png)

4. На кроці «Посилання на оплату» налаштовується посилання, яке ми створюватимемо для кожного замовлення. Оберіть **Реквізити**, на які прийматимете оплату, і перевірте **Призначення платежу**: під полем видно, як його прочитає покупець. Галочки **Додати номер замовлення з KeyCRM** і **Додати імʼя покупця з KeyCRM** додають у текст номер замовлення й імʼя покупця — їх ми підставимо з кожного замовлення.

   ![Крок 3 з 4 «Посилання на оплату»: реквізити, призначення платежу з номером замовлення та іменем покупця, приклад для покупця і дві галочки](https://help-media.ibanoplata.com/3f03480d1238eb6d1166dd1abaa42abb5dde755e18a1486157fef6e3682515d9.png)

5. Натисніть **Зберегти**. Зʼявиться «Налаштування збережено. Залишилось додати вебхук у KeyCRM, щоб посилання на оплату створювалися автоматично.» і адреса вебхука.

   ![Крок 4 з 4 «Вебхук»: «Налаштування збережено.», адреса вебхука з кнопкою копіювання, чотири кроки налаштування тригера в KeyCRM і кнопка «Завершити»](https://help-media.ibanoplata.com/a16b3884bbb856cec94464741f763878a433d75430f9db53c790fb2d1d88b05c.png)

Термін дії посилань із KeyCRM — той, що вказаний у налаштуваннях кабінету для нових посилань.

## Налаштувати вебхук у KeyCRM {#webhook}

Вебхук — це запит, яким KeyCRM повідомляє IBAN oplata, що замовлення перейшло в потрібний статус. Без нього підключення лишається в стані «Очікуємо перший виклик».

1. Скопіюйте адресу вебхука кнопкою копіювання поруч із нею — на останньому кроці майстра або в рядку **Адреса вебхука** на картці підключення. Зʼявиться повідомлення «Адресу вебхука скопійовано».

   ![Картка KeyCRM у стані «Очікуємо перший виклик»: поле, реквізити, призначення платежу, адреса вебхука з кнопкою копіювання й порожній журнал з кнопкою «Налаштувати вебхук»](https://help-media.ibanoplata.com/bd15ac7c6e4573566af054fb0863bc8a1ab013b54c8425417ee2f3d7fafd372c.png)

2. У KeyCRM відкрийте **Налаштування → Додатково → Автоматизація** і натисніть **Додати тригер**.
3. Подія — «Замовлення / Зміна статусу замовлення», значення — статус, у якому ви просите оплату. З коробки це «Очікування передоплати».
4. Додайте умову «Статус замовлення → Включає → Очікування передоплати» — без умови KeyCRM тригер не збереже.
5. Дія — **Відправити HTTP запит**: метод POST, у поле «Посилання» вставте адресу вебхука. Збережіть тригер.
6. Забули кроки — у меню картки підключення оберіть **Як налаштувати вебхук**.

Щоб посилання одразу йшло покупцю, додайте в той самий тригер дію «Написати повідомлення» і вставте в текст назву поля у фігурних дужках — точний текст показує вікно «Як налаштувати вебхук».

## Журнал подій і «Повторити» {#journal}

Під карткою підключення — «Журнал подій»: останні 50 подій за 30 днів. Кожен рядок каже, яке замовлення прийшло, що сталося з посиланням і чи записали ми його в KeyCRM.

- «Записано в KeyCRM» — посилання вже в полі замовлення.
- «Пропущено» — посилання не потрібне: наприклад, сума замовлення 0 ₴ або подія не про зміну статусу.
- «Не записано» або «Помилка» — посилання не потрапило в замовлення; причина написана в рядку.

![Активне підключення KeyCRM і журнал подій: «Створено посилання на 450.00 ₴» і «Сума змінилась» із результатом «Записано в KeyCRM», замовлення на 0 ₴ — «Пропущено»](https://help-media.ibanoplata.com/b933763077f97d0654e5eeff437a961343611563479b17098b7b129ebd67c237.png)

1. Усуньте причину (замініть ключ, оберіть інше поле) і натисніть **Повторити** в рядку події. Ми заново прочитаємо замовлення з KeyCRM — зі свіжою сумою — і запишемо посилання. У журналі зʼявиться новий рядок.

Самі ми події «Не записано» не дописуємо: кожну повторюєте ви, бо частина з них могла вже втратити актуальність.

## Змінити підключення {#manage}

1. **Змінити** над карткою підключення відкриває кроки «Поле в замовленні» і «Посилання на оплату» з поточними значеннями. Натисніть **Зберегти** — зʼявиться «Зміни збережено».
2. У меню картки **Замінити ключ** — вставте новий ключ і натисніть **Зберегти**. Поле, реквізити й адреса вебхука лишаються як були.
3. У меню картки **Створити нову адресу вебхука** — натисніть **Створити**. Поточна адреса перестане працювати одразу, тож вставте нову в дію «Відправити HTTP запит» тригера в KeyCRM.
4. У меню картки **Відключити** — натисніть **Відключити**. Створені посилання й надалі працюватимуть, адреса вебхука перестане приймати виклики, а ключ ми видалимо. Вимкніть тригер у KeyCRM.

## Підключення «Призупинено» {#paused}

Якщо ми не можемо створювати чи записувати посилання, підключення стає «Призупинено», а на пошту приходить один лист. Іконка попередження поруч зі статусом пояснює причину:

![Картка KeyCRM у стані «Призупинено» зі значком причини й кнопкою «Замінити ключ», під нею журнал подій](https://help-media.ibanoplata.com/36f4dd7b29b214b8267ecd031f13fe69e943d1e1841f272b650a5dff0ca3d4c8.png)

- **KeyCRM не приймає ключ** — найчастіше ключ перегенерували в KeyCRM. Натисніть **Замінити ключ** на картці.
- **Поля більше немає в KeyCRM** або **KeyCRM не зберігає посилання в полі** — оберіть інше поле через **Змінити**.
- **Реквізити вимкнено** — оберіть інші реквізити через **Змінити**.
- **Тариф без інтеграції** — налаштування збережено; оберіть тариф з інтеграцією кнопкою **Обрати тариф**, і підключення запрацює саме.

## Якщо тариф не підходить {#plan}

1. На тарифі без інтеграції **Підключити** відкриває вікно «Потрібен тариф «Преміум»». Натисніть **Обрати тариф** — сторінка тарифів відкриється в новій вкладці.

## SalesDrive і Sitniks {#other-crm}

Sitniks підключається так само, своїм майстром: [Як підключити Sitniks](https://ibanoplata.com/help/integrations/connect-sitniks.md). Інтеграція із SalesDrive ще в розробці: **Підключити** на її картці відкриває вікно «Інтеграція ще в розробці».

1. Натисніть **Повідомте мене** — ми напишемо на пошту акаунта, щойно інтеграція запрацює.
2. Або натисніть **Взяти участь у бета-тесті** — ми напишемо, щойно бета-версія буде готова.

## Якщо щось не так {#troubleshooting}

- **Під полем ключа «KeyCRM не прийняв цей ключ».** Ключ скопійовано не повністю або його вже перегенерували. Скопіюйте ключ, який KeyCRM показує зараз, у Налаштування → Основні.
- **«KeyCRM зараз не відповідає».** KeyCRM тимчасово недоступний; спробуйте за кілька хвилин.
- **Стан «Очікуємо перший виклик» не змінюється.** Тригер у KeyCRM не налаштований або налаштований на інший статус. Перевірте кроки розділу «Налаштувати вебхук у KeyCRM» і переведіть тестове замовлення в потрібний статус.
- **«Повторити» показує помилку.** Причину ще не усунено або KeyCRM не відповів; рядок лишається в журналі, повторіть пізніше.
- **Пункту «Підключення CRM» немає в меню.** Інтеграція поки доступна не всім: тарифи, на яких вона працює, вказані над статтею.

## Повʼязані статті {#related}

- [Як підключити Sitniks](https://ibanoplata.com/help/integrations/connect-sitniks.md).
- [Мої посилання: пошук і фільтри](https://ibanoplata.com/help/paylinks/my-paylinks.md).
- [Деталі посилання і його оплати](https://ibanoplata.com/help/paylinks/paylink-details.md).
- [Термін дії посилання](https://ibanoplata.com/help/paylinks/expiration.md).
- [Ознайомчий період і Безкоштовний тариф](https://ibanoplata.com/help/billing/trial-and-free.md).
