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

10 хв

Elbuz підключається до АТС Phonet і забирає дзвінки на себе: менеджер дзвонить клієнту з картки одною кнопкою, а розмови із записами самі лягають у журнал та історію клієнта.

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

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

З чого почати: візьміть у кабінеті Phonet адресу АТС і API-ключ (де саме) і впишіть їх у рядок Phonet групи «Телефонія».

Що вміє Elbuz з Phonet

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

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

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

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

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

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

Обидва значення для Elbuz Phonet показує в одному місці (за довідкою Phonet):

  1. Кабінет Phonet → «Налаштування» → вкладка «Інтеграції».
  2. Прокрутіть до віджета «Інша CRM система» і натисніть «ДОДАТИ».
  3. Поле «API сервер» — це «Адреса АТС» в Elbuz (домен вигляду mycompany.phonet.com.ua); поле «API ключ» — це «API-ключ».

Сторінку інтеграції не закривайте — на третьому кроці в неї вставляється адреса з Elbuz. З доменом АТС Elbuz авторизується й на нього ж ходить по історію й записи.

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

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

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

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

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

Поле у форміЩо вписати
«Адреса АТС»значення поля «API сервер» з Phonet, наприклад mycompany.phonet.com.ua; «https://» і скісна риска в кінці відкидаються самі
«API-ключ»значення поля «API ключ» з Phonet
Картка «Підключення телефонії» у формі Phonet
1Посилання на інструкцію
2Перемикач «Активність»
3Поле «Адреса АТС»
4Поле «API-ключ»
5Кнопка «Перевірити підключення»
  1. Посилання «Де саме — покроково в інструкції для вашого оператора» — веде на цю сторінку.
  2. Перемикач «Активність» — інтеграція ввімкнена.
  3. Поле «Адреса АТС» — значення поля «API сервер» з Phonet.
  4. Поле «API-ключ» — значення поля «API ключ» з Phonet.
  5. Кнопка «Перевірити підключення» — читальний запит до оператора, у кабінеті нічого не змінює.

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

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

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

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

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

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

Крок третій: вебхук для інших CRM-систем

У формі є картка «Адреса для вебхука АТС» з адресою й кнопкою «Скопіювати». Вставте її в поля вебхуків тієї самої інтеграції «Інша CRM система» в кабінеті Phonet і збережіть. Назв цих полів довідка Phonet текстом не наводить, тож якщо незрозуміло, яке поле для чого, — уточніть у підтримки Phonet.

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

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

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

Усе нижче звірено з модулем інтеграції Phonet в Elbuz, написаним за документацією HTTPS API 4.1 оператора.

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

Події, які Elbuz обробляє з вебхука Phonet:

  • call.settings — запит імені клієнта до дзвінка. Elbuz відповідає імʼям, посиланням на картку, ознакою нового контакту й особистим менеджером.
  • call.dial і call.bridge — дзвінок набирається і зʼєднаний: спливає картка вхідного.
  • call.hangup — дзвінок завершився: лягає в журнал.

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

Імʼя на телефоні оновлюється із запізненням

Відповідь з іменем Phonet кешує: для нових контактів до хвилини, для наявних до пʼяти хвилин. Якщо ви щойно завели клієнта або змінили імʼя, на телефоні воно може зʼявитися не одразу.

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

Підпису в подіях Phonet немає, тому Elbuz, крім ключа в адресі, перевіряє адресу відправника: приймає лише шість адрес серверів Phonet із документації оператора. Якщо Phonet змінить їх, події перестануть доходити без повідомлення. Події Phonet можуть дублюватися — журнал записує дзвінок один раз.

Авторизація сесією

Phonet не приймає ключ у кожному запиті: спершу Elbuz авторизується адресою АТС і ключем, отримує сесію й уже з нею працює. Коли сесія застаріває, Elbuz сам авторизується знову й повторює запит. Якщо ж змінився ключ або домен АТС, перевірка підключення поверне помилку.

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

Адреса запису в Phonet будується за шаблоном: ваш домен АТС, далі ідентифікатор дзвінка. Запис доступний лише після завершення розмови. Elbuz кладе цю адресу в журнал, коли розмова тривала хоч секунду.

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

Phonet віддає історію порціями по 50 дзвінків, і Elbuz гортає сторінки, поки не забере все за добу. Внутрішні дзвінки звірка не бере — лише вхідні й вихідні.

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

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

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

У полі «Оператор» розділу «Голос по телефону» оберіть «Інший оператор». У поле «Адреси оператора» впишіть домен своєї АТС — mycompany.phonet.com.ua, той самий, що в полі «Адреса АТС» інтеграції.

За відповіддю підтримки Phonet (20.10.2026), дзвінки на зовнішню SIP-адресу йдуть з IP самої АТС клієнта, тож спільного списку адрес Phonet немає. Домен Elbuz сам перетворює на IP під час збереження розділу. Якщо АТС змінить IP, змініть будь-яке поле розділу «Голос», щоб він зберігся заново. Поле порожнє — Elbuz прийматиме дзвінки з будь-якої адреси.

Розділ покаже адресу виду <номер>@<домен>. Підтримка Phonet підтвердила, що дзвінок можна передати на зовнішню SIP-адресу, і це не тарифікується окремо. Робиться так:

  1. У кабінеті Phonet заведіть окремого користувача для AI і в його контактних номерах вкажіть SIP-адресу з розділу «Голос по телефону» — точно, без пробілів.
  2. У сценарії дзвінка додайте переведення на цього користувача. Так можна зробити й «AI, якщо менеджери не відповіли»: спочатку група менеджерів, далі — переведення на користувача AI.
  3. Транспорт — UDP або TCP; шифрування TLS не вмикайте: Elbuz приймає дзвінок без нього, а TLS у Phonet підключається окремо. Голос іде кодеками G.711 (A-law і μ-law).
  4. Зателефонуйте на номер і перевірте, що AI відповідає і в журналі дзвінків видно номер того, хто дзвонить. Phonet передає його у форматі +380 — залиште так, щоб AI знаходив клієнта за номером.

Вихідні: SIP-лінія для дзвінків AI

Реєстраційні дані телефону користувача адміністратор бачить так (за довідкою Phonet):

  1. Кабінет Phonet → «Налаштування» → «Конфігурація телефонії».
  2. Оберіть користувача, під яким працюватиме AI, і відкрийте варіант «Інший телефон»: там домен, ім'я користувача й пароль.

Домен — у «SIP-сервер», імʼя користувача — у «Логін лінії», пароль — у «Пароль лінії». Пароль пристрою в Phonet окремий від пароля особистого кабінету. Під AI краще завести окремого користувача.

Підтримка Phonet не підтвердила, що через ці дані можна дзвонити з голосової платформи Elbuz: Elbuz дзвонить через SIP-логін без реєстрації телефону. Перевірте пробним дзвінком («Пробний дзвінок» у розділі «Голос по телефону»). Якщо дзвінок не пройде, вихідні дзвінки AI через Phonet поки недоступні — вхідні при цьому працюють.

Вихідні працюють тільки тоді, коли ввімкнено «Відповідати на дзвінки»: інакше пробний дзвінок відповість «Вихідні не налаштовані: вкажіть логін і пароль лінії та увімкніть відповідь на дзвінки». За замовчуванням AI дзвонить з 9 до 20 за часом акаунта — поле «Дзвонити в години».

Сценарії

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

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

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

  1. Заведіть у Phonet користувача для AI з SIP-адресою з розділу «Голос по телефону» (вхідні на AI).
  2. У сценарії дзвінка: спершу група менеджерів, далі — переведення на користувача AI.
  3. AI називає статус замовлення за номером того, хто дзвонить, і записує заявку; розмова лягає в журнал.

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

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

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

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

Що програма каже і що з цим робити
Що ви бачитеЧому такЩо зробити
Кнопки «Подзвонити» немає ні в списку контактів, ні в картці Ключі не вписані або перемикач «Активність» вимкнено — кнопки дзвінка тоді не малюються зовсім Перевірте поля й перемикач у формі підключення (крок перший)
«У вашій картці співробітника не вказано внутрішній номер телефону» Порожнє поле «Телефон внутрішній» у вашій картці: АТС нікуди дзвонити першим кроком Впишіть номер у картку співробітника (крок другий)
«Перевірити підключення» повертає помилку авторизації Невірний API-ключ або в «Адресі АТС» не той домен Звірте домен АТС у кабінеті Phonet і перевпишіть ключ
На телефоні немає імені клієнта, дзвінки зʼявляються із запізненням до години Вебхук не налаштовано або в адресі старий домен Elbuz Скопіюйте адресу з картки «Адреса для вебхука АТС» і замініть її в інтеграції Phonet
Імʼя клієнта на телефоні старе, хоча в картці вже нове Phonet кешує відповідь до пʼяти хвилин Зачекайте кілька хвилин
«АТС не відповіла вчасно. Якщо дзвінок усе ж почався, він зʼявиться в журналі дзвінків — перевірте його перед повторним набором» Оператор не відповів за 15 секунд. Запит міг бути прийнятий — тоді ваш телефон задзвонить трохи згодом Не набирайте одразу вдруге: зачекайте хвилину. Якщо АТС прийняла запит, ваш телефон задзвонить, а після розмови дзвінок зʼявиться в журналі
У розділі «Голос по телефону»: «Не вдалося знайти адреси з поля «Адреси оператора» — перевірте домен АТС або IP» Домен у «Адреси оператора» не знайдено — найчастіше опечатка. Щоб не приймати дзвінки з будь-яких адрес, Elbuz приймання не налаштовує Впишіть домен з поля «Адреса АТС» інтеграції (mycompany.phonet.com.ua) і змініть поле ще раз (вхідні на AI)
Вхідні на AI працюють, а «Пробний дзвінок» не доходить Phonet не підтвердив дзвінки через SIP-логін без реєстрації телефону Перевірте логін, пароль і домен користувача; якщо не допомогло — вихідні AI через Phonet поки недоступні (вихідні)

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

Що вписати в поле «Адреса АТС» для Phonet?

Значення поля «API сервер» з інтеграції «Інша CRM система» в кабінеті Phonet — домен вашої АТС, наприклад mycompany.phonet.com.ua. Префікс https:// і скісну риску в кінці Elbuz відкидає сам.

Де в Phonet взяти API-ключ і куди вписати адресу Elbuz?

У кабінеті Phonet: «Налаштування» → «Інтеграції» → «Інша CRM система» → «ДОДАТИ». Там поля «API сервер» і «API ключ», і там же поля вебхуків для адреси з картки «Адреса для вебхука АТС».

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

Так, після завершення розмови. Адреса запису будується від домену вашої АТС, тому окремого запиту до Phonet під час прослуховування немає.

Чому події Phonet приходять двічі?

Phonet може дублювати події, про це сказано в його документації. Elbuz записує дзвінок у журнал один раз: повтор із тим самим ідентифікатором дзвінка не створює новий рядок.

Чи можна вибрати номер, з якого Phonet дзвонить клієнту?

Ні. API дзвінка Phonet номера лінії не приймає, тому поля «Номер лінії для вихідних» у формі Phonet немає.

Чи потрапляють у журнал внутрішні дзвінки між співробітниками?

Ні. Журнал — про розмови з клієнтами: Elbuz пише лише вхідні й вихідні дзвінки Phonet.

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

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

Суміжні теми

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