Як підключити Telnyx до Elbuz: FQDN connection для голосового AI-співробітника

7 хв

Elbuz віддає номер Telnyx голосовому AI-співробітнику: він відповідає покупцям, коли менеджери зайняті, і сам дзвонить клієнтам із процесів — номер можна купити в Telnyx у багатьох країнах.

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

  • Дзвонять після робочого дня — AI називає статус замовлення, розповідає про доставку й оплату.
  • Клієнт хоче замовити чи поскаржитися — AI записує заявку, прохання передзвонити йде в «Пульс».
  • Прийшло нове замовлення — AI сам дзвонить його підтвердити.
  • Замовлення відправлене — AI дзвонить і диктує ТТН.

З чого почати: впишіть номер Telnyx у розділ «Голос по телефону» картки AI-співробітника.

Що вміє AI на номері Telnyx

У кабінеті Telnyx заводять SIP connection типу FQDN на домен із SIP-адреси розділу «Голос по телефону», а в Elbuz вибирають оператора «Telnyx». Що саме каже AI і як ставити дзвінки з процесів — у статті Голосовий AI-співробітник по телефону.

  • Відповідає на дзвінки. Називає статус замовлення за номером того, хто дзвонить, розповідає про доставку й оплату за статтями магазину, ціну й наявність товару (вхідні).
  • Приймає заявки. Записує імʼя, номер і суть; прохання передзвонити потрапляє в «Пульс» відповідальному за клієнта.
  • Лишає текст і резюме. Нового клієнта Elbuz заводить у CRM за номером, резюме лягає в стрічку його картки (що приходить у Elbuz).
  • Дзвонить сам. Процес Flows з блоком «AI-дзвінок» підтверджує замовлення або повідомляє про відправлення (вихідні).

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

Меню
Довідники → Контакти → Пульс → вкладка «Агенти»
З вкладки «Агенти»
«Налаштування агента» на картці AI-співробітника → розділ «Голос по телефону»
Кабінет Telnyx
Real-time Communications → Voice → SIP Trunking
Право доступу
«Управління» — тільки воно бачить розділ «Голос по телефону»
Підготувати
платний акаунт Telnyx і куплений у ньому номер

Окремого рядка Telnyx у «Зовнішніх сервісах» немає і не потрібно: усе налаштування — в розділі «Голос по телефону».

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

  • Платний акаунт. Інструкція LiveKit (платформа, на якій працює голос Elbuz) вимагає платний акаунт Telnyx: у пробного є обмеження на дзвінки.
  • Номер. Купіть номер у кабінеті Telnyx до налаштування connection — на останньому кроці його треба буде привʼязати.
  • Outbound Voice Profile з дозволеними країнами — для вихідних (як завести).

SIP connection, привʼязку номера й Outbound Voice Profile робите в кабінеті Telnyx самі. Номер і хвилини Telnyx оплачуються в Telnyx за його тарифами, окремо від Elbuz; хвилина розмови AI в Elbuz коштує 0,15 EUR за фактичними секундами (ціна голосового AI).

Назви пунктів кабінету Telnyx узято з документації LiveKit і Telnyx станом на 20.10.2026. Якщо пункт називається інакше — орієнтуйтеся на ці сторінки або питайте підтримку Telnyx:

Як підключити вхідні дзвінки Telnyx

Порядок: спершу Elbuz (щоб побачити адресу), потім Telnyx, потім пробний дзвінок зі свого мобільного.

Крок 1. В Elbuz

  1. Відкрийте картку AI-співробітника (див. де це і хто має доступ) і прокрутіть до «Голос по телефону».
  2. У «Номер телефону» впишіть номер Telnyx у міжнародному форматі з плюсом, наприклад +380441234567.
  3. В «Оператор» оберіть «Telnyx». Адреси серверів Telnyx усіх регіонів програма знає сама — поле «Адреси оператора» для Telnyx не показується.
  4. Увімкніть «Відповідати на дзвінки». Розділ зберігається сам після зміни поля, зверху зʼявляється «Налаштування голосу збережено».
  5. Під полями зʼявиться синя плашка з адресою виду 380441234567@<домен> і підказкою «Twilio і Telnyx — SIP trunk». У Telnyx це SIP connection з кроку 2, і для неї потрібна тільки частина адреси після @ — домен. Скопіюйте його звідти: вигадувати чи скорочувати не можна.
Розділ «Голос по телефону» в картці AI-співробітника з оператором Telnyx: номер, SIP-адреса, SIP-сервер sip.telnyx.com, логін і пароль лінії
1Рядок кроків
2Номер Telnyx
3Оператор Telnyx
4Домен для FQDN
5SIP-сервер
6Логін і пароль
7Номер для клієнта
8Пробний дзвінок
  1. Зелене виконано; «інструкція» веде на цю статтю, коли вибрано Telnyx.
  2. Номер, куплений у Telnyx і привʼязаний до SIP connection, у форматі +E.164.
  3. Для Telnyx адреси його серверів програма знає сама — адреси вписувати не треба.
  4. Плашка з SIP-адресою; Telnyx потрібна тільки частина після @ — домен, його вписують як FQDN у SIP connection.
  5. Порожньо — програма підставить sip.telnyx.com.
  6. Username і Password з «Outbound calls authentication» тієї самої SIP connection.
  7. Номер Telnyx, який побачить клієнт; порожньо — «Номер телефону».
  8. Справжній дзвінок на вказаний номер — перевірка вихідних.

Крок 2. У кабінеті Telnyx

  1. Відкрийте Real-time Communications → Voice → SIP Trunking і натисніть «Create SIP connection». Дайте назву, наприклад «Elbuz AI».
  2. Оберіть тип FQDN → «Next».
  3. Натисніть «+ Add FQDN», впишіть домен із SIP-адреси в розділі «Голос по телефону» (частина після @), порт 5060, збережіть.
  4. У блоці «Outbound calls authentication» задайте Username і Password. Вони потрібні для вихідних — запишіть їх, у Elbuz вони стануть «Логін лінії» і «Пароль лінії». Далі двічі «Next» (розділ Configuration можна пропустити).
  5. На вкладці вхідних: Destination number format — +E.164, Origination number format — +E.164, SIP transport protocol — TCP, SIP region — найближчий до ваших клієнтів (для України — Europe). «Next».
  6. На вкладці вихідних оберіть Outbound voice profile (як його завести — у вихідних дзвінках). «Next».
  7. Натисніть іконку посилання й привʼяжіть свій номер до цієї connection → «Complete».

Формат номерів має бути саме +E.164. Elbuz приймає дзвінок, лише коли номер, на який дзвонять, збігається з «Номер телефону» в розділі (з плюсом або без). Номер у національному форматі не збіжеться, і дзвінок не буде прийнятий. Номер того, хто дзвонить, у +E.164 дає AI знайти клієнта і назвати його замовлення.

Крок 3. Перевірка

Подзвоніть на номер Telnyx зі свого мобільного. AI має відповісти, а розмова — зʼявитися в журналі дзвінків. Коли за останні 30 днів був хоч один вхідний дзвінок AI, крок «Дзвінки надходять» над полями розділу зелений — це видно, коли картку відкрити знову.

Як увімкнути вихідні дзвінки AI через Telnyx

Вихідні йдуть через ту саму SIP connection: Elbuz входить у Telnyx логіном і паролем з «Outbound calls authentication», а Telnyx пропускає дзвінок за правилами Outbound Voice Profile. Вихідні працюють тільки разом з увімкненим «Відповідати на дзвінки».

У кабінеті Telnyx

  1. Якщо Outbound Voice Profile ще немає — заведіть його в Real-Time Communications → Voice → Settings.
  2. У профілі в International Allowed Destinations додайте країни, куди AI дзвонитиме (наприклад, Україну). Дзвінок у країну, якої немає в списку, Telnyx не пропустить. Частина країн вмикається лише після верифікації акаунта рівня Level 2.
  3. Оберіть цей профіль у вихідних налаштуваннях SIP connection (крок 6 вище). FQDN connection привʼязується до профілю саме з налаштувань connection.

В Elbuz, блок «Вихідні дзвінки»

  1. «SIP-сервер» лиште порожнім — програма підставить sip.telnyx.com, як в інструкції LiveKit; підказка в порожньому полі так і показує. Для регіону Europe можна вписати sip.telnyx.eu — перелік регіональних адрес Telnyx публікує на sip.telnyx.com/voice.json.
  2. «Логін лінії» і «Пароль лінії» — Username і Password з «Outbound calls authentication». Пароль у форму назад не повертається; порожнє поле пароля означає «не змінювати».
  3. «Номер для клієнта» — номер Telnyx, привʼязаний до connection. Порожньо — береться «Номер телефону».
  4. «Дзвонити в години» — формат 9-20 (що буде поза годинами).
  5. Впишіть свій номер у «Номер для пробного дзвінка» і натисніть «Пробний дзвінок». Це справжній дзвінок; підсумок — у журналі дзвінків. Поза «Дзвонити в години» пробний дзвінок не йде: відповідь — «Зараз неробочі години для дзвінків».

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

МожливістьЗ TelnyxЩо для цього треба
AI відповідає на дзвінки на номер TelnyxтакSIP connection типу FQDN на домен із розділу «Голос по телефону» з привʼязаним номером
AI сам дзвонить клієнтам (процеси, «Пробний дзвінок»)таку тій самій connection — логін і пароль для вихідних та Outbound Voice Profile
Розмови AI в журналі дзвінків і стрічці клієнтатакнічого окремо (що лишається після дзвінка)
Дзвінки співробітників у журналі, картка клієнта під час дзвінка, «Подзвонити» з карткинідрайвера API Telnyx в Elbuz немає

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

Що з Telnyx куди вписати

У TelnyxВ Elbuz
Номер, привʼязаний до SIP connection«Номер телефону» і, за бажанням, «Номер для клієнта»
FQDN connection: <домен>, порт 5060частина адреси з синьої плашки після @
Outbound calls authentication: Username«Логін лінії»
Outbound calls authentication: Password«Пароль лінії»
Регіональна адреса SIP (не обовʼязково)«SIP-сервер»; порожньо — sip.telnyx.com
Підмережі Telnyxнічого — вшиті для оператора «Telnyx»

Заголовок X-Telnyx-Username

Окремо вписувати заголовок X-Telnyx-Username, про який пише інструкція LiveKit, не треба: для оператора «Telnyx» Elbuz додає його сам, зі значенням «Логін лінії». Без нього Telnyx шукав би connection за IP-адресою і не питав пароль.

Сценарії

AI бере дзвінки, коли менеджери не встигають

Пройдіть три кроки вхідних, логін і пароль лінії можна не вписувати. AI відповідатиме на номер Telnyx, а розмови з резюме зʼявлятимуться в журналі й у стрічці клієнта.

AI підтверджує кожне нове замовлення

Заведіть Outbound Voice Profile з країною клієнтів, впишіть логін і пароль лінії й зробіть «Пробний дзвінок». Потім зберіть процес Flows з блоком «AI-дзвінок» на створення замовлення (підтвердити замовлення).

Клієнти в Європі

У connection виберіть SIP region Europe, а в «SIP-сервер» за бажанням впишіть sip.telnyx.eu. Адреси Telnyx усіх регіонів Elbuz уже знає, вписувати їх не треба.

Що робити, коли AI не відповідає або не дзвонить

Розбір частих проблем
Що ви бачитеЧому такЩо зробити
Дзвінок на номер Telnyx іде, але AI не відповідає Номер не привʼязаний до connection, у FQDN не той домен, що в розділі «Голос по телефону», формат номерів не +E.164, або «Номер телефону» в Elbuz інший Звірте connection з кроком 2 і номер у розділі з номером Telnyx
Налаштування правильні, а відповіді все одно немає Вимкнено «Відповідати на дзвінки» або сам AI-співробітник Перевірте обидва перемикачі (розбір у статті про голос)
Вхідні працюють, а пробний чи вихідний дзвінок не доходить Країни клієнта немає в International Allowed Destinations профілю, профіль не обрано в connection або акаунт пробний Додайте країну в Outbound Voice Profile і оберіть профіль у connection (вихідні в Telnyx)
Вихідний дзвінок не доходить, країна дозволена «Логін лінії» чи «Пароль лінії» не збігаються з «Outbound calls authentication» Впишіть їх ще раз з connection (вихідні в Elbuz)
«Вихідні не налаштовані: вкажіть логін і пароль лінії та увімкніть відповідь на дзвінки» Немає логіна чи пароля лінії, або вимкнено «Відповідати на дзвінки» Заповніть обидва поля й увімкніть лінію
«Зараз неробочі години для дзвінків» «Пробний дзвінок» натиснули поза «Дзвонити в години» — до Telnyx дзвінок не доходив Повторіть у робочі години або розширте години (черга)
«Не вдалося налаштувати приймання дзвінків: …» Платформа голосу не прийняла налаштування; причина — після двокрапки Виправте номер чи логін і змініть будь-яке поле ще раз — налаштування повторяться

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

Чи потрібні ключі API Telnyx?

Ні. Голосовий AI отримує дзвінки через SIP connection, а вихідні йдуть за логіном і паролем цієї connection. Драйвера API Telnyx в Elbuz немає, тож і вписувати ключі нікуди.

Чи потрапляють у журнал дзвінки моїх менеджерів через Telnyx?

Ні, тільки розмови AI-співробітника. Для журналу дзвінків співробітників потрібен оператор, підключений у «Зовнішніх сервісах», наприклад Zadarma чи Binotel.

Чи треба вписувати IP-адреси Telnyx?

Ні. Для оператора «Telnyx» Elbuz сам приймає дзвінки з сигнальних адрес Telnyx усіх регіонів, тому «SIP region» у connection можна вибрати будь-який.

Що вписати в «SIP-сервер» для Telnyx?

Нічого: порожнє поле означає sip.telnyx.com. За бажанням для регіону Europe можна вписати sip.telnyx.eu.

Чи можна використати Call Control, TeXML чи AI-асистентів Telnyx?

Ні. Elbuz працює з Telnyx лише як із SIP-оператором; розмову веде AI-співробітник Elbuz.

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

Ні. Один номер і один AI-співробітник на акаунт — незалежно від оператора.

Суміжні теми

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