Elbuz робить із хмарної АТС sipgate CRM-телефонію: менеджер дзвонить клієнту з картки однією кнопкою, бачить, хто дзвонить, а кожна розмова з записом лягає в журнал і в історію клієнта.
Коли це знадобиться:
- Дзвонить клієнт — менеджерові спливає картка з імʼям клієнта та його останніми замовленнями.
- Треба передзвонити клієнту — «Подзвонити» в картці: sipgate спершу дзвонить менеджерові, потім клієнту.
- Дзвінок пропущено — у «Пульсі» зʼявляється задача «Перетелефонувати».
- Акаунт перевели з classic на neo — Elbuz сам визначає платформу, перевʼязувати нічого не треба.
З чого почати: створіть Personal Access Token і впишіть його в рядок sipgate групи «Телефонія».
Що вміє інтеграція з sipgate
Звʼязка працює двома каналами: через REST API Elbuz ставить і скидає дзвінки та щогодини звіряє журнал, а через вебхуки sipgate.io (Push-API) sipgate сам повідомляє про початок і кінець кожного дзвінка.
- Картка того, хто дзвонить. Спливає «Вхідний дзвінок» з імʼям клієнта і його останніми замовленнями; незнайомий номер заводиться кнопкою «Створити контрагента» (картка дзвінка).
- Дзвінок з картки клієнта одною кнопкою. «Подзвонити» в картці контрагента чи в журналі — номер набирати не треба (як іде дзвінок).
- Запис і резюме в історії клієнта. Дзвінок лягає в стрічку клієнта, «Прослухати запис» відкриває запис, AI-розбір пише резюме і пропонує наступний крок (AI-розбір дзвінків).
- Пропущений дзвінок стає задачею. У «Пульсі» зʼявляється «Перетелефонувати» з високим пріоритетом і знімається сама після розмови з цим номером.
- Classic і neo без перемикачів. Elbuz сам визначає платформу акаунта (classic чи neo).
Де це і хто має доступ
- Меню
- Кабінет → Налаштування системи → «Інші налаштування» → «Зовнішні сервіси та інтеграції» → «Телефонія» → sipgate
- Внутрішній номер
- «Користувачі (співробітники)» → картка співробітника → «Телефон внутрішній»
- Журнал дзвінків
- Довідники → Контакти → Журнал дзвінків
- Право доступу
- налаштування системи і вікно «Журнал дзвінків»; щоб просто дзвонити, права не потрібні
- Підготувати
- Personal Access Token sipgate; на classic — пакет sipgate.io
Без права на «Журнал дзвінків» не працюють «Перевірити підключення», адреса вебхука, «Скинути» і «Прослухати запис». Загальна механіка — журнал, картка дзвінка, права — у статті Телефонія в Elbuz.
Що потрібно від sipgate
- Personal Access Token (Token-ID і Token) з пʼятьма правами — список у кроці першому.
- Пакет sipgate.io на classic — без нього вебхуки не працюють; найпростіший, sipgate.io S, безкоштовний.
- Користувач-власник токена на neo має входити в усі канали, дзвінки яких потрібні в журналі.
У sipgate дві платформи: classic (договори до вересня 2025) і neo (нові акаунти з вересня 2025, старі туди переводять). Свою платформу sipgate показує в меню профілю у вебінтерфейсі — клік по аватару вгорі праворуч.
Шляхи в кабінеті sipgate взято з документації sipgate станом на 20.10.2026. Якщо пункт називається інакше — орієнтуйтеся на ці сторінки або питайте підтримку sipgate:
Як підключити sipgate
Три кроки: токен, внутрішні номери співробітників і адреса для вебхуків. Без вебхуків журнал наповнюватиме лише щогодинна звірка, а картка вхідного дзвінка не зʼявиться.
Крок перший: Personal Access Token
- Відкрийте app.sipgate.com/personal-access-token і створіть токен.
- Дайте йому пʼять прав (scopes):
sessions:calls:write— дзвінок з Elbuz на classic;rtcm:write— дзвінок з Elbuz на neo і кнопка «Скинути»;users:read— список співробітників і пристрій, на який дзвонити;channels:read— визначення neo і звірка журналу на neo;history:read— звірка журналу й записи на classic (на neo записи беруться з подій каналу — правоchannels:read).
- Скопіюйте Token-ID і сам токен.
Відкрийте рядок sipgate у групі «Телефонія». Перемикач «Активність» уже ввімкнено — залиште його так.
| Поле у формі | Що вписати |
|---|---|
| «Token-ID» | Token-ID з Personal Access Token |
| «Token» | сам токен |
| «Номер лінії для вихідних» | ваш номер sipgate, який бачитиме клієнт; порожньо — sipgate обере сам |
1
Посилання на інструкцію2
Перемикач «Активність»3
Поле «Token-ID»4
Поле «Token»5
Номер лінії для вихідних6
Перевірити підключення- Веде на цю статтю.
- Увімкнений — сервіс працює; вимкнений — кнопок дзвінка немає.
- Token-ID з Personal Access Token sipgate.
- Сам токен; після збереження в полі видно лише крапки.
- Номер sipgate, з якого дзвонити клієнту; порожньо — sipgate обере сам.
- Читальний запит до sipgate: платформа (classic чи neo) і список співробітників.
Форма зберігається сама приблизно через секунду після правки: унизу видно «Збереження...», потім «Збережено». Наприкінці натисніть «Перевірити підключення» — Elbuz лише читає дані з sipgate, у вашому акаунті нічого не змінює. Відповідь:
- «Звʼязок з АТС встановлено. Співробітників в АТС: ‹кількість›» і платформа — «sipgate classic» або «sipgate neo»;
- «Номери АТС без співробітника Elbuz:» — ID користувачів sipgate, яким ще не відповідає жодна картка в Elbuz;
- «Співробітників в АТС: 0» і наприкінці «users: HTTP 403…» — у токена немає
users:read, дзвінки з кнопки не підуть.
На neo звірка бачить дзвінки лише тих каналів, учасником яких є власник токена: роль адміністратора для цього не дає доступу. Створюйте токен під користувачем, який входить у всі канали, дзвінки яких мають бути в журналі.
Крок другий: внутрішні номери
Внутрішній номер співробітника для sipgate — це ID користувача sipgate: w0, w1 і так далі. Саме його sipgate надсилає в подіях дзвінка, і за ним Elbuz привʼязує дзвінок до менеджера. Впишіть ID у поле «Телефон внутрішній» картки співробітника; ще не привʼязані ID разом з іменами показує «Перевірити підключення».
Коли менеджер натискає «Подзвонити», Elbuz бере в sipgate пристрій за замовчуванням цього користувача й дзвонить на нього. У поле можна вписати й ID пристрою (e0) — дзвонити вийде, але вхідні дзвінки до цього менеджера не привʼяжуться. Як Elbuz упізнає менеджера загалом — у розділі внутрішні номери.
Крок третій: як налаштувати вебхуки sipgate
У формі є картка «Адреса для вебхука АТС» з адресою й кнопкою «Скопіювати». Адреса завжди починається з https:// — інших sipgate не приймає.
1
Підказка для sipgate2
Адреса приймача3
Скопіювати- Куди вставити адресу: classic — API Console, Webhooks → URLs; neo — Appweb; в обидва поля.
- Завжди https; містить секретний ключ — вписується в sipgate для вхідних і вихідних.
- Копіює адресу в буфер обміну.
sipgate classic. Вебхуки потребують пакета sipgate.io.
- Увійдіть на console.sipgate.com → в меню зліва Webhooks → URLs.
- Натисніть шестерню в рядку Incoming, вставте адресу з Elbuz, збережіть. Те саме — для Outgoing.
- У розділі sources оберіть лінії й групи, дзвінки яких мають надходити в Elbuz. Без жодної вибраної лінії подій не буде.
sipgate neo. Push-API працює й тут, але вебхуки задаються для каналу, у вебінтерфейсі sipgate (Appweb — так його називає й підказка в Elbuz). Точного шляху до цих налаштувань документація sipgate не наводить — шукайте налаштування вебхуків каналу в Appweb або запитайте підтримку sipgate.
Вставляйте ту саму адресу з Elbuz. Neo вимагає https і не йде за перенаправленнями, тож адресу не можна замінювати коротким посиланням.
Перевірка. Подзвоніть на свій номер sipgate. Якщо дзвінок не зʼявився в Elbuz, у кабінеті вебхуків sipgate натисніть «Activate debug log» і відкрийте журнал запитів на app.sipgate.com/io/log (пункт «Debug log»): там видно кожен запит до Elbuz і відповідь.
Кожну подію sipgate підписує, і Elbuz перевіряє підпис. Подію без чинного підпису Elbuz мовчки ігнорує — помилки на екрані не буде.
У адресі — секретний ключ і хост, з якого ви відкрили форму. Змінили домен або створили сервіс у списку заново — адреса стала іншою, і її треба вписати в sipgate ще раз.
Щоб sipgate запрацював з Elbuz
Що приходить у Elbuz
| Можливість | sipgate classic | sipgate neo |
|---|---|---|
| Дзвінок з картки й журналу («Подзвонити») | так | так |
| Картка «Вхідний дзвінок» менеджерові | так, за подією початку дзвінка | так, за подією початку дзвінка |
| Дзвінки в журналі | так, за подією завершення; тривалість уточнює звірка | так, за подією завершення; тривалість уточнює звірка |
| Щогодинна звірка журналу | за історією дзвінків sipgate | за подіями каналів (історія дзвінків на neo порожня) |
| «Скинути» в картці вхідного | так | так |
| Запис розмови («Прослухати запис», AI-розбір) | так, з історії дзвінків | так, з подій каналу |
| Імʼя клієнта на екрані телефону | ні | ні |
| SMS | ні | ні |
Особливості sipgate
Classic чи neo
Від платформи залежать запит дзвінка з кнопки і те, звідки звірка бере дзвінки. Elbuz визначає її так:
- питає в sipgate тип акаунта;
- якщо sipgate його не називає — дивиться, чи є в акаунті канали: канали бувають лише в neo;
- якщо список каналів отримано, але він порожній, — вважає акаунт classic.
Тому право channels:read потрібне навіть для дзвінків. Що токену його бракує, скажуть і «Перевірити підключення», і помилка «Подзвонити», якщо sipgate відхилить дзвінок. Після переводу акаунта на neo нічого перевʼязувати в Elbuz не треба — достатньо прав rtcm:write і channels:read у токена.
Тривалість дзвінка
У події завершення sipgate не передає ні тривалості, ні часу початку. Elbuz рахує тривалість від початку дзвінка до завершення — разом із гудками, тому одразу після дзвінка вона приблизна. Точну тривалість ставить щогодинна звірка з даних sipgate.
Груповий вхідний дзвінок
Коли дзвінок іде на групу, sipgate надсилає список користувачів, і Elbuz записує дзвінок на першого з них. Звірка потім ставить менеджера з даних sipgate: на neo — власника дзвінка, на classic — користувача, який узяв слухавку. Якщо слухавку взяв пристрій, а не користувач, або ніхто не відповів, на classic лишається перший користувач зі списку.
Записи розмов
Файл запису sipgate віддає тільки з токеном. Коли ви натискаєте «Прослухати запис», сервер Elbuz сам завантажує файл із sipgate з вашим токеном і передає плеєру — токен у браузер не потрапляє. Так само файл бере й AI-розбір дзвінка.
- Запис шукається серед останніх дзвінків sipgate: на classic — в історії, на neo — в подіях каналів.
- Перемотувати запис у плеєрі можна, коли файл завантажився повністю.
- Файл більше 25 МБ не відтворюється й не розбирається.
Як іде дзвінок з кнопки
Elbuz просить sipgate зʼєднати пристрій менеджера з номером клієнта і не чекає, доки менеджер візьме слухавку: sipgate спершу дзвонить на пристрій менеджера, після відповіді — клієнту. Перед цим Elbuz може зробити ще кілька запитів — визначити платформу й пристрій менеджера; кожен чекає відповіді до 15 секунд.
- Не відповів запит пристрою — дзвінок точно не почався: ви побачите «АТС відхилила запит: …», можна одразу повторити.
- Не відповів сам запит дзвінка — повідомлення про тайм-аут: дзвінок при цьому міг уже початися.
Сценарії
Акаунт sipgate перевели на neo
У Elbuz нічого не міняйте. Перевірте, що в токена є rtcm:write і channels:read, а власник токена — учасник усіх каналів. Вебхуки задайте для каналів neo в Appweb. «Перевірити підключення» має показати «sipgate neo».
Вхідні йдуть на групу менеджерів
Одразу після дзвінка він записаний на першого користувача групи. Протягом години звірка поставить того, хто взяв слухавку (на neo — власника дзвінка). Щоб це спрацювало, у кожного менеджера в «Телефон внутрішній» має стояти ID користувача w…, а не пристрою.
Клієнт має бачити один номер компанії
Впишіть цей номер sipgate у «Номер лінії для вихідних». Усі дзвінки з кнопки «Подзвонити» підуть з нього, хоч би який менеджер дзвонив.
Що робити, коли дзвінки не доходять
| Що ви бачите | Чому так | Що зробити |
|---|---|---|
| «АТС відхилила запит: HTTP 401…» після «Перевірити підключення» | Token-ID чи Token вписані неправильно або токен видалено | Створіть токен заново й перевпишіть обидва поля (крок перший) |
| «АТС відхилила запит: HTTP 403…» при дзвінку з кнопки | У токена немає права на цей запит: sessions:calls:write на classic, rtcm:write на neo |
Створіть токен з усіма пʼятьма правами |
| «Перевірити підключення» або помилка «Подзвонити» закінчується словами «… add channels:read to the Personal Access Token» | У токена немає права channels:read, і Elbuz не зміг визначити, classic у вас чи neo |
Створіть токен із channels:read і перевпишіть «Token-ID» і «Token» (classic чи neo) |
| «Співробітників в АТС: 0», хоча користувачі в sipgate є | У токена немає права users:read |
Додайте право — без нього не працює й «Подзвонити» з ID користувача |
| «АТС відхилила запит: sipgate user w… has no default device» | У користувача sipgate не задано пристрій за замовчуванням | Задайте його в sipgate або впишіть у «Телефон внутрішній» ID пристрою (e0) — тоді вхідні до менеджера не привʼяжуться |
| «У вашій картці співробітника не вказано внутрішній номер телефону» | Порожнє поле «Телефон внутрішній» | Впишіть свій ID sipgate (крок другий) |
| Дзвінки зʼявляються в журналі із запізненням до години, картки вхідного немає | Вебхуки не доходять: адресу не вписано, у sources не вибрано лінії, на classic немає пакета sipgate.io або в адресі старий домен | Увімкніть «Activate debug log» і подивіться відповідь Elbuz на app.sipgate.com/io/log (крок третій) |
| У журналі колонка «Менеджер» порожня | У картці співробітника не ID користувача (w…), а ID пристрою чи номер | Впишіть ID користувача з «Номери АТС без співробітника Elbuz» |
| «Прослухати запис» є, але плеєр мовчить | Сервер Elbuz не зміг завантажити файл із sipgate: токен змінено чи видалено, у токена немає history:read (classic) чи channels:read (neo), на neo власник токена не учасник каналу, або файл більше 25 МБ |
Перевірте токен і права кнопкою «Перевірити підключення» (крок перший) |
| «АТС не відповіла вчасно. Якщо дзвінок усе ж почався, він зʼявиться в журналі дзвінків — перевірте його перед повторним набором» | sipgate не відповів вчасно на сам запит дзвінка (до 15 секунд); запит міг бути прийнятий | Не набирайте одразу вдруге: зачекайте хвилину |
Дзвінок не зʼявився в журналі взагалі, а вебхуки доходять — загальний розбір у статті Телефонія в Elbuz.
Часті запитання
Які права дати токену sipgate для Elbuz?
Пʼять: sessions:calls:write, rtcm:write, users:read, channels:read і history:read. Перші два — дзвінок з Elbuz на classic і на neo, users:read — співробітники, channels:read і history:read — звірка журналу на neo і на classic.
Що вписати в «Телефон внутрішній» для sipgate?
ID користувача sipgate — w0, w1 і так далі. Ще не привʼязані ID «Перевірити підключення» показує в рядку «Номери АТС без співробітника Elbuz». ID пристрою (e0) теж дає дзвонити, але вхідні дзвінки до менеджера тоді не привʼяжуться.
Чому тривалість дзвінка змінилася через годину?
Одразу після дзвінка Elbuz знає лише час від початку до завершення разом із гудками. Точну тривалість щогодинна звірка бере з даних sipgate.
Чи можна надсилати SMS через sipgate з Elbuz?
Ні, інтеграція працює тільки з дзвінками.
Чи побачить менеджер імʼя клієнта на екрані телефону?
Ні. Імʼя і замовлення клієнта показує картка «Вхідний дзвінок» в Elbuz, на телефон sipgate Elbuz імені не передає.
Чи можна поставити голосового AI-співробітника на номер sipgate?
Готової інструкції для sipgate немає: у розділі «Голос по телефону» оператора sipgate немає. Які оператори підтримуються — у статті Голосовий AI-співробітник.
Суміжні теми
- Якщо треба зрозуміти журнал, картку дзвінка чи хто що бачить — Телефонія в Elbuz.
- Якщо менеджерові треба вписати «Телефон внутрішній» — Картка співробітника.
- Якщо треба знайти розмову в історії клієнта — Картка контрагента.