Сравнение версий

Ключ

  • Эта строка добавлена.
  • Эта строка удалена.
  • Изменено форматирование.


...

Подсказка

Исключением являются случаи, когда необходимо отправить сообщение по нескольким каналам независимо от того, дошло оно по первому каналу или нет. Для этого существует параметр required (подробнее см. в разделе "Отправка уведомлений через API").

Message Box
iconnone
titleНа этой странице:
typegeneric
Оглавление
CSS Stylesheet

...

Основные функции сервиса уведомлений:

  1. Отправка текстовых уведомлений пользователям.

  2. Отложенная отправка (сообщение отправится в установленное время). При необходимости можно отменить отправку сообщения до наступления установленного времени. Благодаря этому можно контролировать, что сообщение не придет пользователю в неположенное время (например

...

  1. ночью).

  2. Сокращение ссылок. Длинные ссылки сокращаются для уменьшения стоимости отправки сообщения. Это касается только канала SMS

...

  1. .

  2. Использование шаблонов. Чтобы не передавать каждый раз весь массив данных уведомления через API, можно создать шаблон, описывающий всю структуру сообщения, и менять только номер телефона или электронный адрес получателя и переменные.

  3. Отправка уведомлений по различным каналам: SMS, e-mail, push, WhatsApp, Viber, Telegram, Vkontakte, Odnoklassniki, chat. По умолчанию сообщения отправляются последовательно: если сообщение было доставлено по одному из каналов, то по остальным каналам оно не отправляется.

Подсказка

Исключением являются случаи, когда необходимо отправить сообщение по нескольким каналам независимо от того, дошло оно по первому каналу или нет. Для этого существует параметр required (подробнее см. в разделе "Отправка уведомлений через API").

Отправка уведомлений при помощи заданий

Для отправки SMS-сообщений, рекламных сообщений, старта чат сессий, запуска чат сессий в WhatsApp, а также уведомлений с помощью API, выполните следующее:

...

Для отправки рекламных сообщений нужен идентификатор сессии с клиентом. Чтобы его получить, выполните следующие действия:

...

titleИнструкция по получению идентификатора сессии с клиентом

Для отправки рекламных сообщений нужен идентификатор сессии с клиентом. Чтобы его получить, выполните следующие действия:

...

Запуск отправки сообщений

Чтобы запустить отправку сообщений по подготовленному заданию на отправку, откройте вкладку УведомленияЗадания на отправку и нажмите кнопку Image Removed в строке нужного задания.

Image Removed

Отправка уведомлений через API

Чтобы отправить уведомление через API, выполните следующие действия:

...

titleИнструкция по получению авторизационного токена

...

titleИнструкция по получению идентификатора шаблона

...

Примечание

Если вы использовали шаблон, то поле text будет проигнорировано.

...

Примечание

Если у вас нет собственного имени отправителя, то используйте TwinService.

...

Примечание

Если результат был отличен от 201, значит произошла какая-то ошибка и чат не отвязался. Проверьте заполнение обязательных полей и попытайтесь еще раз. 
Если ничего не получилось, то напишите нам в техническую поддержку.

Подсказка

Как создать запрос в сервис технической поддержки описано в этой статье.

Старт чат-сессии в Telegram через API

Чтобы отправить сообщение в Telegram через API, нужно добавить Telegram-бота.

Добавление Telegram бота:

...

Подсказка

Как привязать бота к чату описано в этой статье.

После привязки бота к чату нужно написать боту команду /start для начала чат-сессии.

Отправка уведомлений через разные каналы каналы связи

Отправка через WhatsApp

Для того, чтобы отправлять сообщения через канал WhatsApp, необходимо получить бизнес-аккаунт в Facebook* и подключить чат к WhatsApp.

...

Информация
Важно: в поле “Каковы ваши ожидаемые ежемесячные расходы на этот кейс?” минимальная сумма должна быть 100 евро.

Image Removed

В противном случае, анкета не будет одобрена.

5. После того, как ваша учетная запись WhatsApp будет одобрена и учетная запись настроена, мы сможем завершить процедуру OTP (One Time Password) для активации вашего номера с помощью WhatsApp API. Этот OTP можно отправить с помощью голосового вызова или SMS: предварительно согласовав время, вам поступит звонок или SMS (как вам будет удобнее) с уведомлением одноразового кода. Этот код нужно будет сообщить вашему партнеру или быть на связи с технической поддержкой. Время жизни кода всего 5 минут.

Информация
Важно: если номер телефона, указанный в анкете, ранее был привязан к WhatsApp, его необходимо отвязать (удалить аккаунт в приложении WhatsApp).

6. 1 день на донастройку аккаунта WahtsApp и подключение к чатам TWIN.

После этого пользователь сможет создать и настроить шаблон для отправку уведомлений в WhatsApp и посмотреть, как будет выглядеть чат в WhatsApp с созданным им шаблоном.

При создании шаблона необходимо заполнить поле "Header" (заголовок), в который можно загрузить изображения, документы, видео и геолокацию, либо написать текст приветствия, который будет выделен в сообщении жирным шрифтом. Поле "Body" заполняется основным текстом сообщения. Также есть возможность добавить кнопки быстрых ответов в самом сообщении.

Затем шаблон отправляется на модерацию. После того, как шаблон прошел модерацию и был одобрен, им можно пользоваться для отправки уведомлений в WhatsApp.


Содержание:

Дерево страниц
rootОтправка уведомлений

...

Примечание: если пользователь не отвечал на сообщения бота в WhatsApp в течение 24 часов, бот не может отправлять ему сообщения. Если пользователь отвечает, бот может продолжать отправлять сообщения в течение следующих 24 часов с момента последнего сообщения. Для того, чтобы бот снова мог отправлять сообщения пользователю, необходим согласованный с WhatsApp шаблон, который предоставляется техподдержкой сервиса TWIN.

...

Отправка через Vkontakte

Для отправки уведомления Vkontakte необходимо создать шаблон mail.ru.

Примечание

Чтобы создавать Шаблоны mail.ru, нужно подключить соответствующую услугу, обратитесь в сервис технической поддержки.

Подсказка

Процесс создания шаблонов mail.ru описан в этой статье.

Отправка уведомления vkontakte через API

Для того, чтобы отправить уведомление vkontakte с помощью API, необходимо выполнить запрос POST /messages и заполнить в его теле следующие параметры:

Блок кода
languagepy
themeDJango
firstline1
linenumberstrue
"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 запрещена в Российской Федерации.

...