RCS-сообщения через Twilio

RCS-сообщения (Rich Communication Services) приходят во встроенное приложение для сообщений на телефоне в виде чата от вашего бренда: с вашим логотипом и карточкой, каруселью, медиа или кнопками вместо простого текста. Pushwoosh отправляет их через Twilio в рамках канала SMS.

Как это работает

RCS-сообщение проходит путь от шаблона Twilio до телефона в три шага:

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

Если вы выбрали шаблон только для некоторых языков пресета, остальные языки не отправляются по RCS. Они уходят обычным SMS с текстом из поля Сообщение.

Резервное SMS

Резервное SMS — это то, что получают телефоны без поддержки RCS вместо RCS-сообщения. Если телефон получателя или его оператор не поддерживает RCS, Twilio отправляет SMS, собранное из типа Text шаблона.

Резервное SMS берется из шаблона, а не из поля Сообщение пресета. Если в шаблоне нет типа Text, телефоны без RCS сообщение не получат вовсе.

Что нужно для отправки RCS

RCS работает только через ваш собственный аккаунт Twilio с Messaging Service и RCS-отправителем, одобренным операторами.

Twilio в качестве SMS-провайдера. Подключите его с вашими собственными Account SID и Auth token Twilio. Если номер Twilio и учетные данные для вашего проекта предоставляет Pushwoosh, RCS недоступен, и такие отправки отклоняются.
Messaging Service в Twilio. Его пул отправителей содержит RCS-отправителя и номер для SMS. Его SID указывается в поле Messaging Service SID в настройках платформы SMS. Без него сообщение с шаблоном не отправится.
Номер отправителя (From). Укажите в настройках платформы SMS номер для SMS из пула Messaging Service. Без него Pushwoosh не отправляет SMS через Twilio, даже если Messaging Service задан.
RCS-отправитель, одобренный операторами в странах, куда вы отправляете сообщения. Регистрацией занимается Twilio. По данным Twilio, она занимает 4–6 недель или дольше в каждой стране.

Настройка RCS в Twilio

Эти шаги выполняются в Twilio Console. Названия меню взяты из руководства Twilio по подключению RCS и в вашей консоли могут немного отличаться.

Создание RCS-отправителя

RCS-отправитель — это профиль бренда, который получатели видят в чате: ваше название, логотип и цвета.

Перейдите в Communications → Numbers & senders → Overview → RCS.
Нажмите Create RCS Sender.
Введите Sender display name.
Примите условия и нажмите Continue.
На шаге Public details заполните все поля:
- Display name и Description.
- Logo image (224×224 px, до 50 КБ) и Banner image (1440×448 px, до 200 КБ) в виде публичных URL файлов JPG или PNG.
- Accent color с коэффициентом контрастности не менее 4.5:1 относительно белого, например #1A73E8.
- Контактный номер телефона или email, Privacy policy URL и Terms of service URL.
Нажмите Next.

Добавление тестового телефона

Пока операторы не одобрили отправителя, он доставляет сообщения только на тестовые телефоны.

На шаге Try it out нажмите Add device to test this sender.
Введите номер телефона Android в международном формате и нажмите Invite.
На телефоне откройте приглашение в Google Messages и нажмите Make me a tester.
В консоли убедитесь, что владелец принял приглашение.
Отправьте сообщение из Your message. Оно должно прийти как чат от вашего бренда с логотипом, а не как SMS.

Регистрация отправителя у операторов

Twilio добавляет RCS-отправителя в Messaging Service только после того, как его одобрил хотя бы один оператор, поэтому начните регистрацию до создания Messaging Service.

В RCS-отправителе откройте Compliance registration.
Нажмите Add countries.
Выберите страны, куда вы отправляете сообщения, и нажмите Save countries.
Нажмите Start.
Заполните форму и нажмите Submit registration. Для США в Twilio есть отдельная форма US registration.

Статус регистрации отображается как Pending Review, пока операторы ее не одобрят.

Создание Messaging Service

Messaging Service объединяет RCS-отправителя и номер для SMS, чтобы Twilio мог выбирать RCS или SMS для каждого телефона.

Перейдите в Messaging → Services.
Создайте сервис.
В Sender Pool добавьте номер Twilio с поддержкой SMS. Без него телефоны без RCS ничего не получат.
Как только хотя бы одна страна в Compliance registration получит статус Approved, добавьте RCS-отправителя в Sender Pool.
Скопируйте SID сервиса. Он начинается с MG.

Создание контентного шаблона

Контентный шаблон определяет RCS-сообщение и его резервное SMS.

Перейдите в Messaging → Content Template Builder.
Нажмите Create new.
Выберите тип с поддержкой RCS: Card, Carousel, Quick reply, Call to action или Media.
Заполните содержимое. Для значения, которое меняется от получателя к получателю, используйте нумерованную переменную, например {{1}} для имени в заголовке карточки.
Чтобы ветвить Journey по ответу, добавьте кнопки быстрого ответа и задайте каждой ID. Не используйте default или ID, начинающийся с output: для такой кнопки в Journey не создается ветка.
Добавьте в тот же шаблон тип Text. Из него Twilio собирает резервное SMS.
Сохраните шаблон.

Подключение Twilio в Pushwoosh

Pushwoosh отправляет RCS с учетными данными Twilio и Messaging Service, которые вы указываете в настройках платформы SMS.

Перейдите в Настройки → Настройка платформ.
Откройте SMS.
Выберите SMS-провайдера Twilio.
Заполните поля:
- From number: номер для SMS из пула Messaging Service.
- Account SID и Auth token: учетные данные аккаунта Twilio, которому принадлежат RCS-отправитель и шаблоны.
- Messaging Service SID (optional): SID Messaging Service, начинающийся с MG. Для SMS поле необязательно, но для RCS оно нужно.
Нажмите Применить.

Остальные настройки SMS описаны в разделе Настройка SMS-платформы. Для статусов доставки RCS-сообщений настраивать веб-хук не нужно: Pushwoosh передает Twilio URL для статусов доставки вместе с каждым сообщением.

Получение ответов

Ответы на RCS-сообщения попадают в Pushwoosh только через веб-хук, заданный в RCS-отправителе.

В Twilio Console откройте RCS-отправителя и перейдите в Configuration.
В поле Webhook URL for incoming messages укажите URL для входящих SMS из раздела Веб-хуки SMS-провайдеров с методом POST.
Нажмите Save configuration.

Pushwoosh обрабатывает ответ на RCS так же, как ответ на SMS. Он вызывает событие PW_SMSReceived для номера телефона отправителя, а ответ STOP устанавливает тег маркетингового согласия подписчика в значение false. См. Согласие на маркетинговые SMS и Viber.

Отправка RCS-сообщения

RCS-сообщение уходит везде, где вы отправляете пресет SMS с шаблоном.

Откройте или создайте пресет SMS.
Выберите шаблон Twilio для каждого языка в блоке RCS, как описано в разделе Отправка по RCS.
Отправьте пресет в SMS-кампании или в Customer Journey.

В Journey элемент SMS с шаблоном быстрых ответов получает ветку для каждой кнопки и ждет нажатия до 24 часов. См. Ветвление по кнопкам ответа RCS.

Проверка статистики RCS

Чтобы узнать, сколько доставок подтверждено по RCS, сколько пришло как SMS и какая доля получателей RCS прочитала сообщение, откройте Message stats этой отправки.