Як підключити Binotel до Elbuz: імʼя клієнта на телефоні, дзвінки й записи

10 хв

Звʼязка Binotel CRM в Elbuz забирає дзвінки на себе: менеджер дзвонить клієнту з картки одною кнопкою, а розмови з записами самі лягають у журнал та історію клієнта.

Коли це знадобиться:

  • Менеджер не знає, хто дзвонить — Binotel ще до відповіді показує на телефоні імʼя клієнта з Elbuz і може спрямувати дзвінок його особистому менеджеру.
  • Номер доводиться набирати вручну — кнопка «Подзвонити» в картці: Binotel зʼєднує спершу менеджера, потім клієнта.
  • Пропущені дзвінки губляться — пропущений стає задачею «Перетелефонувати» в «Пульсі».
  • Менеджери не встигають відповісти — за 20 секунд дзвінок переходить на AI-співробітника.

З чого почати: запитайте в підтримки Binotel ключі REST API (що саме просити).

Що вміє Elbuz з Binotel

  • Імʼя клієнта на телефоні менеджера ще до відповіді — і переведення на особистого менеджера (імʼя на телефоні).
  • Дзвінок з картки клієнта одною кнопкою — з вибраного номера лінії (внутрішні номери).
  • Журнал і записи розмов — вхідні й вихідні, ознака «Новий клієнт» (що приходить).
  • Картка вхідного і пропущеного дзвінка — імʼя, останні замовлення, задача «Перетелефонувати» (картка дзвінка).
  • Резюме розмови в історії клієнта — AI-розбір і наступний крок (AI-розбір дзвінків).
  • AI-співробітник на вхідних — відповідає, якщо менеджери не взяли слухавку (голосовий AI).

Де це і хто має доступ

Підключення Binotel живе серед інших інтеграцій, а не в журналі дзвінків. Вікно з рядка оператора називається «Налаштування доступу до API зовнішніх сервісів».

Меню
Кабінет → Налаштування системи → «Інші налаштування» → «Зовнішні сервіси та інтеграції» → «Телефонія» → Binotel
Інші входи
«Журнал дзвінків» → меню-бургер → «Підключення телефонії»
Право доступу
налаштування системи і вікно «Журнал дзвінків»; щоб дзвонити, права не потрібні
Підготувати
ключ і секрет REST API Binotel, внутрішні номери співробітників

Без права на «Журнал дзвінків» не працюють «Перевірити підключення», адреса вебхука й файл налаштування.

Що потрібно від Binotel

Ключі REST API — пару «ключ + секрет» — видає сам Binotel: у матеріалі Binotel про API сказано, що розробник клієнта «отримає від нас ключ». Пункту в кабінеті, де їх можна згенерувати самому, в офіційних матеріалах Binotel немає.

  • Запитайте ключі REST API в підтримки Binotel (support@binotel.ua). Просіть саме REST API: ключі WebSocket у Binotel окремі, виглядають так само, і з ними Elbuz не працюватиме.
  • У тому ж листі пізніше передасте адресу для подій (крок третій) — підтримка налаштує її на своєму боці.
  • Внутрішню лінію співробітника видно в кабінеті My.Business: «Параметри» → вкладка «Співробітники» → колонка «Внутрішня лінія».

Шляхи в кабінеті Binotel взято з офіційної документації оператора. Якщо пункт називається інакше — орієнтуйтеся на ці сторінки або питайте підтримку Binotel:

Як підключити Binotel до Elbuz

Три кроки по черзі: ключі, внутрішні номери і адреса для подій. Без внутрішніх номерів не працює кнопка «Подзвонити». Без адреси для подій журнал наповнюється лише щогодинною звіркою, а імʼя клієнта на телефоні не зʼявляється.

Крок перший: ключі Binotel

Відкрийте рядок Binotel у групі «Телефонія». Перемикач «Активність» уже ввімкнено — залиште його так. Поля, які вписуєте:

Поле у форміЩо вписати
«API-ключ (key)»ключ REST API від Binotel
«Секрет (secret)»секрет REST API тієї ж пари
«Номер лінії для вихідних»ваш номер Binotel, з якого дзвонити клієнту; порожньо — АТС обере сама
Картка «Підключення телефонії» у формі Binotel
1Посилання на інструкцію
2Перемикач «Активність»
3Поле «API-ключ (key)»
4Поле «Секрет (secret)»
5Поле «Номер лінії для вихідних»
6Кнопка «Перевірити підключення»
  1. Посилання «Де саме — покроково в інструкції для вашого оператора» — веде на цю сторінку.
  2. Перемикач «Активність» — інтеграція ввімкнена.
  3. Поле «API-ключ (key)» — ключ REST API від Binotel, не WebSocket.
  4. Поле «Секрет (secret)» — секрет REST API тієї ж пари.
  5. Поле «Номер лінії для вихідних» — з якого номера Binotel дзвонить клієнту.
  6. Кнопка «Перевірити підключення» — читальний запит до оператора, у кабінеті нічого не змінює.

Форма зберігається сама приблизно через секунду після правки: унизу видно «Збереження...», потім «Збережено». Кнопки «Зберегти» немає.

Наприкінці натисніть «Перевірити підключення». Програма відповість «Звʼязок з АТС встановлено. Співробітників в АТС: ‹кількість›». Elbuz читає список співробітників Binotel з іменами, поштою й внутрішніми номерами. Рядок «Номери АТС без співробітника Elbuz» покаже, яким номерам Binotel ще не відповідає жодна картка в Elbuz.

Крок другий: внутрішні номери

Коли менеджер натискає «Подзвонити», Binotel спершу телефонує на його внутрішній номер і лише після відповіді набирає клієнта. Той самий номер привʼязує дзвінки в журналі до менеджера.

Де: картка співробітника («Користувачі (співробітники)») → поле «Телефон внутрішній».

Binotel іноді передає номер разом із маршрутом групи — наприклад, «801 > 205». Elbuz бере останню частину після «>», тобто лінію, на якій справді говорили. У картку вписуйте саме цей кінцевий номер — 205.

Під формою підключення є картка «Внутрішні номери співробітників» — таблиця «Менеджер» / «Внутрішній номер» по всіх активних співробітниках. Рядки з прочерком — ті, кому номер ще не вписали.

Крок третій: адреса для подій Binotel

У формі є картка «Адреса для вебхука АТС» з адресою й кнопкою «Скопіювати». Самостійного пункту для неї в кабінеті Binotel офіційні матеріали не описують: надішліть адресу в підтримку Binotel і попросіть налаштувати на неї дві події — API CALL SETTINGS та API CALL COMPLETED (що вони дають).

Картка «Адреса для вебхука АТС» у формі Binotel
1Адреса для оператора
2Кнопка «Скопіювати»
  1. Адреса, яку передаєте оператору; секретний ключ у кінці на кадрі приховано.
  2. Кнопка «Скопіювати» — кладе адресу в буфер обміну.

У адресі — секретний ключ із 32 знаків і хост, з якого ви відкрили форму. Змінили домен або створили сервіс у списку заново — адреса стала іншою, і її треба передати в Binotel ще раз.

Щоб Binotel запрацював з Elbuz

Що приходить у Elbuz

Усе нижче звірено з модулем інтеграції Binotel в Elbuz.

МожливістьЯк це працює з Binotel
Дзвінок з картки й журналу («Подзвонити»)так: Binotel спершу дзвонить на внутрішній номер менеджера, після відповіді — клієнту. «Номер лінії для вихідних» задає, з якого номера дзвонити
Вхідні й вихідні в журналітак, за подією завершення дзвінка (API CALL COMPLETED)
Імʼя клієнта на екрані телефонутак: у відповідь на API CALL SETTINGS Elbuz віддає імʼя з картки (до 43 символів) і посилання на картку
Особистий менеджертак: якщо в контрагента вказано менеджера, Elbuz передає його пошту, і Binotel може спрямувати дзвінок саме йому
Запис розмовитак: посилання Elbuz запитує в Binotel у момент натискання «Прослухати запис»; воно живе 15 хвилин
Ознака «Новий клієнт»так, Binotel її передає — прихована колонка журналу заповнюється
Щогодинна звірка журналутак, на 25-й хвилині кожної години за добу назад
Скинути дзвінок з картки вхідноготак: кнопка «Скинути» в картці «Вхідний дзвінок»
Голосовий AI-співробітниквхідні — так, через переадресацію на SIP-адресу (налаштовує підтримка Binotel); вихідні — ні (нижче)

Дві події, які Binotel надсилає на адресу Elbuz:

  • API CALL SETTINGS — приходить у момент дзвінка. Elbuz шукає клієнта за номером і відповідає імʼям та посиланням на картку; Binotel показує їх на телефоні менеджера і в своєму розширенні для Chrome.
  • API CALL COMPLETED — приходить після завершення. З нього дзвінок лягає в журнал і в стрічку клієнта. Якщо Elbuz не відповів «успішно», Binotel повторює доставку до семи разів.

Особливості Binotel

Події приймаються лише з адрес Binotel

У Binotel події не мають підпису, тому Elbuz приймає їх лише з 26 адрес серверів Binotel, а запити з будь-якої іншої відхиляє. Якщо Binotel змінить свої адреси, події перестануть доходити без жодної помилки на екрані — журнал наповнюватиме тільки щогодинна звірка.

Імʼя клієнта на телефоні й особистий менеджер

У відповідь на API CALL SETTINGS Elbuz передає Binotel імʼя клієнта, посилання на його картку й, якщо в картці вказано особистого менеджера, його пошту. Імʼя обрізається до 43 символів — більше не вміщує розширення Binotel. Якщо номер належить контактній особі компанії, імʼя складається як «Компанія / Контакт». Незнайомий номер Binotel отримає без імені, з посиланням на список контрагентів.

Записи розмов

Посилання на запис Binotel видає лише на 15 хвилин, тому Elbuz його не зберігає, а запитує щоразу, коли ви натискаєте «Прослухати запис». Прослухати можна доти, доки запис зберігає Binotel.

Щогодинна звірка

Історію дзвінків Binotel віддає не довше ніж за добу на один запит і дозволяє п’ять таких запитів на хвилину без паузи. Elbuz ріже період на добові відрізки й, починаючи з шостого запиту, чекає 10 секунд між ними. Звичайна щогодинна звірка бере одну добу — один запит.

Як іде дзвінок з кнопки

Elbuz просить Binotel зʼєднати внутрішній номер менеджера з номером клієнта і не чекає, доки менеджер візьме слухавку: Binotel відповідає одразу, а дзвонити починає сам. Якщо за 15 секунд Binotel не відповів, ви побачите повідомлення про тайм-аут — дзвінок при цьому міг уже початися.

Голосовий AI-співробітник на номері Binotel

AI-співробітник Elbuz уміє сам відповідати на дзвінки і сам телефонувати клієнтам. Розмову веде не ваша АТС, а голосова платформа Elbuz, і номер треба на неї спрямувати. Налаштування розділу «Голос по телефону» — у статті Голосовий AI-співробітник.

Вхідні: як направити номер на AI

Підтримка Binotel підтвердила (20.10.2026): дзвінок можна передати на зовнішню SIP-адресу, номер того, хто дзвонить, зберігається, а вхідні на SIP-адресу не тарифікуються окремо. Переадресацію в сценарії налаштовує сама підтримка Binotel.

  1. У розділі «Голос по телефону» впишіть номер Binotel, на який має відповідати AI, у «Оператор» оберіть «Інший оператор» і ввімкніть «Відповідати на дзвінки». Поле «Адреси оператора» можна лишити порожнім — тоді Elbuz прийматиме дзвінки з будь-якої адреси. Щоб обмежити, запитайте в підтримки Binotel, з яких адрес ідуть такі дзвінки.
  2. Скопіюйте SIP-адресу з розділу — вона має вигляд 380XXXXXXXXX@<домен> — і допишіть «+» перед номером: +380XXXXXXXXX@<домен>. Binotel приймає зовнішню SIP-адресу лише в такому вигляді: зліва номер з «+», не логін. Elbuz приймає дзвінок на номер і з «+», і без.
  3. Попросіть підтримку Binotel налаштувати у сценарії переадресацію на цю SIP-адресу. Можна цілком, а можна як запасний варіант: «якщо менеджери не відповіли за 20 секунд — передати на SIP-адресу».
  4. Подзвоніть на номер і перевірте, що AI відповідає, а в журналі дзвінків видно номер того, хто дзвонить.

Вихідні дзвінки AI через Binotel

Поки недоступні. Binotel дає вихідні лише через SIP-транк з реєстрацією, а голосова платформа Elbuz працює в хмарі за кордоном і не реєструється на АТС. До того ж вихідні з українських номерів із закордонних IP-адрес Binotel блокує за законодавством України. Для цього потрібен український SIP-шлюз, якого в Elbuz поки немає. Вхідні на AI це не зачіпає.

Сценарії

Менеджер бачить, хто дзвонить, ще до відповіді

  1. Передайте в підтримку Binotel адресу для подій (крок третій).
  2. Заповніть клієнтам особистого менеджера в картці контрагента.
  3. Клієнт дзвонить — Binotel показує його імʼя на телефоні й може спрямувати дзвінок його менеджеру. На екрані Elbuz спливає картка «Вхідний дзвінок».

AI бере слухавку, коли менеджери зайняті

  1. Увімкніть «Відповідати на дзвінки» в розділі «Голос по телефону» і скопіюйте SIP-адресу (вхідні на AI).
  2. Попросіть підтримку Binotel: «якщо менеджери не відповіли за 20 секунд — передати на SIP-адресу».
  3. AI називає статус замовлення за номером того, хто дзвонить, відповідає про доставку й оплату і записує заявку.

Пропущений дзвінок не губиться

Менеджер не взяв слухавку — спливає картка «Пропущений дзвінок», а в «Пульсі» зʼявляється задача «Перетелефонувати». Менеджер тисне «Подзвонити», Binotel зʼєднує його з клієнтом з «Номера лінії для вихідних», і задача знімається сама. Детальніше: пропущені дзвінки.

Що робити, коли Binotel не працює з Elbuz

Загальні проблеми телефонії — немає кнопки дзвінка, порожній журнал, немає запису — розібрано в статті Телефонія в Elbuz. Тут — те, що стосується Binotel.

Що програма каже і що з цим робити
Що ви бачитеЧому такЩо зробити
Кнопки «Подзвонити» немає ні в списку контактів, ні в картці Ключі не вписані або перемикач «Активність» вимкнено — кнопки дзвінка тоді не малюються зовсім Перевірте поля й перемикач у формі підключення (крок перший)
«У вашій картці співробітника не вказано внутрішній номер телефону» Порожнє поле «Телефон внутрішній» у вашій картці: АТС нікуди дзвонити першим кроком Впишіть номер у картку співробітника (крок другий)
«Перевірити підключення» повертає помилку, хоча ключі вставлено Найчастіше вставлено ключі WebSocket замість REST API — на вигляд вони однакові Попросіть у Binotel саме ключі REST API і перевпишіть обидва поля
На телефоні менеджера немає імені клієнта, дзвінки в журналі зʼявляються із запізненням до години Події Binotel не доходять: адресу не налаштовано на API CALL SETTINGS / API CALL COMPLETED або в ній старий домен Скопіюйте адресу з картки «Адреса для вебхука АТС» і передайте в Binotel ще раз
У журналі колонка «Менеджер» порожня Внутрішній номер співробітника в Elbuz не збігається з кінцевою лінією Binotel Впишіть у «Телефон внутрішній» номер, який показує рядок «Номери АТС без співробітника Elbuz»
«АТС не відповіла вчасно. Якщо дзвінок усе ж почався, він зʼявиться в журналі дзвінків — перевірте його перед повторним набором» Оператор не відповів за 15 секунд. Запит міг бути прийнятий — тоді ваш телефон задзвонить трохи згодом Не набирайте одразу вдруге: зачекайте хвилину. Якщо АТС прийняла запит, ваш телефон задзвонить, а після розмови дзвінок зʼявиться в журналі

Часті запитання

Як отримати ключі API Binotel для Elbuz?

Запитайте їх у підтримки Binotel (support@binotel.ua): пункту для генерації в кабінеті офіційні матеріали не описують. Потрібна пара «ключ + секрет» саме REST API — ключі WebSocket для Elbuz не підходять.

Що таке API CALL SETTINGS і API CALL COMPLETED?

Дві події Binotel. Перша приходить у момент дзвінка, і Elbuz відповідає імʼям клієнта. Друга — після розмови, з неї дзвінок лягає в журнал. Обидві налаштовують на адресу з картки «Адреса для вебхука АТС».

Чи побачить менеджер на телефоні імʼя клієнта?

Так, якщо номер є в контрагентах і Binotel надсилає API CALL SETTINGS на адресу Elbuz. Імʼя береться з картки й обрізається до 43 символів.

Чи можна прослухати запис розмови Binotel?

Так. Кнопка «Прослухати запис» у журналі щоразу запитує в Binotel свіже посилання — воно діє 15 хвилин, тому Elbuz його не зберігає.

Чому події Binotel перестали приходити без жодної помилки?

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

Чи можна подзвонити з картки на другий номер контрагента?

Ні. Кнопка «Подзвонити» в картці бере основний телефон контрагента.

Чи можна підключити голосового AI до номера Binotel?

Так, на вхідні: SIP-адресу з розділу «Голос по телефону» з «+» перед номером передайте в підтримку Binotel для переадресації (покроково). Вихідні дзвінки AI через Binotel поки недоступні.

Суміжні теми

Чи була стаття корисною?