В этой статье вы узнаете, как настроить интеграцию RemOnline с сервисом Twilio Voice.
Важно: эта интеграция доступна начиная с тарифа Стартап.
Настройка интеграции в Twilio
Первым делом создайте и активируйте номер телефона в своем аккаунте Twilio. Это можно сделать на странице Phone numbers > Manage > Active numbers.
О том, как купить номер телефона Twilio можно узнать здесь.
Важно: на данный момент покупка украинского номера невозможна в Twilio. Если вы находитесь в другой стране, вы можете приобрести и использовать номер телефона с кодом этой страны, если такие номера доступны.
Шаг 1. Настройка маршрутизации и вебхуков для вашего номера телефона
Скопируйте значение Notifications address в окне настройки интеграции в RemOnline. Для этого перейдите на страницу Настройки > Интеграции в аккаунте RemOnline, найдите интеграцию Twilio Voice и нажмите кнопку Настроить.
В своем аккаунте Twilio перейдите в раздел Phone numbers > Manage > Active numbers и нажмите на активный номер телефона.
В разделе Voice Configuration настройте нужную маршрутизацию.
Ниже установите значение Webhook в поле A call comes in. Далее вставьте значение, которое вы скопировали ранее из вашей учетной записи RemOnline, в поле URL. В поле HTTP выберите значение HTTP GET.
Сохраните изменения внизу страницы.
Шаг 2. Добавьте пользователей (Credentials)
Перейдите в Voice > Manage > Credential lists в вашей учетной записи Twilio и нажмите кнопку "+". Чтобы создать нового пользователя, вы должны указать Friendly Name, Username и Password.
После создания пользователя вы можете перейти к следующему шагу.
Шаг 3. Создание SIP-домена
Перейдите на страницу Voice > Manage > SIP Domains в вашем аккаунте Twilio и нажмите кнопку "+".
Вы можете ввести любое значение в поле Friendly Name.
В поле SIP URI нужно указать уникальное значение. Вы будете использовать это значение для добавления sip-домена к софтфону.
Далее выберите пользователя, которого вы создали на предыдущем шаге, в разделе Voice Authentication > Поле Credential lists.
Затем включите SIP Registration и выберите пользователя в поле Credentials lists. Сохраните изменения внизу страницы.
Шаг 4. Подключение SIP-клиента
1. В этом разделе нужно создать TwiML Bin с таким кодом:
<?xml version="1.0" encoding="UTF-8"?>
<Response>
<Dial answerOnBridge="true" callerId="Your_Twilio_Number">{{#e164}}{{To}}{{/e164}}</Dial>
</Response>
Запомнить, присвоив имя к примеру "Outgoing".
2. В разделе прописать этот бин в свойствах SIP-домена и нажать "Сохранить".
Настройка интеграции в RemOnline
1. Перейдите на страницу Настройки > Интеграции, найдите интеграцию Twilio Voice и нажмите Настроить.
2. Заполните поля Account SID и Токен авторизации. Значения этих полей можно найти в вашем аккаунте Twilio в разделе Account Info.
3. Добавьте номер телефона.
Нажмите кнопку "+ Внутренний номер".
Введите ваш активный номер телефона в Twilio в поле Номер (адрес). Вы можете найти его в своем аккаунте Twilio в разделе Account Info.
Обратите внимание, что номер телефона является уникальным, и вы не можете добавить 2 трубки с одинаковыми номерами.
В поле Имя трубки вы можете указать любое имя.
В поле SIP укажите sip-домен в следующем формате:
имя пользователя - Friendly Name пользователя от Twilio
доменное имя - SIP URI sip-домена от Twilio
Далее вам нужно предоставить сотрудникам доступ к этому номеру телефона.
Обратите внимание, что если сотрудник не имеет доступа, он не сможет увидеть карточку входящего звонка для этого номера.
Нажмите кнопку Сохранить.
4. Установите флажок "Интеграция включена", и сохраните изменения.
Поздравляем! Настройка завершена.
Если все сделано правильно, при нажатии на номер телефона клиента появится список трубок, с которых можно инициировать звонок. Если на эту трубку поступит звонок, в правом нижнем углу экрана появится карточка входящего звонка.
Как подключить SIP-домен из Twilio к вашему софтфону
Когда вы добавляете sip-домен к вашему софтфону, поле "Domain" должно иметь следующее значение:
domain-name.sip.us1.twilio.com
domain-name - это SIP URI sip-домена от Twilio
us1 - значение маршрутизации, которое вы выбрали в Twilio
В поле Username и Password вы должны ввести информацию, которую вы указали при создании пользователя в своей учетной записи Twilio в разделе Credential lists.