Подключите номер Twilio через SIP

Подключение номера Twilio в качестве внешнего номера SIP позволяет вашему голосовому агенту Versafy отвечать на вызовы на этот номер и использовать его в качестве номера вызывающего абонента для исходящих вызовов. Это полезно, если вы хотите сохранить номер и маршрутизацию вызовов в своей учетной записи Twilio при использовании Versafy в качестве телефонной службы AI.

Для обычного подключения Twilio без внешней SIP-магистрали используйте Подключите учетную запись Twilio и номер телефона. Он поддерживает полные входящие потоки с операторами, расписаниями, объявлениями и голосовой почтой.

Эта установка поддерживает:

входящие звонки с номера Twilio на один голосовой агент Versafy;
индивидуальные исходящие звонки от Голосового Агента;
исходящий Кампании, если он доступен для вашего рабочего места;
история звонков в Звонки и записи.

Ограничение внешнего входящего потока SIP: Внешний SIP-номер может быть назначен только активному Только ИИ Поток входящих вызовов без эскалации до человека. Если звонящим нужна маршрутизация оператора, ответвления в рабочее время, объявления или голосовая почта, вместо этого используйте собственное соединение Twilio Versafy. См. Потоки входящих вызовов.

Прежде чем начать

Подготовьте следующее:

учетная запись Twilio с разрешением на покупку номеров и управление Elastic SIP Trunks;
проект или субаккаунт Twilio, которому будет принадлежать как номер, так и соединительная линия;
разрешение управлять телефонными номерами и потоками входящих вызовов в Versafy;
активный Голосовой агент для входящих и исходящих звонков;
менеджер паролей для имени пользователя и пароля SIP-транка.

Пробные учетные записи Twilio ограничивают владение номером телефона и исходящие назначения. Обновите учетную запись Twilio перед использованием и проверкой в рабочей среде. Ограничения пробной учетной записи Twilio .

Обзор установки

Выполните подключение в следующем порядке:

Купите номер с поддержкой голосовой связи в Twilio.
Создайте эластичный SIP-магистраль Twilio.
Настроить транк Прекращение действия настройки исходящих звонков.
Начните импортировать номер в Versafy и скопируйте его входящий URI SIP.
Добавьте этот URI в транк Происхождение настройки входящих звонков.
Свяжите номер Twilio с магистралью.
Назначьте внешний номер SIP потоку входящих вызовов только для AI.
Тестируйте входящие и исходящие звонки.

1. Купите номер с поддержкой голосовой связи в Twilio.

Покупка выделенного номера дает клиентам общедоступный номер для звонков, а вашему голосовому агенту - утвержденный номер вызывающего абонента для исходящих вызовов.

Войдите в Консоль Твилио и выберите проект или субаккаунт, который вы собираетесь использовать.
Открыть Товары и услуги → Номера и отправители → Телефонные номера.
Выбрать Настройте новый номер телефона.
Выберите страну и тип номера, затем запросите Голос возможности в поисковых фильтрах.
Выберите номер, просмотрите текущие расходы и расходы за использование Twilio и завершите покупку.
Выполните любую идентификацию, адрес или нормативную регистрацию, запрошенную Twilio для этой страны и типа номера.
Скопируйте купленный номер в международном формате E.164, в том числе + и код страны, например, +12025550123.

Интерфейс Twilio может различаться в зависимости от учетной записи. См. Текущее руководство по настройке номера телефона Twilio если метки в вашей консоли различаются.

2. Создайте эластичный SIP-транк.

Магистральная линия — это двустороннее соединение между Twilio и Versafy. Одна сторона отправляет входящие вызовы вашему голосовому агенту; другой позволяет голосовому агенту совершать звонки через вашу учетную запись Twilio.

В консоли Twilio откройте Продукты и услуги → Эластичный SIP-транкинг → Управление → Магистрали.
Выбрать Создать новый ствол.
Введите узнаваемый Понятное имя, например Versafy Sales Line.
Сохраните багажник.

Держите багажник открытым в одной вкладке браузера, а Versafy — в другой. Твилио Руководство по гибкому SIP-транкингу объясняет текущие разделы консоли и терминологию.

3. Настройте Twilio Termination для исходящих вызовов.

Терминация позволяет Versafy отправить вызов в Twilio, который затем соединяет его с номером назначения клиента.

Откройте новый багажник Прекращение действия раздел.
Создайте уникальный SIP URI завершения, например versafy-sales.pstn.twilio.com.
Скопируйте полное имя хоста. Вы введете его в Versafy позже без sip: или порт.
В Аутентификация, создайте Список учетных данных.
Добавьте в список новое имя пользователя SIP и надежный уникальный пароль.
Свяжите этот список учетных данных с этой магистралью и сохраните настройки завершения.

Используйте имя пользователя и пароль из списка учетных данных SIP в Versafy, а не SID, токен аутентификации или пароль консоли Twilio. Twilio требует URI завершения плюс хотя бы один метод аутентификации, прежде чем соединительная линия сможет выполнять исходящие вызовы.

Если вы будете звонить по международным направлениям, включите в географических разрешениях Twilio Voice только те страны, которые нужны вашему бизнесу. См. Руководство Twilio по географическим разрешениям .

4. Импортируйте номер в Versafy.

Импорт делает номер, принадлежащий Twilio, доступным для Versafy без подключения всей учетной записи Twilio.

Навигация: Открыть Телефон → Номера телефонов, выберите Числа вкладка, затем выберите Добавить внешний номер (через SIP).

Введите ясность Этикетка, например Twilio Sales.
Введите купленное Номер телефона в формате E.164, включая + и код страны.
Развернуть Входящая конфигурация.
Под Входящая маршрутизация/URI источника, скопируйте полностью SIP-URI. Оставьте его без изменений; вы вставите его в Twilio в следующем разделе.
Держите Шифрование мультимедиа установлен на Разрешено для первоначального подключения.
Оставьте дополнительные фильтры входящих номеров, фильтры исходных адресов, список доменов, сопоставления заголовков и поля аутентификации без изменений, если у вашего администратора телефонии нет для них специальной политики.
Развернуть Исходящая конфигурация и введите:
- Адрес: имя хоста завершения Twilio, например versafy-sales.pstn.twilio.com. Не включать sip: или порт.
- Транспорт: TCP (рекомендуется).
- Шифрование мультимедиа: Отключено.
- Имя пользователя SIP-транка: имя пользователя из списка учетных данных Twilio.
- Пароль SIP-транка: пароль из того же списка учетных данных Twilio.
Оставьте дополнительные исходящие заголовки и кодеки пустыми для первоначальной настройки.
Выбрать Импорт.

Не включайте Twilio Безопасный транкинг для этой настройки TCP. Secure Trunking требует совпадения настроек TLS и зашифрованного мультимедиа с обеих сторон и отклоняет соединение, использующее указанные выше настройки.

5. Настройте Twilio Origination для входящих вызовов.

Origination сообщает Twilio, куда отправлять вызов, когда клиент набирает купленный вами номер.

Вернитесь в сундук в консоли Twilio и откройте. Происхождение.
Выбрать Добавить новый URI происхождения.
Введите Понятное имя, например Versafy inbound.
Вставьте полный URI SIP, скопированный из Versafy. Он включает номер телефона, хост, порт и transport=tcp настройка.
Сохраните URI Включено.
Для одного URI сохраните значения приоритета и веса Twilio по умолчанию.
Сохраните настройки происхождения.

Не заменяйте номер внутри URI, удалите transport=tcp, измените схему на sips:или вставьте сюда имя хоста завершения Twilio. Twilio документирует поведение Origination URI в своем Руководство по настройке Elastic SIP Trunking .

6. Свяжите номер Twilio с соединительной линией.

Привязка номера активирует соединительную линию в качестве входящего голосового маршрута для номера.

Изменение маршрута: Привязка номера к этой соединительной линии заменяет предыдущую конфигурацию входящей голосовой связи в Twilio. Прежде чем продолжить, убедитесь, что номер не обслуживает другое производственное приложение.

Откройте багажник Числа раздел.
Выбрать Свяжите номер с этим транком.
Выберите приобретенный номер и подтвердите привязку.
Убедитесь, что номер отображается в списке номеров соединительной линии.

Если вместо этого Twilio откроет страницу конфигурации номера, выберите SIP-транкинг для входящих голосовых вызовов выберите эту соединительную линию и сохраните.

7. Назначьте поток входящих вызовов только для AI.

Входящий поток выбирает, какой голосовой агент ответит на этот номер.

В Versafy откройте Телефон → Номера телефонов → Потоки входящих вызовов.
Создайте поток, используя Только ИИ шаблон.
Выберите импортированный внешний номер SIP и голосовой агент, который должен ответить.
Просмотрите, создайте и активируйте поток.
Вернуться в Числа вкладку и убедитесь, что число отображается Последовательность входящих вызовов прикреплена и предполагаемое имя потока.

Если вы создали поток до импорта номера, найдите номер в разделе Числа, выбирай Подключение к потоку входящих вызовови выберите активный поток «Только AI».

8. Проверьте оба направления вызова

Тестирование в обоих направлениях подтверждает, что назначения номера, соединительной линии, аутентификации и Versafy работают вместе.

Тестируйте входящие звонки

Позвоните на номер Twilio с телефона, не входящего в учетную запись Twilio.
Убедитесь, что ожидаемый голосовой агент отвечает правильным вступительным сообщением.
Задайте один обычный тестовый вопрос, а затем завершите разговор.
Открыть Телефон → Журналы вызовов и записи и подтвердите появление вызова.

Тестирование исходящих звонков

Открыть Телефон → Голосовые агенты.
Найдите активный агент и выберите Позвонить.
Выберите импортированный номер Twilio в качестве номера вызывающего абонента.
Введите тестовый пункт назначения в формате E.164 и подтвердите вызов.
Ответьте на звонок и проверьте двустороннюю аудиосвязь.
Проверить Звонки и записи прежде чем повторить неудачную или неясную попытку.

Вы также можете просмотреть Эластичный SIP-транкинг → Журналы в Твилио. Twilio обеспечивает дополнительные проверки соединительных линий Проверьте свой эластичный SIP-транк .

Устранение неполадок

Внешний номер SIP не отображается при исходящих вызовах.

Подтвердите, что импорт завершен, отображается число Исходящий трафик включен под Телефон → Номера телефонов → Номера, и голосовой агент активен. Открыть Редактировать на внешнем номере и проверьте исходящий адрес и учетные данные.

Исходящие вызовы завершаются ошибкой аутентификации

Убедитесь, что список учетных данных прикреплен к той же магистрали Twilio и что Versafy Имя пользователя SIP-транка и Пароль SIP-транка точно соответствовать этому. Не используйте учетные данные учетной записи Twilio.

Исходящие вызовы завершаются сбоем до звонка

Проверьте это:

Адрес содержит только имя хоста завершения Twilio;
пункт назначения включает в себя + и код страны;
Twilio разрешает звонки в эту страну назначения;
пробная учетная запись звонит в пункт назначения, проверенный Twilio;
Номер Twilio остается во владении того же проекта или субаккаунта, что и магистральный канал.

Входящие звонки не доходят до Versafy

Убедитесь, что номер Twilio связан с правильной магистралью, URI происхождения включен и точно соответствует значению, скопированному из Versafy, а внешний номер назначен активному потоку только AI.

Для внешнего номера SIP поток не доступен.

Только активный Только ИИ потоки без эскалации к человеку приемлемы. Создайте или активируйте этот тип потока или используйте собственное соединение Twilio, если вам нужен более сложный путь звонящего.

Вызов подключается, но звук отсутствует или односторонний

Убедитесь, что Twilio Secure Trunking отключен для этой настройки и что настройки шифрования мультимедиа Versafy соответствуют этому руководству. Если вы ограничили Разрешенные исходные IP-адреса, включать все текущие диапазоны сигналов Twilio, а не только один регион; обзор Текущий список IP-адресов SIP-транкинга Twilio .

Если Twilio сообщает об ошибке неподдерживаемого носителя, отредактируйте внешний номер SIP и добавьте PCMU/8000 или PCMA/8000 под Включенные кодеки. Твилио руководство по устранению неполадок в багажнике перечисляет кодеки, которые он принимает.

Вам необходимо изменить импортированный номер телефона.

Вы можете редактировать его метку и настройки SIP, но не сам номер E.164. Отключите его от любого потока, удалите внешний номер SIP из Versafy и снова импортируйте правильный номер. Удаление его из Versafy не освобождает номер от вашей учетной записи Twilio.