Інтеграція Zadarma та Twilio дозволяє направляти вхідні дзвінки з віртуальних номерів Zadarma в ваш Twilio та обробляти їх згідно з вашим поточними налаштуваннями Twilio. Ви також можете здійснювати вихідні дзвінки з Twilio через ваш акаунт в Zadarma за вигідними тарифами Zadarma.
1. Налаштування вхідних дзвінків входящих звонков
Додавання SIP-домену в Twilio.
У вашому акаунті Twilio відкрийте розділ Twilio Console → Voice → SIP Domains та натисніть на кнопку + для додавання нового домену.
Приклад налаштувань SIP-домену:
FRIENDLY NAME - ім'я домену, наприклад zadarma;
SIP URI - домен, довільна назва, для зручності можна використовувати віртуальний номер.
В секції Voice Authentication додайте по черзі IP ACCESS CONTROL LISTS, які будуть містити довірчі IP адреси Zadarma, з яких Twilio буде приймати вхідні дзвінки.
FRIENDLY NAME - sipurifr.zadarma.com
CIDR NETWORK ADDRESS - 185.45.152.216 /32
FRIENDLY NAME - sipuriny.zadarma.com
CIDR NETWORK ADDRESS - 185.45.155.33 /32
FRIENDLY NAME - pbxfr1.zadarma.com
CIDR NETWORK ADDRESS - 185.45.152.164 /32
FRIENDLY NAME - pbxfr2.zadarma.com
CIDR NETWORK ADDRESS - 185.45.152.177 /32
FRIENDLY NAME - pbxfr3.zadarma.com
CIDR NETWORK ADDRESS - 185.45.152.200 /32
FRIENDLY NAME - pbxny1.zadarma.com
CIDR NETWORK ADDRESS - 185.45.155.14 /32
FRIENDLY NAME - pbxny2.zadarma.com
CIDR NETWORK ADDRESS - 185.45.155.16 /32
FRIENDLY NAME - pbxlv1.zadarma.com
CIDR NETWORK ADDRESS - 195.122.19.20 /32
FRIENDLY NAME - pbxlv2.zadarma.com
CIDR NETWORK ADDRESS - 195.122.19.29 /32
FRIENDLY NAME - pbxsg1.zadarma.com
CIDR NETWORK ADDRESS - 15.235.128.70 /32
FRIENDLY NAME - pbxal1.zadarma.com
CIDR NETWORK ADDRESS - 31.31.222.201 /32
FRIENDLY NAME - pbxma1.zadarma.com
CIDR NETWORK ADDRESS - 185.45.154.15 /32
Переконайтеся, що всі додані IP ACCESS CONTROL LISTS обрані в налаштуваннях SIP домену.
Нижче, в секції Call Control Configuration в параметрі A CALL COMES IN оберіть, що саме буде керувати вхідними дзвінками, якщо у вас вже налаштована маршрутизація вхідних дзвінків у Twilio - оберіть ваш варіант, наприклад Studio та ваш Flow (сценарій) для вхідних дзвінків, натисніть Save для збереження налаштувань вашого SIP-домену.
Приклад Flow (сценарій) для вхідних дзвінків▾
Якщо ви обрали свій варіант в A CALL COMES IN - пропустіть цей пункт, тут показаний приклад створення простого Flow для вхідних дзвінків у візуальному редакторі Twilio Studio.
1. Перейдіть в Twilio Console → Studio та натисніть кнопку Create new Flow. Введіть FLOW NAME наприклад Incoming calls.
2. Оберіть шаблон Start from scratch та натисніть Next.
3. Перетягніть блок Gather Input on Call (для меню IVR) та з'єнайте з Trigger (Incoming Call).
4. Вкажіть голосове повідомлення (Text to Speech або Audio URL).
5. Налаштуйте обробку вибору (1 – у відділ продажів, 2 – в підтримку і т. і.).
Далі необхідно створити два Set Variables для модифікації номеру абонента, що телефонує, з заголовку From.
Створіть перший Set Variables з Variable Name: step1_caller_id та Value:
Додайте перехід вхідного дзвінка на екстеншен, за допомогою Connect Call To.
CONNECT CALL TO – оберіть SIP Endpoint.
В SIP ENDPOINT введіть його URL, наприклад sip:11111@15551111111.sip.twilio.com
В CALLER ID
{{flow.variables.clean_caller_id}}
Збережіть налаштуваня віджетів та опублікуйте Flow, натиснувши Publish.
Далі в налаштуваннях SIP Domain в секції SIP Registration необхідно увімкнути можливість реєструватись, перемкнувши тумблер в Enabled.
Нижче необхідно в CREDENTIAL LISTS обрати існуючий SIP Endpoint, який буде приймати вхідні дзвінки, за допомогою софтфона. Якщо у вас ще немає SIP Endpoint - створіть його, натиснувши на кнопку "+".
Добавление SIP Endpoint▾
Якщо у вас вже є SIP Endpoint - пропустіть цей етап.
В налаштуваннях внутрішнього номеру, навпроти параметру "Переадресація та голосова пошта" натисніть "Увімкнути".
Оберіть умову переадресації, наприклад "Завжди".
В параметрі "Переадресація на" оберіть "Зовнішній сервер (SIP URI)".
У полі, що з'явилось, введіть адресу 15551111111@15551111111.sip.twilio.com
- де 15551111111.sip.twilio.com – це ваш SIP URI з налаштуваня SIP-домен в Twilio.
Натисніть "Зберегти".
Налаштування вхідних дзвінків завершено.
2. Налаштування вихідних дзвінків з Twilio
Вихідні дзвінки з Twilio можна здійснювати декількома способами, розглянемо приклад ініціації дзвінка через Twilio REST API (Calls API).
У наступному прикладі буде показано створення конференції між SIP Endpoint, на якому налаштовано софтфон та зовнішній номер (дзвінок через Zadarma).
У прикладі використовуватиметься python-скрипт, перед початком переконайтеся, що у вашій системі встановлено python та бібліотека twilio (www.twilio.com/docs/libraries/reference/twilio-python).
Для автентифікації запиту потрібно використовувати Account SID та Auth Token ви можете їх знайти в Twilio в Account Dashboard в лівому верхньому кутку сторінки.
Для авторизації вихідного дзвінка буде використовуватись внутрішній номер АТС та пароль з особистого кабінету Zadarma.
Створіть скрипт call.py з наступним вмістом:
from twilio.rest import Client
# Twilio облікові дані
ACCOUNT_SID = "Account_SID_value"
AUTH_TOKEN = "Auth_Token_value"
TWILIO_NUMBER = "+15559999999" # Підтверджений номер в Twilio для Caller ID
CONFERENCE_NAME = "MyConferenceRoom"
# Zadarma SIP облікові дані
ZADARMA_SIP_URI = "sip:+525500000777@sip.zadarma.com" # Куди телефонуємо через Zadarma
ZADARMA_SIP_USER = "12345" # замість 12345 має бути ваш sip-логін з Zadarma
ZADARMA_SIP_PASSWORD = "my_sip_password" # Пароль від sip-логіну Zadarma
# SIP Endpoint (локальний)
SIP_ENDPOINT = "sip:11111@15551111111.sip.twilio.com" # Ваш SIP Endpoint, на якому налаштований софтфон для прийому дзвінків
# Ініціалізація Twilio клієнта
client = Client(ACCOUNT_SID, AUTH_TOKEN)
# Функція додавання учасника до конференції
def add_to_conference(to_number, from_number=None, sip_auth_user=None, sip_auth_password=None):
call_params = {
"to": to_number,
"from_": from_number if from_number else TWILIO_NUMBER,
"twiml": f"""<Response>
<Dial>
<Conference>{CONFERENCE_NAME}</Conference>
</Dial>
</Response>"""
}
# Додаємо аутентифікацію
if sip_auth_user and sip_auth_password:
call_params["sip_auth_username"] = sip_auth_user
call_params["sip_auth_password"] = sip_auth_password
call = client.calls.create(**call_params)
print(f"Виклик на {to_number} розпочато, SID: {call.sid}")
# Запуск дзвінків
add_to_conference(ZADARMA_SIP_URI, from_number=TWILIO_NUMBER, sip_auth_user=ZADARMA_SIP_USER, sip_auth_password=ZADARMA_SIP_PASSWORD) # Дзвінок на зовнішній номер через Zadarma
add_to_conference(SIP_ENDPOINT) # Підключаємо SIP Endpoint
print(f"Конференцію '{CONFERENCE_NAME}' створено!")
from twilio.rest import Client
# Twilio облікові дані
ACCOUNT_SID = "Account_SID_value"
AUTH_TOKEN = "Auth_Token_value"
TWILIO_NUMBER = "+15559999999" # Підтверджений номер в Twilio для Caller ID
CONFERENCE_NAME = "MyConferenceRoom"
# Zadarma SIP облікові дані
ZADARMA_SIP_URI = "sip:+525500000777@pbx.zadarma.com" # Куди телефонуємо через Zadarma
ZADARMA_SIP_USER = "1234-100" # замість 1234-100 має бути ваш внутрішній номер АТС Zadarma
ZADARMA_SIP_PASSWORD = "my_pbx_password" # Пароль від внутрішнього номеру АТС Zadarma
# SIP Endpoint (локальний)
SIP_ENDPOINT = "sip:11111@15551111111.sip.twilio.com" # Ваш SIP Endpoint на якому налаштований софтфон для прийому дзвінків
# Ініціалізація Twilio клієнта
client = Client(ACCOUNT_SID, AUTH_TOKEN)
# Функція додавання учасника до конференції
def add_to_conference(to_number, from_number=None, sip_auth_user=None, sip_auth_password=None):
call_params = {
"to": to_number,
"from_": from_number if from_number else TWILIO_NUMBER,
"twiml": f"""<Response>
<Dial>
<Conference>{CONFERENCE_NAME}</Conference>
</Dial>
</Response>"""
}
# Додаємо аутентифікацію
if sip_auth_user and sip_auth_password:
call_params["sip_auth_username"] = sip_auth_user
call_params["sip_auth_password"] = sip_auth_password
call = client.calls.create(**call_params)
print(f"Виклик на {to_number} розпочато, SID: {call.sid}")
# Запуск дзвінків
add_to_conference(ZADARMA_SIP_URI, from_number=TWILIO_NUMBER, sip_auth_user=ZADARMA_SIP_USER, sip_auth_password=ZADARMA_SIP_PASSWORD) # Дзвінок на зовнішній номер через Zadarma
add_to_conference(SIP_ENDPOINT) # Підключаємо SIP Endpoint
print(f"Конференцію '{CONFERENCE_NAME}' створено!")
Збережіть та запустіть ваш скрипт call.py. Якщо все налаштовано правильно, дзвінки надійдуть до софтфону та на зовнішній номер від вашого SIP-логіна Zadarma.
Збережіть та запустіть ваш скрипт call.py. Якщо все налаштовано правильно, дзвінки надійдуть до софтфону та на зовнішній номер від вашого внутрішнього номеру віртуальної АТС Zadarma.
Продовжуючи використовувати наш сайт, Ви даєте згоду на обробку файлів Cookies і даних користувача, докладніше в нашій Політиці Cookie. Якщо Ви не хочете, щоб Ваші дані оброблялися, будь ласка, покиньте сайт.
Цей сайт потребує певних файлів Cookies, які технічно необхідні для роботи сайту. Ми також хотіли б встановити додаткові файли Cookies, аби поліпшити наш сервіс. Ми не будемо встановлювати додаткові файли Cookies, якщо ви їх не ввімкнете. Ви можете змінити свій вибір у будь-який час на сторінці нашої Політики Cookie.