В этой статье вы узнаете, как создать необходимый аккаунт в Twilio, как настроить и подключить функцию SMS от Twilio к RemOnline.
Что такое Twilio?
Twilio - это платформа с коммуникационными API, которая позволяет разработчикам и компаниям легко интегрировать средства связи, такие как телефония, SMS, чаты и видео, в свои приложения и веб-сайт. С помощью Twilio можно отправлять текстовые сообщения, совершать телефонные звонки, настраивать автоматические ответы и многое другое. Нам Twilio поможет интегрировать SMS в RemOnline.
Создание аккаунта
Что нужно для начала?
Платный аккаунт Twilio. Новые пользователи могут создать бесплатный аккаунт и перейти на платную версию. Узнать о том, как перейти на платную версию можно в статье Как обновить аккаунт и купить номера в Twilio в разделе Как перейти на платную версию аккаунта Twilio?
Номер телефона Twilio. Узнать о том, как купить номер телефона Twilio можно в статье Как обновить аккаунт и купить номера в Twilio в разделе Как купить номер Twilio?
Важно: на данный момент покупка украинского номера невозможна в Twilio, поэтому подключение SMS by Twilio к Remonline недоступно, если вы находитесь в Украине и хотите использовать украинский номер. Если вы находитесь в другой стране, вы можете приобрести и использовать номер телефона с кодом этой страны, если такие номера доступны.
Следующий шаг для подключения SMS к RemOnline - создание Messaging Service.
Создание Messaging Service
Чтобы создать Messaging Service, перейдите в раздел Messaging > Services и нажмите Create Messaging Service.
Шаг 1. Определите название и цель сервиса
Messaging Service friendly name - придумайте название своему Messaging Service (например Order Chats)
Обратите внимание: это название будет отображаться только в Twilio. Ваши клиенты при получении сообщений будут видеть только номер, с которого получили SMS.
Select what you want to use Messaging for - выберите функцию, которая лучше всего подходит для ваших чатов.
Нажмите Create Messaging Service.
Шаг 2. Добавьте номер
Нажмите Add senders, выберите Phone Number и выберите номер для которого вы хотите включить Messenger Service. На этом же шаге вы можете дополнительно настроить выбранный номер.
Sticky Sender - обеспечивает последовательность коммуникации для получателей сообщений, выбирая тот же номер телефона отправителя, который вы ранее использовали в разговоре с данным клиентом.
Area Code Geomatch - отправляя сообщения в США и Канаду, используйте местные телефонные номера с кодом города, который совпадает или накладывается на номер телефона получателя.
Эти функции включены по умолчанию. Чтобы их отключить - нажмите на ползунок.
Также вы можете добавить еще номера, если не выбрали несколько номеров на предыдущем шаге, нажав на кнопку Add Senders или удалить уже добавленный номер, нажав Remove напротив него.
Отметьте те номера, которые вы хотите использовать, и нажмите Step 3. Set up integration.
Шаг 3. Настройте вебхуки
На этом шаге нужно настроить вебхуки для автоматизации процессов и для синхронизации данных между вашими учетными записями в Twilio и RemOnline.
Выберите опцию Send webhooks, и вставьте необходимые ссылки в следующие поля:
В полях Request URL и Fallback URL одна и та же ссылка:
В поле Callback URL:
Возле полей Request URL и Fallback URL должна стоять опция HTTP Post.
В поле Validity period мы рекомендуем оставить то значение, которое там стоит по умолчанию - 14400. Это количество секунд, в течение которых сообщения, отправленные с вашего почтового сервиса, будут оставаться на платформе Twilio. Если время, необходимое для отправки сообщения, превышает Validity period, Twilio отклоняет сообщение и отправляет запрос на ваш Callback URL, чтобы сообщить вам об ошибке.
Чтобы продолжить, нажмите Step 4: Add compliance info.
Шаг 4. Добавьте информацию о соблюдении требований
Важно: этот шаг является обязательным только если вы используете американский номер.
Это можно сделать с помощью регистрации для A2P 10DLC (10-значного кода) в США.
Это система в США, которая позволяет бизнесу отправлять сообщения из приложения человеку (A2P) с помощью 10-значных телефонных номеров (10DLC). Регистрация для A2P 10DLC через Twilio включает в себя несколько шагов:
настройка вашей учетной записи;
регистрацию вашего бренда;
регистрацию ваших сценариев использования
регистрацию телефонных номеров.
Заполнение формы занимает несколько минут, если вы подготовили всю нужную информацию. Окончательное одобрение вашей регистрации занимает 1-2 недели. Вы можете воспользоваться консолью Twilio, чтобы проверить свой статус регистрации US A2P 10DLC.
Вы можете завершить создание и настройку Messaging Service до окончательного одобрения вашей регистрации A2P 10DLC. Это позволит вам подготовить систему к полноценной работе сразу после завершения регистрации. Используйте это время для тестирования и настройки всех необходимых компонентов, чтобы обеспечить бесперебойную работу вашей службы.
Обратите внимание, что пока ваша регистрация не завершена, могут быть ограничения на количество и частоту отправляемых сообщений, а отправка больших объемов сообщений до завершения регистрации может привести к блокировке или снижению приоритета ваших сообщений.
Полностью ознакомиться с процессом регистрации A2P 10DLC можно здесь.
Итак, чтобы завершить создание Messaging Service, нажмите Complete Messaging Service Setup.
Готово! Последним шагом является подключение к RemOnline, после чего вы сможете использовать SMS для общения с вашими клиентами.
Подключение к RemOnline
Чтобы подключить номер SMS by Twilio к RemOnline:
1. На дашборде Twilio перейдите в раздел Account Info. Здесь вы найдете Account SID и Auth Token, которые вам нужны для подключения к чатам RemOnline. Скопируйте эти данные.
2. Затем перейдите в раздел Messaging > Services и найдите Messaging Service, которую вы создали. Скопируйте его Sid.
3. В RemOnline перейдите в раздел Настройки > Чаты и нажмите + Канал. Выберите ресурс SMS by Twilio.
4. Заполните все поля:
Название канала - придумайте название своему SMS каналу, который будете использовать для общения с клиентами.
Account SID - вставьте код Account SID скопированный с вашего Twilio аккаунта.
Важно: если канал с идентичным Account SID уже подключен другой компанией, система не позволяет подключить новый канал с тем же кодом в RemOnline. Чтобы это исправить, необходимо удалить уже имеющуюся интеграцию в другой компании, и тогда добавить канал с этим Account SID в RemOnline.
Auth Token - здесь вставьте код Auth Token, скопированный из вашего Twilio аккаунта.
Номер телефона - впишите тот номер телефона, который вы зарегистрировали в Twilio и будете использовать для общения с клиентами.
Обратите внимание: на один номер вы можете подключить только один канал. То есть, если у вас уже подключен канал WhatsApp на этот же номер, вы не сможете создать канал SMS.
Sid сервиса сообщений - здесь нужно вставить код Messaging Service Sid скопированный со страницы Messaging Service.
5. Настройте Доступ к каналу:
Все - доступ к настройке Чата будут иметь все сотрудники компании при условии, что такой доступ разрешен им системой;
Избранные - доступ к настройке Чата будут иметь только избранные сотрудники при условии, что такой доступ разрешен им системой;
Владелец - доступ к настройкам будет иметь только Владелец компании.
Чтобы поменять настройки доступа сотрудников к Чату и настроек Чата, нужно перейти в Настройки > Сотрудники > Роли и отредактировать необходимые настройки.
6. Нажмите Создать.
Готово! Теперь вы можете общаться с клиентами с помощью SMS непосредственно в RemOnline. Узнать больше о том, как работают чаты можно здесь.