Як підключити Binotel до X10CRM: лінії, дзвінки та записи

Підключення API, вибір режиму дзвінків, прив'язка співробітників, вебхук і перевірка роботи на тестовій лінії.

Налаштування Binotel складається з кількох частин: доступ до API, маршрут дзвінка, прив'язка лінії та передача подій у CRM. Ця інструкція допоможе пройти їх послідовно. Якщо ви ще обираєте схему, почніть зі сторінки інтеграції Binotel.

#Що підготувати перед налаштуванням

  • Company ID, API Key та API Secret Binotel для вашої компанії.
  • Номери, на які телефонують клієнти, внутрішні лінії менеджерів і параметри SIP, якщо плануєте дзвінки через телефонію CRM.
  • Проєкти X10CRM, у яких працюватиме підключення, та список користувачів для прив'язки ліній.
  • Адміністративний доступ або право керувати інтеграціями. Узгодьте з командою впровадження налаштування маршрутизації та передачі подій Binotel.

Відкрийте «Інтеграції → Binotel». Адреса сторінки у вашій CRM — /integrations/binotel/. Якщо пункту немає, адміністратор має перевірити версію CRM і права користувача.

#Крок 1. Збережіть підключення до API

  1. У блоці «Підключення до API» введіть Company ID, API Key та API Secret.
  2. У маршрутизації оберіть потрібні проєкти CRM. Для початкової перевірки достатньо узгодженого тестового проєкту.
  3. Увімкніть «Активне підключення» для запуску перевірки та збережіть налаштування.
  4. Натисніть «Перевірити з’єднання». Успішна перевірка оновлює довідник внутрішніх ліній і час останньої перевірки API.

#Крок 2. Оберіть режим вихідних дзвінків

Поле «Режим вихідних дзвінків»Що налаштувати
Через налаштовану телефонію CRMЗалишається чинний спосіб виклику X10CRM. Щоб використовувати Binotel через браузер, команда впровадження реєструє його SIP-лінію в телефонії CRM та призначає номер і маршрути.
Зворотний виклик Binotel на SIP-лініюПрив'яжіть внутрішню лінію до користувача, перевірте проєкт заявки та право менеджера переглядати телефон клієнта.

Збереження Binotel не змінює автоматично вихідний номер у телефонії CRM. Після вибору режиму зробіть тестовий дзвінок і перевірте номер, який бачить одержувач. Для браузерної схеми дивіться також налаштування телефонії.

#Крок 3. Прив'яжіть лінії до менеджерів

  1. Після успішної перевірки API відкрийте «Додати прив’язку».
  2. Оберіть користувача CRM та його внутрішній номер Binotel зі списку.
  3. Збережіть прив'язку й перевірте її в таблиці «Прив’язані лінії».
  4. Повторіть для потрібних співробітників. Якщо внутрішні номери змінилися, оновіть довідник через «Перевірити з’єднання» та відредагуйте прив'язки.

#Крок 4. Перевірте маршрути вхідних

Якщо номер уже приймається через телефонію CRM, він має вести до потрібного оператора або групи за її маршрутами. Поле для окремих вхідних Binotel для такого номера залишають порожнім.

Якщо менеджери відповідають у софтфонах Binotel поза телефонією CRM, заповніть «Вхідні номери Binotel для журналу» номерами компанії через пробіл у міжнародному форматі. У полі «Проєкт для вхідних на софтфони Binotel» оберіть один із проєктів цього підключення.

#Крок 5. Налаштуйте передачу подій Binotel

  1. Після збереження підключення знайдіть блок «Вебхуки Binotel».
  2. Якщо адреси немає, натисніть «Створити адресу вебхука».
  3. Скопіюйте одну адресу з рядка «API CALL SETTINGS / COMPLETED». Передайте її відповідальному за підключення Binotel для налаштування обох типів подій.
  4. Проведіть тестовий дзвінок і перевірте час останнього вебхука та появу виклику в журналі CRM.

Адресу копіюйте з вашої CRM повністю: вона містить секрет підключення. Не публікуйте її в документах або відкритих скриншотах. Якщо адміністратор змінить секрет, адресу потрібно оновити й на стороні Binotel.

#Крок 6. Перевірте роботу під обліковим записом менеджера

  1. Зателефонуйте з тестової заявки. Перевірте потрібну лінію, вихідний номер і звук в обох напрямках.
  2. Зробіть вхідний дзвінок від відомого клієнта та окремо з нового номера. Перевірте маршрут і правильну заявку.
  3. Зробіть пропущений виклик і перевірте його відображення в журналі.
  4. Після завершення розмови перевірте запис дзвінка в історії та відсутність дубля у журналі.
  5. Коли аудіо буде доступне, перевірте прослуховування під дозволеною роллю. Якщо потрібна транскрипція — перевірте її окремо.
  6. Якщо номери клієнтів мають бути приховані, перевірте весь маршрут і робоче місце оператора. Прямий callback без права бачити телефон недоступний.

#Де шукати записи розмов

Дзвінки доступні у журналі й історії заявки. Аудіо із Binotel завантажується у фоні, тому може з'явитися пізніше за сам виклик. Для розмов через телефонію CRM діє її механізм запису. Доступ залежить від прав користувача.

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

#Типові проблеми та перевірки

ПроблемаЩо перевірити
Binotel не підтвердив підключенняCompany ID, API Key, API Secret і доступ до API для вашого кабінету.
У списку немає внутрішньої лініїОновіть довідник кнопкою «Перевірити з’єднання»; перевірте наявність лінії у Binotel.
Callback недоступнийРежим callback, прив'язку лінії, проєкт заявки та право переглядати телефон.
Виклик іде не з того номераМаршрут і вихідний номер у телефонії CRM. Збереження API-ключів їх не змінює.
Дзвінок є в Binotel, але не з'явився у CRMАдресу вебхука, час останньої події, проєкти й номери для обліку. Команда впровадження перевіряє фонову звірку.
У журналі є дзвінок, але немає аудіоДоступність запису в Binotel, завершення фонового завантаження та права користувача.
Дзвінок дублюється або прив'язаний не тудиСхему номерів, проєкт і переадресації. Передайте підтримці час та ідентифікатор тестового виклику.

Для звернення в підтримку підготуйте час виклику, режим роботи, користувача CRM і опис результату. API-ключі, паролі SIP та секретну адресу вебхука не додавайте у звичайне листування.