...

Функциональность сервиса уведомлений.

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

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

2. Отложенная отправка (сообщение отправится в

...

1. установленное время

...

1. ). При необходимости можно отменить отправку сообщения до наступления

...

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

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

...

1. . Это касается только канала

...

1. SMS.
   
   

2. Использование шаблонов.

...

1. Чтобы не передавать каждый раз весь массив

...

1. данных уведомления через API, можно

...

1. создать шаблон, описывающий всю структуру сообщения, и менять только номер телефона или

...

1. электронный адрес получателя и переменные.
   
   

2. Отправка уведомлений по различным каналам:

...

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

...

1. сообщение было доставлено

...

1. по

...

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

Для отправки смс сообщений, рекламных сообщений, старта чат сессий, запуска чат сессий в WhatsApp, а также уведомлений с помощью API через систему TWIN необходимо зайти во вкладку “Уведомления” и выбрать подраздел “Задания на отправку”.

Image Removed

Затем нажать “Добавление нового задания на отправку сообщений”.

Image Removed

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

Далее необходимо открыть загруженный шаблон и заполнить его согласно таблице описания полей.

Image Removed

Затем загрузить заполненный шаблон в то же задание на отправку и нажать на “Создать”.

Подробнее (см. здесь).

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

Для отправки уведомлений через API необходимо создать шаблон на отправку сообщений. Для этого нужно открыть вкладку “Уведомления”, выбрать подраздел “Шаблоны” и открыть нужный шаблон.

Image Removed

Заполнить все поля.

Image Removed

Затем перейти на страницу https://tcl.twin24.ai/doc/notify/index.html и выполнить запрос POST /messages.

Image Removed

Для этого необходимо заполнить тело запроса.

Задать следующие параметры: 

groupId - идентификатор группы, в случае, если нужно отправить одно сообщение сразу на несколько устройств одного человека; 

taskId - идентификатор задачи;

useShortLinks -  использование коротких ссылок (значения true/false); 

sendAt - отложенная отправка - заранее подготовленное сообщение отправится в определенный промежуток времени;

allowedTimeRanges - разрешенный период отправки, указывается время в формате H:i:s (ЧЧ:ММ:СС);

templateId - идентификатор шаблона (например, 0de36c39-46a2-4426-b16c-c2a86e844311);

destinations - направление отправки, например, номер телефона получателя или email;

variables - переменные - значения, которые могут меняться (например, дата);

channels - каналы отправки (sms, email, WhatsApp и т.д.), в каждом канале можно указать текст сообщения, даже если он не указан в шаблоне, в этом случае текст, указанный в канале, является приоритетным.

...

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

...

Image Removed

Дополнительные параметры:

imageUrl - ссылка на изображение

buttonUrl - ссылка, которая открывается после нажатия на кнопку

buttonText - кнопка с текстом

validityPeriod - период времени, в течение которого отправитель получает уведомление о доставке сообщения (в минутах).

Для отправки уведомлений по разным каналам (WhatsApp, Vkontakte и т.д.) на странице https://tcl.twin24.ai/doc/notify/index.html есть примеры тела запроса.

Image Removed Image Removed

Если запрос успешно отправлен, в личном кабинете TWIN во вкладке “Просмотр сообщений” изменится статус сообщения на “Отправляется”, а затем на “Доставлено”.

Image Removed

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

WhatsApp

Содержание:

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

1. Пользователю необходимо убедиться, что его бизнес соответствует Коммерческой политике WhatsApp: https://www.whatsapp.com/legal/commerce-policy/
   А также, убедиться, что сообщения будут соответствовать политике WhatsApp Business:
   https://www.whatsapp.com/legal/business-policy/
2. Заполнить анкету https://forms.gle/6a8fJohENvwhVPhC9
3. Подтвердить бизнес-аккаунт Facebook https://www.facebook.com/business/help/2058515294227817
4. Принять запрос для WhatsApp Business API. (После заполнения анкеты примерно через 2-3 дня) https://business.facebook.com/settings/requests

Image Removed

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

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

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

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

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

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

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

...

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

Vkontakte

Для отправки уведомления Vkontakte необходимо создать шаблон, для этого нужно открыть вкладку “Шаблоны mail.ru” и нажать “Новый шаблон”.

Image Removed

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

Image Removed

Чат-сессии

На странице Настройки отображается список всех чатов, которые вы можете разместить на страницах вашего сайта или привязать к социальным сетям и/или сторонним сервисам при помощи API.

Image Removed

В верхней части страницы находится кнопка для создания нового чата.

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

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

• Получить кода фрейма;
• Подключить чат к социальной сети Facebook;
• Посмотреть диалоги пользователей;
• Изменить свойства чата;
• Удалить чат.

Запуск чат-сессий через API

Чат-сессии запускаются через канал “chat” в теле запроса на отправку сообщений . 

Для этого нужно заполнить следующие параметры:

chatId - идентификатор чата;

botId - идентификатор бота (для того, чтобы в чат-сессии с пользователем общался не тот бот, который привязан к чату, а другой бот, необходимо ввести botId нужного бота);

MessengerType - тип мессенджера, в который направляется чат-сессия. Если этот параметр не задан, чат-сессия направится в последний используемый мессенджер.

Image Removed

...