IBAN oplata Довідка

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

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

Коли це потрібно

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

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

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

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

Підключити KeyCRM у кабінеті

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

    Сторінка «Підключення CRM» без підключень: картки KeyCRM, SalesDrive і Sitniks з кнопками «Підключити» і блок «Як це працює»
    Сторінка «Підключення CRM» без підключень: картки KeyCRM, SalesDrive і Sitniks з кнопками «Підключити» і блок «Як це працює»
  2. На кроці «Ключ доступу» вставте ключ у поле API-ключ і натисніть Далі. Ми перевіримо ключ запитом до KeyCRM і завантажимо список полів замовлення.

    Крок 1 з 4 «Ключ доступу»: поле «API-ключ» з підказкою, де взяти ключ у KeyCRM, і блок «Як ми зберігаємо ключ»
    Крок 1 з 4 «Ключ доступу»: поле «API-ключ» з підказкою, де взяти ключ у KeyCRM, і блок «Як ми зберігаємо ключ»
  3. На кроці «Поле в замовленні» оберіть у полі Поле замовлення для посилання поле, створене в KeyCRM, і натисніть Далі. Немає потрібного поля — створіть його в KeyCRM і натисніть Оновити список.

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

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

    Крок 4 з 4 «Вебхук»: «Налаштування збережено.», адреса вебхука з кнопкою копіювання, чотири кроки налаштування тригера в KeyCRM і кнопка «Завершити»
    Крок 4 з 4 «Вебхук»: «Налаштування збережено.», адреса вебхука з кнопкою копіювання, чотири кроки налаштування тригера в KeyCRM і кнопка «Завершити»

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

Налаштувати вебхук у KeyCRM

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

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

    Картка KeyCRM у стані «Очікуємо перший виклик»: поле, реквізити, призначення платежу, адреса вебхука з кнопкою копіювання й порожній журнал з кнопкою «Налаштувати вебхук»
    Картка KeyCRM у стані «Очікуємо перший виклик»: поле, реквізити, призначення платежу, адреса вебхука з кнопкою копіювання й порожній журнал з кнопкою «Налаштувати вебхук»
  2. У KeyCRM відкрийте Налаштування → Додатково → Автоматизація і натисніть Додати тригер.

  3. Подія — «Замовлення / Зміна статусу замовлення», значення — статус, у якому ви просите оплату. З коробки це «Очікування передоплати».

  4. Додайте умову «Статус замовлення → Включає → Очікування передоплати» — без умови KeyCRM тригер не збереже.

  5. Дія — Відправити HTTP запит: метод POST, у поле «Посилання» вставте адресу вебхука. Збережіть тригер.

  6. Забули кроки — у меню картки підключення оберіть Як налаштувати вебхук.

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

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

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

Активне підключення KeyCRM і журнал подій: «Створено посилання на 450.00 ₴» і «Сума змінилась» із результатом «Записано в KeyCRM», замовлення на 0 ₴ — «Пропущено»
Активне підключення KeyCRM і журнал подій: «Створено посилання на 450.00 ₴» і «Сума змінилась» із результатом «Записано в KeyCRM», замовлення на 0 ₴ — «Пропущено»
  1. Усуньте причину (замініть ключ, оберіть інше поле) і натисніть Повторити в рядку події. Ми заново прочитаємо замовлення з KeyCRM — зі свіжою сумою — і запишемо посилання. У журналі зʼявиться новий рядок.

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

Змінити підключення

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

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

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

Картка KeyCRM у стані «Призупинено» зі значком причини й кнопкою «Замінити ключ», під нею журнал подій
Картка KeyCRM у стані «Призупинено» зі значком причини й кнопкою «Замінити ключ», під нею журнал подій

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

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

SalesDrive і Sitniks

Sitniks підключається так само, своїм майстром: Як підключити Sitniks. Інтеграція із SalesDrive ще в розробці: Підключити на її картці відкриває вікно «Інтеграція ще в розробці».

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

Якщо щось не так