Подключение Viber к открытым линиям Битрикс24
Viber подключается к Битрикс24 через официальный Viber Bot API — нативная поддержка есть в разделе «Контакт-центр». Для подключения нужен Viber Public Account (ранее — Public Chat или Bot Account), который создаётся через панель разработчика Viber.
Создание Viber Public Account
- Перейти на partners.viber.com.
- Авторизоваться через Viber-аккаунт.
- Создать новый Bot аккаунт: указать имя (видит пользователь), описание, загрузить логотип.
- Получить auth_token — строка вида
4bxxxxxxxx-xxxxxxxx.
Важно: Viber Public Account — это не то же самое, что обычный аккаунт в мессенджере. Это специальный бизнес-аккаунт, к которому пользователи «подписываются» или начинают диалог. Телефон в сеть не передаётся.
Подключение к Битрикс24
CRM → Контакт-центр → Открытые линии → выбрать линию → Каналы → Viber → «Подключить».
Ввести auth_token из панели Viber для разработчиков. Битрикс24 регистрирует webhook автоматически. После сохранения — написать боту в Viber с любого телефона и убедиться, что сообщение появилось в очереди операторов.
Настройки канала в Битрикс24
После подключения в настройках Viber-канала доступно:
- Приветственное сообщение — отправляется при первом открытии чата.
- Сообщение при подписке — когда пользователь подписывается на Public Account.
Оба текста пишутся прямо в интерфейсе Битрикс24, без доступа к Viber API.
Особенности работы с Viber в открытых линиях
Идентификация. Viber передаёт уникальный viber_id пользователя. Телефон не передаётся автоматически. Если нужна CRM-привязка по телефону — оператор должен вручную попросить клиента представиться, или бот (если настроен) собирает телефон в рамках приветственного сценария.
Медиафайлы. Поддерживаются фото, документы, видео, стикеры. Голосовые сообщения принимаются, но воспроизведение в интерфейсе Битрикс24 зависит от версии.
Статусы сообщений. Viber передаёт статусы «доставлено» и «прочитано» — оператор видит их в чате Битрикс24.
Ограничения исходящих. Оператор может отправить сообщение клиенту только если клиент первым начал диалог (написал боту). Инициировать переписку без согласия пользователя через открытые линии нельзя.
Типичные проблемы
Токен не принимается. Проверить: токен скопирован без лишних пробелов; аккаунт в Viber активирован (пройдена верификация в панели разработчика); используется тип «Bot», а не «Community» или личный аккаунт.
Сообщения не доходят до оператора. Viber иногда ограничивает боты с низкой активностью. Если бот не использовался несколько недель — может потребоваться переавторизация и повторная установка webhook.
Стикеры отображаются как пустые сообщения. Известное ограничение. Оператор не видит стикер, только метку «[Стикер]» или пустое сообщение. Обходного пути в нативной интеграции нет.
Пользователь написал, лид не создался. Проверить настройки CRM-интеграции в открытой линии: режим создания лидов, права оператора на создание CRM-записей.
Когда Viber-интеграция имеет смысл
Viber актуален для аудитории в Беларуси, Украине, Молдове. Если ваша клиентская база в этих регионах — подключение Viber оправдано. Для российской аудитории приоритет обычно у Telegram и WhatsApp.
Настройка занимает 1-3 часа: создание Public Account, получение токена, подключение к открытой линии, тест с реального устройства, настройка автоответов.