...
Подсказка |
---|
Исключением являются случаи, когда необходимо отправить сообщение по нескольким каналам независимо от того, дошло оно по первому каналу или нет. Для этого существует параметр required (подробнее см. в разделе "Отправка уведомлений через API"). |
Message Box | ||||||
---|---|---|---|---|---|---|
| ||||||
|
CSS Stylesheet |
---|
...
Основные функции сервиса уведомлений:
Отправка текстовых уведомлений пользователям.
Отложенная отправка (сообщение отправится в установленное время). При необходимости можно отменить отправку сообщения до наступления установленного времени. Благодаря этому можно контролировать, что сообщение не придет пользователю в неположенное время (например
...
ночью).
Сокращение ссылок. Длинные ссылки сокращаются для уменьшения стоимости отправки сообщения. Это касается только канала SMS
...
.
Использование шаблонов. Чтобы не передавать каждый раз весь массив данных уведомления через API, можно создать шаблон, описывающий всю структуру сообщения, и менять только номер телефона или электронный адрес получателя и переменные.
Отправка уведомлений по различным каналам: SMS, e-mail, push, WhatsApp, Viber, Telegram, Vkontakte, Odnoklassniki, chat. По умолчанию сообщения отправляются последовательно: если сообщение было доставлено по одному из каналов, то по остальным каналам оно не отправляется.
Подсказка |
---|
Исключением являются случаи, когда необходимо отправить сообщение по нескольким каналам независимо от того, дошло оно по первому каналу или нет. Для этого существует параметр required (подробнее см. в разделе "Отправка уведомлений через API"). |
Отправка уведомлений при помощи заданий
Для отправки SMS-сообщений, рекламных сообщений, старта чат сессий, запуска чат сессий в WhatsApp, а также уведомлений с помощью API, выполните следующее:
...
Для отправки рекламных сообщений нужен идентификатор сессии с клиентом. Чтобы его получить, выполните следующие действия:
...
title | Инструкция по получению идентификатора сессии с клиентом |
---|
Для отправки рекламных сообщений нужен идентификатор сессии с клиентом. Чтобы его получить, выполните следующие действия:
...
Запуск отправки сообщений
Чтобы запустить отправку сообщений по подготовленному заданию на отправку, откройте вкладку Уведомления – Задания на отправку и нажмите кнопку в строке нужного задания.
Отправка уведомлений через API
Чтобы отправить уведомление через API, выполните следующие действия:
...
title | Инструкция по получению авторизационного токена |
---|
...
title | Инструкция по получению идентификатора шаблона |
---|
...
Примечание |
---|
Если вы использовали шаблон, то поле text будет проигнорировано. |
...
Примечание |
---|
Если у вас нет собственного имени отправителя, то используйте TwinService. |
...
Примечание |
---|
Если результат был отличен от 201, значит произошла какая-то ошибка и чат не отвязался. Проверьте заполнение обязательных полей и попытайтесь еще раз. |
Подсказка |
---|
Как создать запрос в сервис технической поддержки описано в этой статье. |
Старт чат-сессии в Telegram через API
Чтобы отправить сообщение в Telegram через API, нужно добавить Telegram-бота.
Добавление Telegram бота:
...
Подсказка |
---|
Как привязать бота к чату описано в этой статье. |
После привязки бота к чату нужно написать боту команду /start для начала чат-сессии.
Отправка уведомлений через разные каналы связи
Отправка через WhatsApp
Для того, чтобы отправлять сообщения через канал WhatsApp, необходимо получить бизнес-аккаунт в Facebook* и подключить чат к WhatsApp.
...
Содержание:
Дерево страниц | ||
---|---|---|
|
...
Примечание |
---|
В поле “Каковы ваши ожидаемые ежемесячные расходы на этот кейс?” минимальная сумма должна быть 100 евро. В противном случае, анкета не будет одобрена. |
5. После того, как ваша учетная запись WhatsApp будет одобрена и учетная запись настроена, мы сможем завершить процедуру OTP (One Time Password) для активации вашего номера с помощью WhatsApp API. Этот OTP можно отправить с помощью голосового вызова или SMS: предварительно согласовав время, вам поступит звонок или SMS (как вам будет удобнее) с уведомлением одноразового кода. Этот код нужно будет сообщить вашему партнеру или быть на связи с технической поддержкой. Время жизни кода всего 5 минут.
Примечание |
---|
Если номер телефона, указанный в анкете, ранее был привязан к WhatsApp, его необходимо отвязать (удалить аккаунт в приложении WhatsApp). |
6. 1 день на донастройку аккаунта WahtsApp и подключение к чатам TWIN.
После этого пользователь сможет создать и настроить шаблон для отправки уведомлений в WhatsApp и посмотреть, как будет выглядеть чат в WhatsApp с созданным им шаблоном.
При создании шаблона нужно заполнить поле Header, в который можно загрузить изображения, документы, видео и геолокацию, либо написать текст приветствия, который будет выделен в сообщении жирным шрифтом. Поле Body заполняется основным текстом сообщения. Также есть возможность добавить кнопки быстрых ответов в самом сообщении.
Затем шаблон отправляется на модерацию. После того как шаблон прошел модерацию и был одобрен, им можно пользоваться для отправки уведомлений в WhatsApp.
Примечание |
---|
Если пользователь не отвечал на сообщения бота в WhatsApp в течение 24 часов, бот не может отправлять ему сообщения. Если пользователь отвечает, бот может продолжать отправлять сообщения в течение следующих 24 часов с момента последнего сообщения. Чтобы бот снова мог отправлять сообщения пользователю, необходим согласованный с WhatsApp шаблон, который предоставляется сервисом технической поддержки Twin. |
...
Отправка через VKontakte
Для отправки уведомления VKontakte необходимо создать шаблон mail.ru.
Примечание |
---|
Чтобы создавать Шаблоны mail.ru, нужно подключить соответствующую услугу, обратитесь в сервис технической поддержки. |
Подсказка |
---|
Процесс создания шаблонов mail.ru описан в этой статье. |
Отправка уведомления vkontakte через API
Для того, чтобы отправить уведомление vkontakte с помощью API, необходимо выполнить запрос POST /messages и заполнить в его теле следующие параметры:
Блок кода | ||||||||
---|---|---|---|---|---|---|---|---|
| ||||||||
"vkontakte": {
"from": "string",
"templateName": "string",
"templateData": [
"string"
],
"text": "string",
"provider": "APN",
"attachments": [
"video-85635407_165186811",
"wall-92255884_16"
]
} |
from – зарегистрированное имя отправителя, которое отображается клиенту при получении сообщения в поле "От кого". Зарегистрированное имя отправителя, которое используется в системе по умолчанию: TwinService.
templateName – название системного шаблона, который используется для создания шаблонов уведомлений в следующих мессенджерах (whatsapp, chat, vkontakte, odnoklassniki).
templateData – список переменных, которые будут использоваться в сообщениях. Данный параметр используется только для шаблона мессенджера WhatsApp. Значения задаются в формате JSON (название переменной – формат).
text – текст сообщения.
attachments – вложения (например, изображения, аудио-файлы, документы), которые можно переслать в сообщении клиенту при помощи Vkontakte. Ограничение: не более 10 вложений в сообщении. Значение параметра задается в следующем формате: "<type><[-]owner_id>_<media_id>, photo|video|audio|doc|wall|market|poll".
а также дополнительные параметры:
messaging.providers.mailru.service: "twin_important"
messaging.providers.mailru.application: "twin"
messaging.providers.mailru.signatureKey -
Предупреждение |
---|
* Деятельность организации Meta Platforms Inc. и ее продуктов Instagram и Facebook запрещена в Российской Федерации. |
...