Настройка сервера для отправки оповещений в Viber

Данная статья описывает 2 основных момента:

  1. Создание бота Viber
  2. Настройка 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 для отправки сообщений.