Как подключить Viber Bot к VanOmni и проверить первый диалог
Viber подключается к VanOmni как официальный бот по токену, а не как личный аккаунт по QR-коду. Для запуска нужен заранее созданный активный Viber Bot и его секретный ключ. После подключения VanOmni регистрирует защищенный webhook, принимает обращения в единое окно и позволяет отвечать текстом, отправлять фото, видео и файлы.
1. Подготовьте активного Viber-бота
Сначала убедитесь, что у компании уже есть активный Viber Bot и вы добавлены в него как администратор. Согласно актуальной документации Rakuten Viber, новые боты с 5 февраля 2024 года создаются на коммерческих условиях. VanOmni подключает готового бота, но не заменяет процедуру его создания у Viber.
Не путайте Viber Bot с рассылкой по базе телефонных номеров. Обычный бот работает с пользователями, которые открыли диалог и написали ему. Для отправки сообщений по существующей телефонной базе Viber предлагает отдельный продукт Business Messages через официальных партнеров.
2. Скопируйте токен и сохраните его в секрете
Администратор бота может найти ключ в приложении Viber: «Еще» → «Настройки» → «Боты» → выбор нужного бота → «Изменить информацию» → «Ваш ключ приложения». В англоязычном интерфейсе этот ключ называется app key или authentication token.
Токен дает право выполнять запросы от имени бота, поэтому его нельзя отправлять в общий чат, вставлять в документы или показывать на скриншотах. Если ключ мог попасть постороннему, запросите его замену у поддержки Viber и обновите подключение.
3. Добавьте канал в VanOmni
Откройте настройки каналов VanOmni, выберите Viber и профиль «Viber Bot». Укажите понятное внутреннее название канала, полностью вставьте токен и нажмите «Подключить». При работе с Битрикс24 можно выбрать подходящую открытую линию; без CRM канал работает в самостоятельном кабинете VanOmni.
Во время подключения VanOmni передает Viber адрес защищенного webhook. Viber проверяет доступность этого адреса и принимает только HTTPS с доверенным сертификатом. Если токен неверный или webhook недоступен, подключение завершится ошибкой — не создавайте второй канал, пока не устранена причина первого сбоя.
4. Проверьте входящее сообщение
Откройте публичный диалог с ботом с тестового аккаунта Viber и отправьте короткое уникальное сообщение. Первое сообщение пользователя делает его подписчиком бота. После этого откройте диалоги VanOmni, найдите новый чат и убедитесь, что текст и имя отправителя появились только один раз.
Ответьте из VanOmni и проверьте доставку в Viber. Затем отдельно отправьте фотографию и небольшой файл. Интерфейс VanOmni заявляет для Viber поддержку текста, фото, видео и файлов, поэтому контрольный тест должен охватывать те форматы, которыми реально будет пользоваться команда.
5. Что проверить при ошибке
Если сообщение не появилось, сначала проверьте, что выбран именно нужный бот, токен скопирован целиком, канал включен, а тестовый пользователь написал боту первым. Не публикуйте токен в обращении в поддержку: достаточно назвать кабинет, канал, время теста и текст безопасного контрольного сообщения.
Если исходящий ответ не доставлен, посмотрите статус последней отправки в настройках канала и не нажимайте отправку повторно много раз. Зафиксируйте время и результат, затем повторите один тест после проверки состояния канала. Такой порядок помогает отличить ошибку авторизации от временной задержки доставки.
Проверочный список
- Убедиться, что активный Viber Bot уже создан на стороне Rakuten Viber.
- Скопировать app key только из настроек нужного бота.
- Не передавать токен сотрудникам и не включать его в скриншоты.
- Добавить Viber Bot в настройках каналов VanOmni.
- Отправить первое тестовое сообщение со стороны пользователя Viber.
- Проверить ответ, фотографию и небольшой файл без повторных отправок.
Следующий шаг
Посмотрите инструкции VanOmni, интеграцию с Битрикс24 и актуальные тарифы.
Обсудить подключение