Оглавление indent 0px separator brackets
| indent | 0px |
|---|---|
| separator | brackets |
Функциональность сервиса уведомлений
Основные функции сервиса уведомлений:
Отправка текстовых уведомлений пользователям
Отложенная отправка (сообщение отправится в определенное время, установленное заранее). При необходимости можно отменить отправку сообщения до наступления заранее установленного времени. Благодаря этому можно контролировать, что сообщение не придет пользователю в неположенное время (ночью).
Сокращение ссылок. Длинные ссылки сокращаются для уменьшения стоимости отправки сообщения, это касается только канала sms (подробнее см. в разделе "Отправка уведомлений через API").
Использование шаблонов. Для того, чтобы не передавать каждый раз весь массив данных уведомления через API, можно собрать шаблон, описывающий всю структуру сообщения, и менять только номер телефона или email получателя и переменные.
Отправка уведомлений по различным каналам: sms, e-mail, push, WhatsApp, Viber, Telegram, Vkontakte, Odnoklassniki, chat. По умолчанию сообщения отправляются последовательно: если по одному из каналов сообщение было доставлено, то по остальным каналам оно не отправляется. Исключением являются случаи, когда необходимо отправить сообщение по нескольким каналам, независимо от того, дошло оно по первому каналу или нет, для этого существует параметр required (подробнее см. в разделе "Отправка уведомлений через API").
Отправка уведомлений при помощи задания на отправку
Для отправки смс сообщений, рекламных сообщений, старта чат сессий, запуска чат сессий в WhatsApp, а также уведомлений с помощью API через систему TWIN необходимо зайти во вкладку Уведомления и выбрать подраздел Задания на отправку.
Затем нажать Добавление нового задания на отправку сообщений.
Указать наименование здания, затем выбрать тип уведомления, после этого автоматически будет загружен шаблон для данного типа уведомления.
Далее необходимо открыть загруженный шаблон и заполнить его согласно таблице описания полей.
Затем загрузить заполненный шаблон в то же задание на отправку и нажать на Создать.
Подробнее (см. здесь).
| панель | ||||
|---|---|---|---|---|
| ||||
| Отправка уведомлений через API |
Для отправки уведомлений через API необходимо создать шаблон на отправку сообщений. Для этого нужно открыть вкладку Уведомления, выбрать подраздел Шаблоны и открыть нужный шаблон.
Заполнить все поля.
Затем перейти на страницу страницу https://tcl.twin24.ai/doc/notify/index.html и и выполнить запрос запрос POST /messages.
Для этого необходимо заполнить тело запроса.
Задать следующие параметры:
groupId groupId - идентификатор группы, в случае, если нужно отправить одно сообщение сразу на несколько устройств одного человека;
taskId - идентификатор задачи;
useShortLinks - использование коротких ссылок (значения true/false);
sendAt - отложенная отложенная отправка - заранее подготовленное сообщение отправится в определенный промежуток времени (2018-10-31T11пример: 11:56:07+00:00, отправитель может устанавливать конкретный часовой пояс);allowedTimeRanges allowedTimeRanges - разрешенный период отправки, указывается время в формате H:i:s (ЧЧ:ММ:СС);
templateId - идентификатор шаблона (например, 0de36c39-46a2-4426-b16c-c2a86e844311);
destinations destinations - направление отправки, например, номер телефона получателя или email;
variables - переменные - variables - ячейки, хранящие в себе определенные значения, которые могут меняться (например, дата, имя получателя, для этого необходимо задать переменную {name});
channels channels - каналы отправки (sms, email, WhatsApp и т.д.), в каждом канале можно указать текст сообщения, даже если он не указан в шаблоне, в этом случае текст, указанный в канале, является приоритетным.
Если сообщение не дошло по одному каналу (например, sms), оно отправляется по следующему каналу (например, Viber), если же сообщение дошло, то дальше по остальным каналам оно не отправляется. Но если все-таки необходимо отправить сообщение по дополнительному каналу, помимо sms (например, Viber), независимо от того, дошло оно по каналу sms или нет, в параметрах этого канала нужно установить required: true
Дополнительные параметры:
imageUrl - ссылка на изображение
buttonUrl - ссылка, которая открывается после нажатия на кнопку
buttonText - кнопка с текстом
validityPeriod 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.
После этого пользователь сможет создать и настроить шаблон для отправку уведомлений в WhatsApp и посмотреть, как будет выглядеть чат в WhatsApp с созданным им шаблоном.
При создании шаблона необходимо заполнить поле "Header" (заголовок), в который можно загрузить изображения, документы, видео и геолокацию, либо написать текст приветствия, который будет выделен в сообщении жирным шрифтом. Поле "Body" заполняется основным текстом сообщения. Также есть возможность добавить кнопки быстрых ответов в самом сообщении.
Затем шаблон отправляется на модерацию. После того, как шаблон прошел модерацию и был одобрен, им можно пользоваться для отправки уведомлений в WhatsApp.
| Информация |
|---|
Примечание: если пользователь не отвечал на сообщения бота в WhatsApp в течение 24 часов, бот не может отправлять ему сообщения. Если пользователь отвечает, бот может продолжать отправлять сообщения в течение следующих 24 часов с момента последнего сообщения. Для того, чтобы бот снова мог отправлять сообщения пользователю, необходим согласованный с WhatsApp шаблон, который предоставляется техподдержкой сервиса TWIN. |
Vkontakte
Для отправки уведомления Vkontakte необходимо создать шаблон, для этого нужно открыть вкладку Шаблоны mail.ru и нажать Новый шаблон.
После этого откроется окно создания шаблона, которое нужно заполнить в соответствии с правилами https://notify.mail.ru/#notifications. Нажать кнопку Сохранить.
2) В поле поле Имя шаблона укажите укажите имя создаваемого шаблона. По этому имени вы позднее сможете идентифицировать шаблон в списке.
3) В поле Email поле Email укажите электронный адрес, который вы использовали для регистрации страницы в социальных сетях "Vkontakte" и "Одноклассники".
4) В поле поле Тело шаблона общее для всех введите введите текст сообщения, который который будет отображаться для пользователей социальных сетей "Vkontakte" и "Одноклассники".
5) В поле поле Тело шаблона для Вконтакте введите введите текст сообщения, которое будет отображаться только пользователей социальной сети "Vkontakte".
| Подсказка |
|---|
Если данное поле не заполнено, то система отправит пользователям социальной сети "Вконтакте" текст, который указан в общем шаблоне. |
6) В поле поле Группа Вконтакте укажите укажите url-адрес группы пользователей в социальной сети "Vkontakte", которым нужно отправить сообщение.
7) В поле поле Тело шаблона для Одноклассники введите введите текст сообщения, которое будет отправлено только пользователям социальной сети "Одноклассники".
| Подсказка |
|---|
| Если данное поле не заполнено, то система отправит пользователям социальной сети "Одноклассники" текст, который указан в общем шаблоне. |
8) В поле поле Группа Одноклассники Одноклассники укажите url-адрес группы пользователей в социальной сети "Одноклассники", которым нужно отправить сообщение.
9) Для сохранения изменений нажмите кнопку кнопку Сохранить.
Чат-сессии
На странице Настройки странице Настройки отображается список всех чатов, которые вы можете разместить на страницах вашего сайта или привязать к социальным сетям и/или сторонним сервисам при помощи API.
В верхней части страницы находится кнопка для создания нового чата.
Чуть ниже расположено поле поиска, при помощи которого вы можете быстро найти нужный чат. Для поиска чата введите в поле название чата или сценария, который в нем используется. Результаты поиска отображаются автоматически.
| Подсказка |
|---|
| Вы также можете выполнить поиск по неполному совпадению. Для этого в поле поиска укажите только часть названия чата или сценария. |
Под полем поиска отображается список всех созданных чатов. В правой части списка расположены кнопки, при помощи которых вы можете выполнить следующие действия:
- Получить кода фрейма;
- Подключить чат к социальной сети Facebook;
- Посмотреть диалоги пользователей;
- Изменить свойства чата;
- Удалить чат.
Для создания нового чата выберите в боковом меню меню Чаты - Настройки и и нажмите кнопку кнопку Новый чат.
Откроется следующее окно:
В поле Название поле Название введите название чата. По названию вы сможете найти чат в списке.
В поле поле Выберите сценарий сценарий укажите сценарий, который бот будет использовать в диалогах с пользователями.
В поле поле Время жизни сессии задайте задайте продолжительность периода неактивности пользователя, по истечении которого диалог с пользователем будет завершен. Период неактивности задается в секундах.
В поле Сценарий Сценарий, когда операторы не в сети, выберите сценарий, который будет использовать робот, если оператор не в сети.
В поле поле Текст, когда операторы заняты введите введите текст сообщения, которое робот будет отправлять пользователю, если согласно сценарию диалог нужно перевести на оператора, но все операторы заняты и никто не может ответить.
Если по окончании сессии требуется запросить у пользователя отзыв о диалоге, установите соответствующий флажок. В поле ниже укажите период времени с начала диалога, по завершении которого система запросит у пользователя отзыв.
В поле поле Тип отзыва выберите выберите шкалу, по которой пользователь сможет оценить качество диалога. Для выбора доступны следующие варианты:
- 2-х бальная оценка;
- 5-ти бальная оценка;
- 10-ти бальная оценка.
В полях полях Цвет робота, Цвет оператора, Цвет пользователя, Цвет кнопок и и Цвет текста кнопок при при помощи палитры цветов выберите нужный цвет в диалоге. Для выбора цвета на палитре служат два горизонтальных ползунка. Вы также можете ввести RGBA, HSLA или HEX код цвета. Копки с пиктограммами стрелок вверх и вниз позволяют переключаться между соответствующими цветовыми моделями, а также отобразить поле для ввода HEX кода цвета.
В полях полях Аватар робота, Аватар оператора и и Аватар чата можно можно загрузить изображения, которые система будет использовать в качестве аватаров. Вы можете загрузить изображения с расширением .jpeg и .png размером не более 5 МБ. Данные поля не являются обязательными. Если вы не загрузите изображения, система будет использовать изображения по умолчанию.
Установите флажок в поле поле Запросить результат диалога, чтобы по окончании диалога система запросила у пользователя результат.
В поле поле Через несколько секунд запросить отзыв о диалоге введите введите период времени в секундах с момента начала диалога, по завершению которого пользователю отобразится запрос с просьбой выполнить промежуточную оценку диалога.
Чтобы робот ответил на первое сообщение пользователя, установите в поле ниже соответствующий флажок.
В разделе разделе Ссылки на мессенджеры можно можно указать ссылки на мессенджеры и социальные сети. Кнопки с пиктограммами указанных мессенджеров и социальных сетей будут отображаться рядом с кнопкой виджета. При нажатии на любую из этих кнопок пользователь сможет начать общение в любом из указанных вами мессенжержов мессенжеров или начать общение в виджете, а затем продолжить свой диалог в мессенджере или социальной сети.
| Подсказка |
|---|
| В данном разделе производится только настройка ссылок на мессенджеры и социальные сети. Чтобы пользователь мог общаться с ботом в мессенджерах и социальных сетях, необходимо интегрировать бота с указанными мессенджерами и социальными сетями (подробнее об см. Инструкция по интеграции чатов с мессенджерами). |
Вы можете указать ссылки на следующие мессенджеры и социальные сети:
- Yandex Алиса;
- Facebook messenger;
- Vkontakte;
- Whatsapp;
- Telegram;
- WeChat;
- Viber;
- Slack;
- Skype;
- Номер телефона (звонок боту на номер телефона);
- Одноклассники;
- Line Chat.
Чтобы сохранить изменения, нажмите кнопку кнопку Создать чат.
Теперь созданный пользователем чат появится в его личном кабинете.
Запуск чат-сессий через API
Чат-сессии запускаются через канал “chat” в теле запроса на отправку сообщений .
Для этого нужно зайти на страницу https://tcl.twin24.ai/doc/notify/index.html и выполнить запрос POST /messages.
В теле запроса в канале chat заполнить следующие параметры:
chatId - идентификатор чата;
botId - идентификатор бота (для того, чтобы в чат-сессии с пользователем общался не тот бот, который привязан к чату, а другой бот, необходимо ввести botId нужного бота);
MessengerType - тип мессенджера, в который направляется чат-сессия. Если этот параметр не задан, чат-сессия направится в последний используемый мессенджер;
chatSessionName - название чат-сессии (любая строка на усмотрение пользователя - будет указана в отчете и при переводе на оператора);
Дополнительные параметры:
continueLastOrStartNewSession - продолжение последней чат-сессии либо начало новой (если задать значение true, сервис попытается продолжить открытую сессию, если таких нет - открывается новая, если значение false - сразу открывается новая чат-сессия).