Viber

Инструкции по использованию

Интеграция Viber в рабочие процессы. Отправка сообщений, массовая рассылка нескольким пользователям, получение информации об аккаунте, проверка статуса онлайн и управление вебхуками для вашего бота Viber.

Инструменты

`viber_send_message`

Отправка сообщения пользователю Viber через Viber Chat API.

Входные параметры

Параметр	Тип	Обязательный	Описание
`authToken`	string	Да	Токен аутентификации бота Viber
`receiver`	string	Да	ID пользователя Viber
`text`	string	Да	Текст сообщения
`type`	string	Нет	Тип сообщения: text, picture, video, file, location, contact, sticker, carousel
`media`	string	Нет	URL медиа (для picture, video, file)
`thumbnail`	string	Нет	URL миниатюры (для video/file)
`size`	string	Нет	Размер файла в байтах (для file)
`duration`	string	Нет	Длительность в секундах (для video)
`fileName`	string	Нет	Имя файла (для file)
`keyboard`	string	Нет	JSON-строка клавиатуры
`trackingData`	string	Нет	Данные для отслеживания
`senderName`	string	Нет	Имя отправителя (требуется одобрение)
`senderAvatar`	string	Нет	URL аватара отправителя (требуется одобрение)
`minApiVersion`	string	Нет	Минимальная версия API (например, 7)

Выходные данные

Параметр	Тип	Описание
`success`	boolean	Статус успешности операции
`status`	number	Код статуса API Viber (0 = успех)
`statusMessage`	string	Сообщение статуса API Viber
`messageToken`	string	Токен сообщения для отслеживания
`chatHostname`	string	Имя хоста чата
`members`	json	Массив статусов пользователей
`id`	string	ID аккаунта бота
`name`	string	Имя аккаунта бота
`icon`	string	URL иконки бота
`country`	string	Страна бота
`webhook`	string	Зарегистрированный URL вебхука
`eventTypes`	json	Зарегистрированные типы событий
`error`	string	Сообщение об ошибке

`viber_broadcast`

Массовая рассылка сообщений нескольким пользователям Viber.

Входные параметры

Параметр	Тип	Обязательный	Описание
`authToken`	string	Да	Токен аутентификации бота Viber
`broadcastList`	string	Да	JSON-массив ID пользователей Viber
`text`	string	Да	Текст сообщения
`type`	string	Нет	Тип сообщения
`media`	string	Нет	URL медиа
`thumbnail`	string	Нет	URL миниатюры
`size`	string	Нет	Размер файла
`duration`	string	Нет	Длительность
`fileName`	string	Нет	Имя файла
`keyboard`	string	Нет	JSON клавиатуры
`trackingData`	string	Нет	Данные отслеживания
`senderName`	string	Нет	Имя отправителя
`senderAvatar`	string	Нет	URL аватара
`minApiVersion`	string	Нет	Минимальная версия API

Выходные данные

Параметр	Тип	Описание
`success`	boolean	Статус операции
`status`	number	Код статуса Viber API
`statusMessage`	string	Сообщение статуса
`messageToken`	string	Токен сообщения
`chatHostname`	string	Имя хоста чата
`members`	json	Статусы пользователей
`id`	string	ID бота
`name`	string	Имя бота
`icon`	string	URL иконки
`country`	string	Страна
`webhook`	string	URL вебхука
`eventTypes`	json	Типы событий
`error`	string	Сообщение об ошибке

`viber_get_account_info`

Получение информации об аккаунте бота Viber: имя, иконка, страна.

Входные параметры

Параметр	Тип	Обязательный	Описание
`authToken`	string	Да	Токен аутентификации бота Viber

Выходные данные

Параметр	Тип	Описание
`success`	boolean	Статус операции
`status`	number	Код статуса Viber API
`statusMessage`	string	Сообщение статуса
`id`	string	ID аккаунта бота
`name`	string	Имя бота
`icon`	string	URL иконки
`country`	string	Страна
`error`	string	Сообщение об ошибке

`viber_get_online`

Проверка статуса онлайн пользователей Viber по их ID.

Входные параметры

Параметр	Тип	Обязательный	Описание
`authToken`	string	Да	Токен аутентификации бота Viber
`ids`	string	Да	JSON-массив ID пользователей Viber

Выходные данные

Параметр	Тип	Описание
`success`	boolean	Статус операции
`status`	number	Код статуса Viber API
`statusMessage`	string	Сообщение статуса
`members`	json	Массив статусов пользователей
`error`	string	Сообщение об ошибке

`viber_set_webhook`

Установка или обновление URL вебхука для бота Viber для получения входящих сообщений.

Входные параметры

Параметр	Тип	Обязательный	Описание
`authToken`	string	Да	Токен аутентификации бота Viber
`url`	string	Да	URL вебхука (должен быть HTTPS)
`eventTypes`	string	Нет	Типы событий через запятую (delivered,seen,failed,subscribed,unsubscribed,conversation_started)
`sendName`	string	Нет	Отправлять имя бота (true/false)
`sendPhoto`	string	Нет	Отправлять фото бота (true/false)

Выходные данные

Параметр	Тип	Описание
`success`	boolean	Статус операции
`status`	number	Код статуса Viber API
`statusMessage`	string	Сообщение статуса
`webhook`	string	Зарегистрированный URL вебхука
`eventTypes`	json	Зарегистрированные типы событий
`error`	string	Сообщение об ошибке

Viber

На этой странице