| Оглавление |
|---|
Функциональность сервиса уведомлений.
Основные функции сервиса уведомлений:
- Отправка текстовых уведомлений пользователям
- Отложенная отправка (сообщение отправится в определенное время, установленное заранее). При необходимости можно отменить отправку сообщения до наступления заранее установленного времени. Благодаря этому можно контролировать, что сообщение не придет пользователю в неположенное время (ночью).
- Сокращение ссылок. Длинные ссылки сокращаются для уменьшения стоимости отправки сообщения, это касается только канала sms (подробнее см. здесь).
- Использование шаблонов. Для того, чтобы не передавать каждый раз весь массив данных уведомления через API, можно собрать шаблон, описывающий всю структуру сообщения, и менять только номер телефона или email получателя и переменные.
- Отправка уведомлений по различным каналам: sms, e-mail, push, WhatsApp, Viber, Telegram, Vkontakte, Odnoklassniki, chat. По умолчанию сообщения отправляются последовательно: если по одному из каналов сообщение было доставлено, то по остальным каналам оно не отправляется. Исключением являются случаи, когда необходимо отправить сообщение по нескольким каналам, независимо от того, дошло оно по первому каналу или нет, для этого существует параметр required (подробнее см. здесь).
Отправка уведомлений при помощи задания на отправку
Для отправки смс сообщений, рекламных сообщений, старта чат сессий, запуска чат сессий в WhatsApp, а также уведомлений с помощью API через систему TWIN необходимо зайти во вкладку “Уведомления” и выбрать подраздел “Задания на отправку”.
Затем нажать “Добавление нового задания на отправку сообщений”.
Указать наименование здания, затем выбрать тип уведомления, после этого автоматически будет загружен шаблон для данного типа уведомления.
Далее необходимо открыть загруженный шаблон и заполнить его согласно таблице описания полей.
Затем загрузить заполненный шаблон в то же задание на отправку и нажать на “Создать”.
Подробнее (см. здесь).
Отправка уведомлений через API
Для отправки уведомлений через API необходимо создать шаблон на отправку сообщений. Для этого нужно открыть вкладку “Уведомления”, выбрать подраздел “Шаблоны” и открыть нужный шаблон.
Заполнить все поля.
Затем перейти на страницу https://tcl.twin24.ai/doc/notify/index.html и выполнить запрос POST /messages.
Для этого необходимо заполнить тело запроса.
Задать следующие параметры:
groupId - идентификатор группы, в случае, если нужно отправить одно сообщение сразу на несколько устройств одного человека;
taskId - идентификатор задачи;
useShortLinks - использование коротких ссылок (значения true/false);
sendAt - отложенная отправка - заранее подготовленное сообщение отправится в определенный промежуток времени;
allowedTimeRanges - разрешенный период отправки, указывается время в формате H:i:s (ЧЧ:ММ:СС);
templateId - идентификатор шаблона (например, 0de36c39-46a2-4426-b16c-c2a86e844311);
destinations - направление отправки, например, номер телефона получателя или email;
variables - переменные - значения, которые могут меняться (например, дата);
channels - каналы отправки (sms, email, WhatsApp и т.д.), в каждом канале можно указать текст сообщения, даже если он не указан в шаблоне, в этом случае текст, указанный в канале, является приоритетным.
Если сообщение не дошло по одному каналу (например, sms), оно отправляется по следующему каналу (например, Viber), если же сообщение дошло, то дальше по остальным каналам оно не отправляется. Но если все-таки необходимо отправить сообщение по дополнительному каналу, помимо sms (например, Viber), независимо от того, дошло оно по каналу sms или нет, в параметрах этого канала нужно установить required: true
Дополнительные параметры:
imageUrl - ссылка на изображение
buttonUrl - ссылка, которая открывается после нажатия на кнопку
buttonText - кнопка с текстом
validityPeriod - период времени, в течение которого отправитель получает уведомление о доставке сообщения (в минутах).
Для отправки уведомлений по разным каналам (WhatsApp, Vkontakte и т.д.) на странице https://tcl.twin24.ai/doc/notify/index.html есть примеры тела запроса.
Если запрос успешно отправлен, в личном кабинете TWIN во вкладке “Просмотр сообщений” изменится статус сообщения на “Отправляется”, а затем на “Доставлено”.
Отправка уведомлений через разные каналы
Для того, чтобы отправлять сообщения через канал WhatsApp, необходимо получить бизнес-аккаунт в facebook и подключить чат к WhatsApp.
- Пользователю необходимо убедиться, что его бизнес соответствует Коммерческой политике WhatsApp: https://www.whatsapp.com/legal/commerce-policy/
А также, убедиться, что сообщения будут соответствовать политике WhatsApp Business:
https://www.whatsapp.com/legal/business-policy/ - Заполнить анкету https://forms.gle/6a8fJohENvwhVPhC9
- Подтвердить бизнес-аккаунт Facebook https://www.facebook.com/business/help/2058515294227817
- Принять запрос для WhatsApp Business API. (После заполнения анкеты примерно через 2-3 дня) https://business.facebook.com/settings/requests
Важно: в поле “Каковы ваши ожидаемые ежемесячные расходы на этот кейс?” минимальная сумма должна быть 100 евро.
В противном случае, анкета не будет одобрена.
5. После того, как ваша учетная запись WhatsApp будет одобрена и учетная запись настроена, мы сможем завершить процедуру OTP (One Time Password) для активации вашего номера с помощью WhatsApp API. Этот OTP можно отправить с помощью голосового вызова или SMS: предварительно согласовав время, вам поступит звонок или SMS (как вам будет удобнее) с уведомлением одноразового кода. Этот код нужно будет сообщить вашему партнеру или быть на связи с технической поддержкой. Время жизни кода всего 5 минут.
Важно: если номер телефона, указанный в анкете, ранее был привязан к WhatsApp, его необходимо отвязать (удалить аккаунт в приложении WhatsApp).
6. 1 день на донастройку аккаунта WahtsApp и подключение к чатам TWIN.