Подключите Twilio к приложению MonstarX

КраткоTwilio отправляет SMS с номера телефона, который вы у него арендуете. Вставьте SID аккаунта, токен авторизации и номер Twilio в разделе «Облачные сервисы» → «Облако», а затем попросите MonstarX о нужных сообщениях, например «отправляй участникам SMS-напоминание за день до занятия».

Отправляйте SMS и коды подтверждения, совершайте звонки.

Тип: Для вашего приложения
Категория: Сообщения, почта и звонки
Как подключить: Ключ API

Twilio — сервис для сообщений и звонков. Вы арендуете у Twilio номер телефона, и приложение отправляет с него SMS — такие сообщения люди действительно читают, причём часто уже через несколько минут.

Что можно с этим создать?

Напоминания: «Ваше занятие начнётся завтра в 7:00».
Статусы заказа и доставки: «Ваш заказ готов к выдаче».
Коды для входа или подтверждения по SMS на номер телефона.
Оповещения для команды, например SMS менеджеру, когда приходит крупный заказ.
Кнопку «Отправить ссылку по SMS», которая присылает страницу человеку на телефон.

Что понадобится

Аккаунт Twilio. Twilio берёт плату за каждое сообщение и ежемесячную плату за номер; цены зависят от страны (см. цены Twilio).
Номер Twilio, с которого можно отправлять SMS.
Пробные аккаунты могут отправлять SMS только на номера, подтверждённые в Twilio, и только в стране регистрации. Перейдите на платный аккаунт до того, как сообщения понадобятся настоящим клиентам.
В некоторых странах (например, в США) нужно зарегистрировать номер или бизнес, прежде чем SMS начнут доставляться. Консоль Twilio проведёт вас через этот процесс.

Получите ключи

Войдите в Twilio Console.
На главной странице консоли скопируйте Account SID (он начинается с AC) и Auth Token.
Если номера ещё нет, получите его (Phone Numbers → Buy a number или пробный номер, который предлагает Twilio). Скопируйте его в международном формате: знак плюс, код страны и номер без пробелов, например +61412345678.

Подключите ключи в MonstarX

Откройте проект, нажмите Облачные сервисы на верхней панели, затем Облако.
В разделе Подключения нажмите Подключить рядом с Twilio.
Вставьте значения в поля SID аккаунта и Токен авторизации, а номер Twilio — в поле Номер отправителя.
Нажмите Подключить Twilio. В строке появится Подключено, и предпросмотр перезапустится уже с ключами.

Если вы сначала попросите функцию с SMS, MonstarX покажет те же поля в карточке в чате. Если аккаунта Twilio ещё нет, нажмите Позже: MonstarX создаст всё целиком, а функция будет сообщать, что Twilio не подключён, пока вы не добавите ключи.

Как попросить MonstarX

Вы пишете	Что происходит
«Отправляй участникам SMS-напоминание за день до каждого занятия, на которое они записались.»	Поле для номера телефона в профиле и напоминание по SMS.
«Когда заказ отмечен как готовый, отправляй клиенту SMS.»	SMS уходит сразу, как только вы меняете статус заказа.
«При регистрации спрашивай номер телефона и присылай шестизначный код для подтверждения.»	Код приходит по SMS и проверяется, прежде чем номер сохранится.
«Пиши мне на +61412345678 каждый раз, когда кто-то записывается на индивидуальное занятие.»	SMS на ваш телефон о каждой новой записи.

Безопасность и конфиденциальность

Токен авторизации секретный: он хранится в зашифрованном виде, и пользуется им только сервер приложения. SID аккаунта и номер отправителя не секретные, но тоже остаются на сервере.
Номера телефонов, которые собирает приложение, хранятся в его базе данных в том же международном формате.
Подключить, обновить или отключить Twilio может только владелец проекта. Кнопка Отключить удаляет ключи из этого приложения.
Чтобы сменить токен, создайте новый в Twilio Console, затем нажмите Обновить ключи в строке Twilio, вставьте его и нажмите Сохранить ключи. Опубликуйте приложение заново, чтобы рабочая версия перешла на новый токен.

Полезно знать

По умолчанию MonstarX создаёт текстовые сообщения (SMS). Twilio умеет ещё отправлять сообщения в WhatsApp и совершать голосовые звонки. Попросите их явно и сначала настройте на стороне Twilio (для WhatsApp нужен одобренный отправитель).
Ответы клиентов приходят на ваш номер Twilio. Чтобы что-то с ними делать, попросите MonstarX обрабатывать входящие SMS и укажите адрес, который он даст, в настройках номера в Twilio.
Каждое сообщение оплачивается с вашего аккаунта Twilio — в том числе те, что отправляет предпросмотр, пока вы тестируете.

Вопросы и ответы

Почему тестовое SMS так и не пришло?

С пробного аккаунта Twilio можно отправлять SMS только на номера, подтверждённые в Twilio. Подтвердите свой номер в Twilio Console или перейдите на платный аккаунт.

В каком формате указывать номера телефонов?

В международном формате, со знаком плюс и без пробелов, например +61412345678. Номера, которые собирает приложение, MonstarX хранит так же.

Может ли приложение отправлять сообщения в WhatsApp?

Да, через Twilio, после того как вы настроите в Twilio отправителя WhatsApp. Попросите MonstarX о WhatsApp явно.

Берёт ли MonstarX плату за SMS?

Нет. Twilio выставляет счёт за каждое сообщение вашему аккаунту, а MonstarX ничего не добавляет.