Настройка сервера для отправки оповещений в Viber
Данная статья описывает 2 основных момента:
- Создание бота Viber
- Настройка Fort Monitor 3 для включения возможности отправки извещений по событиям конкретному пользователю Viber.
Предварительные требования:
- Зарегистрированный аккаунт в Viber
- Установленное приложение Viber на смартфоне
- Fort Monitor обязан работать по протоколу https. Если он не настроен на работу с https - регистрация бота Viber невозможна.
Создание бота
Для создания бота в Viber необходимо перейти на страницу создания бота. В предложенном окне ввести номер телефона (тот, на который зарегистрирован ваш аккаунт Viber). Viber пришлет код подтверждения, необходимо его ввести
Затем нажать кнопку "Создать бот":
- Account Image – картинка максимального размера 400x400, которая будет отображаться в профиле бота и как значок в сообщениях;
- Account Name – имя, которое будет отображаться в заголовке у бота;
- URI – идентификатор, по которому можно будет найти бота. Он будет участвовать в настройке сервера и формировании быстрой ссылки на бот. Можно оставить по умолчанию, он сгенерируется на основе указанного имени бота;
- Category – выберите одну из 7 основных категорий;
- Subcategory – выберите из списка подкатегорию, в которой будет функционировать ваш бот;
- Language – выберите основной язык;
- Account Description – описание создаваемого бота;
- Website Address – по желанию можно указать адрес вашего сайта;
- Email Address – адрес электронной почты;
- Location – местоположение — необходимо выбрать путем указания на карте местоположения вашего офиса
Поставить галку о принятии соглашения и нажать кнопку "Create".
После этого будет выдано сообщение, что бот создан. И будет отображен токен для использования бота — его необходимо скопировать для дальнейшей настройки Fort Monitor.
Затем необходимо зайти в приложение Viber на смартфоне, в нижней панели нажать на пункт "Еще", в нем зайти в раздел "Настройки" и перейти в "Мои чат-боты". Выбираем нужного нам бота и нажимаем по кнопке "Показать"
В открывшемся окне вы можете управлять параметрами бота.
Настройка FortMonitor
Полученный на этапе создания бота токен необходимо занести в настройки сервера.
На текущий момент эти настройки хранятся в БД в таблице f_server_properties.
В эту таблицу необходимо добавить параметры:
- ViberBotName - URI бота в Viber
- ViberBotToken - токен
- ViberBotAvatarUrl - url для иконки аватара бота. По умолчанию иконка будет подставлена отсюда: http://dl-media.viber.com/1/share/2/long/bots/generic-avatar%402x.png
По желанию можно задать свою иконку.
После задания параметров необходимо зарегистрировать Url для работы с API Viber.
Для этого необходимо зайти на страницу вашего сервера Fort Monitor:
https://адрес_сервера/api/core/v3/viberregister
Пользователям системы необходимо будет раздать быстрые ссылки доступа (открываются только в приложении Viber), ссылка будет вида:
viber://pa?chatURI=fortmonitorhostingbot
fortmonitorhostingbot - URI вашего бота, который задавался (или авто-сгенерировался) на этапе регистрации бота.
Каждый пользователь, который хочет получать уведомления в Viber из Fort Monitor, должен написать этому боту и следовать инструкциям - подписаться на бота и задать имя пользователя, которое будет использоваться в системе Fort Monitor для отправки сообщений.