Инструкция для Viber | Официальная документация Webitel

Подключение Viber-бота к Webitel происходит через текстовый шлюз.

Обращаем ваше внимание, что с 5.02.24 создание Viber-ботов возможно только на коммерческих условиях. Более подробную информацию о том, как подать заявку на создание бота, можно найти здесь .

Для создания текстового шлюза необходимо указать токен аутентификации.

Токен аутентификации генерируется при создании бота и может быть просмотрен администраторами учетной записи на экране “Редактировать информацию” своего бота или в панели администратора Viber (Рис.1).

На странице Текстовые шлюзы нажать кнопку “Добавить” (Рис.2).

Страница Текстовые шлюзы.png — *Рис. 2. Страница “Текстовые шлюзы”*

Откроется модальное окно “Новый текстовый шлюз” (Рис.3). Выбрать вариант “Viber” и нажать кнопку “Создать”.

Модальное окно Новый текстовый шлюз (создание).png — *Рис. 3. Модальное окно “Новый текстовый шлюз”*

Откроется страница детали “Viber” (Рис.4).

Страница детали Viber.png — *Рис. 4. Страница детали “Viber”*

Внести в поля следующие данные:

поле “Имя” - название текстового шлюза;
поле “Токен” - токен аутентификации сгенерируванный на стороне Viber;
поле “URI” - URI учетной записи. Генерируются автоматически. Используется внутри системы Webitel;
поле “Bot Name” - название бота, которое было указано в поле "Account Name" при создании бота;
поле “Схема” - выбрать схему по которой будет работать данный текстовый шлюз.

Нажать кнопку “Сохранить”. Перейти на страницу детали “Стиль” (Рис.5). Выбать цветовое оформления кнопок в Viber чате.

Страница детали Стиль.png — *Рис. 5. Страница детали "Стиль"*

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

Через поля ввода можно задать код цвета.

Кнопка "Сбросить" сбрасывает выбранный цвета к дефолтному значению.

После выбора цвета необходимо нажать кнопку "Сохранить".

Перейти на страницу детали “Шаблоны” - страница для настройки системных сообщений чата (Рис.6).

Страница детали Шаблоны (Viber).png — *Рис. 6. Страница детали "Шаблоны"*

Здесь предоставлена возможность описывать шаблоны определенных обновлений для отдельного шлюза сообщений:

Обновление	Использование	Поле	Отправитель	Получатель
title	Формат заголовка нового, входящего чата	"Анонимное имя абонента в Workspace"	Абонент	Пользователь/оператор
close	Статическое сообщение о завершении чата	"Сообщение завершения чата"	–	Абонент
join	Формат сообщения подключения участника	"Сообщение присоединения оператора"	Пользователь/оператор	Абонент
left	Формат сообщения отключения участника	"Сообщение отключения оператора"	Пользователь/оператор	Абонент

Синтаксис шаблонов пакета text/template можно посмотреть здесь.
"Действия" – оценки данных или структуры управления – разделены "$(" и ")".

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

Обновление	Шаблон сообщения
close	🎈 Диалог завершен !
join	`👤 $(.FirstName)$(if .LastName) $(.LastName)$(end)`
left	`👤 ~$(.FirstName)$(if .LastName) $(.LastName)$(end)~`

То есть, если в поле "Сообщение отключения оператора" ввести:

👤 ~*$(.FirstName)*$(if .LastName) $(.LastName)$(end)~

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

Для анонимизации входящих чатов достаточно вписать текст, к примеру, "Аноним".

В данном случае – шаблоны, как таковые, вообще не используется. Здесь описана константа.

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

Нажать кнопку “Сохранить”.