Як підключити Twilio до Elbuz: SIP trunk для голосового AI-співробітника

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

Звʼязок іде через продукт Elastic SIP Trunking у консолі Twilio. У Twilio ви створюєте trunk, вписуєте в нього адресу Elbuz для вхідних і логін-пароль для вихідних, а в Elbuz — номер, оператора Twilio й адресу trunk. Що саме каже AI і як ставити дзвінки з процесів — у статті Голосовий AI-співробітник по телефону.

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

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

Меню

Довідники → Контакти → Пульс → вкладка «Агенти»

З вкладки «Агенти»

«Налаштування агента» на картці співробітника → розділ «Голос по телефону»

Консоль Twilio

Products & Services → Elastic SIP Trunking → Trunks

Право доступу

«Управління» — тільки воно бачить розділи «Агент» і «Голос по телефону»

Підготувати

акаунт Twilio з купленим номером і доступом до Elastic SIP Trunking

Окремого підключення Twilio в «Зовнішніх сервісах» немає: усе налаштовується в розділі «Голос по телефону» картки того AI-співробітника, який відповідатиме на дзвінки.

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

• Номер Twilio у вашому акаунті.
• SIP trunk з Origination на адресу Elbuz — для вхідних.
• Termination і Credential List у тому самому trunk — для вихідних.
• Geo permissions на країни, куди дзвонитиме AI; trial-акаунт дзвонить лише на підтверджені номери.

Trunk, Origination, Termination і Credential List створюєте ви: Elbuz консолі Twilio не бачить і не перевіряє. Номер і хвилини Twilio оплачуються Twilio за його тарифами, окремо від Elbuz; хвилина розмови AI в Elbuz коштує 0,15 EUR за фактичними секундами (ціна голосового AI).

Назви пунктів консолі — англійською, як в інтерфейсі Twilio; взято з документації Twilio і LiveKit (платформа, через яку Elbuz веде голосові дзвінки). Якщо пункт називається інакше — орієнтуйтеся на ці сторінки або питайте підтримку Twilio:

• LiveKit: налаштування trunk Twilio (Origination, Termination, Credential lists)
• Twilio: Elastic SIP Trunking — Termination, Origination, номери, Caller ID
• Twilio: IP-адреси Elastic SIP Trunking
• Twilio: помилки SIP Trunking, у тому числі 403 No International Authorization

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

Порядок: створити trunk, вписати в нього адресу Elbuz, привʼязати до trunk номер, потім заповнити розділ у Elbuz.

Крок 1. Trunk у Twilio

1. Консоль Twilio → Products & Services → Elastic SIP Trunking → Trunks.
2. Create new SIP trunk, введіть назву (наприклад, elbuz-ai) → Create.

Крок 2. Origination: куди Twilio передає вхідні

1. У trunk відкрийте вкладку Origination.
2. У блоці Origination URIs додайте новий Origination URI.
3. У поле Origination SIP URI впишіть sip:<домен із розділу>;transport=tcp, де домен — частина SIP-адреси з розділу «Голос по телефону» після @.
4. Priority і Weight — 1 і 1. Поки URI один, інші значення нічого не змінюють.
5. Збережіть URI.

Розділ «Голос по телефону» показує адресу виду 12025550143@<домен> з підказкою «…направте дзвінки цього номера на SIP-адресу (Zadarma — «Зовнішній сервер», Twilio і Telnyx — SIP trunk…)». Для Twilio з адреси потрібен лише домен після «@».

Номер Twilio підставляє сам: у кожному вхідному він передає набраний номер у форматі +<код країни><номер>, і Elbuz знаходить за ним вашу лінію — з плюсом чи без.

Крок 3. Номер Twilio на trunk

Привʼяжіть номер до trunk одним із двох способів, описаних у документації Twilio:

• у trunk — розділ Numbers, додати наявний номер акаунта;
• або в налаштуваннях самого номера в блоці Voice вибрати SIP Trunking і цей trunk, потім зберегти.

У блоці Voice номера має лишатися SIP Trunking: якщо там вибрати застосунок чи URL, Twilio відвʼяже номер від trunk, і дзвінки до AI не дійдуть.

Крок 4. Розділ «Голос по телефону» в Elbuz

1. Відкрийте картку AI-співробітника (див. де це і хто має доступ) і прокрутіть до «Голос по телефону».
2. «Номер телефону» — номер Twilio з кодом країни і плюсом, як він записаний у консолі Twilio: +12025550143 (формат номера).
3. «Оператор» — Twilio. Поле «Адреси оператора» для Twilio не потрібне: адреси Twilio Elbuz уже знає.
4. Увімкніть «Відповідати на дзвінки». Розділ зберігається сам за пів секунди після зміни поля — зверху зʼявляється «Налаштування голосу збережено».
5. Подзвоніть на номер Twilio зі свого мобільного. AI має відповісти, а розмова — зʼявитися в журналі дзвінків.

1

Рядок кроків

2

Номер Twilio

3

Оператор Twilio

4

SIP-адреса

5

Termination SIP URI

6

Логін з Credential List

7

Пароль з Credential List

8

Номер для клієнта

9

Пробний дзвінок

1. Зелене виконано; «Переадресуйте номер…» з оператором Twilio веде на цю статтю.
2. Ваш номер Twilio у форматі +код країни, як у консолі Twilio.
3. Twilio: адреси Twilio Elastic SIP Trunking Elbuz уже знає, адреси вводити не треба.
4. Для Twilio потрібен лише домен після «@» — він іде в Origination SIP URI.
5. Termination SIP URI вашого trunk виду <назва>.pstn.twilio.com; для Twilio обовʼязковий.
6. Username із Credential List, привʼязаного до Termination → Authentication.
7. Password того ж запису; після збереження поле показує крапки.
8. Номер Twilio, який побачить клієнт; порожньо — номер лінії.
9. Справжній дзвінок через Twilio — перевірка вихідних.

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

Для вихідних Elbuz набирає клієнта через Termination вашого trunk і входить у нього за логіном і паролем. Без цього кроку AI тільки відповідає.

Крок 1. Termination SIP URI

1. У trunk відкрийте вкладку Termination.
2. У поле Termination SIP URI впишіть унікальну назву — вийде адреса виду elbuz-shop.pstn.twilio.com. Скопіюйте її повністю.

Крок 2. Логін і пароль: Credential List

1. Консоль Twilio → Voice → Credential lists → створіть список і додайте в нього запис із Username і Password.
2. Поверніться в trunk: Termination → Authentication → Credential Lists → виберіть цей список → Save.

У Elbuz вписується Username самого запису, а не назва списку.

Крок 3. Блок «Вихідні дзвінки» в Elbuz

Перевірка — «Номер для пробного дзвінка» і кнопка «Пробний дзвінок»: це справжній дзвінок через Twilio на вказаний номер. Вихідні працюють лише з увімкненим «Відповідати на дзвінки». Як AI дзвонить з процесів — у розділі вихідні дзвінки статті про голосового AI.

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

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

Номер — з «+» і кодом країни

SIP-сервер не підставляється

Для Zadarma і Telnyx адреса сервера для вихідних відома заздалегідь, для Twilio — ні: у кожного trunk вона своя. Без «SIP-сервер» вихідних немає, навіть якщо логін і пароль вписані.

Крок «Переадресуйте номер» у рядку кроків

Крок «Переадресуйте номер у кабінеті оператора — інструкція» в рядку над полями зелений («Дзвінки надходять»), якщо за останні 30 днів на лінію приходив вхідний дзвінок. Поки він червоний, клік по ньому з оператором Twilio відкриває цю статтю.

Сценарії

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

Пройдіть чотири кроки вхідних і залиште блок «Вихідні дзвінки» порожнім. AI відповідатиме на номер Twilio, а розмови з резюме зʼявлятимуться в журналі й у стрічці клієнта.

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

Налаштуйте вихідні і зробіть «Пробний дзвінок». Потім зберіть процес Flows з блоком «AI-дзвінок» на створення замовлення (підтвердити замовлення). AI дзвонить лише в «Дзвонити в години».

Номер Twilio в одній країні, клієнти в іншій

Дозвольте країну клієнтів у Geo permissions і впишіть у «Номер для клієнта» номер Twilio, який належить вашому акаунту. Інакше Twilio відхилить вихідний.

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

Проблеми самої розмови — AI мовчить, обриває, не знає відповіді — у розборі статті Голосовий AI-співробітник.

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

Яку адресу вписати в Origination SIP URI Twilio?

sip:<домен>;transport=tcp, де домен — частина SIP-адреси з розділу «Голос по телефону» після @. Тільки домен, без номера: Twilio сам передає набраний номер. Адреса виду номер@домен потрібна для Zadarma.

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

Termination SIP URI вашого trunk — адресу виду назва.pstn.twilio.com з вкладки Termination. Без неї Elbuz відповідає «Вкажіть SIP-сервер оператора», і вихідних немає.

Де взяти логін і пароль лінії для Twilio?

Voice → Credential lists — створіть список із записом Username і Password, потім у trunk Termination → Authentication → Credential Lists виберіть його і збережіть. Username і Password вписуються в «Логін лінії» і «Пароль лінії».

Чи треба вписувати адреси Twilio?

Ні. З оператором Twilio Elbuz сам приймає дзвінки лише з адрес сигналізації Twilio Elastic SIP Trunking усіх регіонів. Поле «Адреси оператора» показується тільки для «Інший оператор».

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

Ні. Підключення API Twilio в «Зовнішніх сервісах» Elbuz немає, тож дзвінки співробітників через Twilio в журнал не потрапляють. У журнал потрапляють тільки розмови AI.

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

Ні. Лінія одна на акаунт: один номер, один AI-співробітник.

Суміжні теми

• Якщо треба налаштувати, що AI каже покупцям і коли дзвонить, — Голосовий AI-співробітник по телефону.
• Якщо AI-співробітника ще немає — AI-співробітники.
• Якщо потрібен і журнал дзвінків менеджерів, і AI на одному номері — Zadarma і Elbuz.
• Якщо ви ще обираєте оператора — Телефонія в Elbuz.