Viber — подключение и проверка

Самое короткое подключение из всех каналов: нужен только auth token — адрес приёма ImpactBot регистрирует в Viber сам.

Что нужно заранее

  • Viber Business Account.
  • Бот, созданный в Viber Admin Panel (partners.viber.com), и его auth token — строка вида `xxxxxxxx-xxxxxxxx-xxxxxxxx-xxxxxxxx`.
  • Роль администратор в проекте ImpactBot: канал подключает только она.
  • Свободный слот канала в тарифе — иначе подключение остановится с сообщением про лимит.

Права и доступы

Отдельных разрешений выдавать не нужно: бот действует от собственного имени по auth token, и этот токен — единственный ключ к каналу. Один auth token = один бот; для второго бота заводится отдельный бот в Admin Panel.

Что ограничено не нами: писать первым нельзя — человек должен сам написать боту или подписаться. Массовая рассылка тем, кто не писал первым, ограничена правилами Viber и требует партнёрского статуса. Диалоги при этом работают сразу, без всякого статуса.

Подключение и вебхук

  1. Зарегистрируйте Viber Business Account и создайте бота в Viber Admin Panel.
  2. В настройках бота скопируйте auth token.
  3. Проект → Каналы → Viber → название и Auth Token → «Подключить».

Адрес приёма ставится автоматически в момент подключения: ImpactBot сам вызывает `set_webhook` у Viber и передаёт туда собственный адрес. Вставлять его в панель Viber не нужно — такого поля там и нет. Если автоустановка не прошла, подключение всё равно сохранится, а в ответе будет сказано, что вебхук не установлен: это видно и в диагностике.

Проверка

Нажмите «Проверить» на карточке канала. Диагностика Viber показывает: подтверждён ли Auth Token и что это за аккаунт, стоит ли у Viber адрес именно этого канала, и отдельной строкой — что безопасной пробы отправки у Viber нет (её отсутствие названо вслух, чтобы «проверки не было» не читалось как «проверка прошла»).

После этого напишите боту из Viber — сообщение должно появиться в разделе «Диалоги».

Частые ошибки

  • «Invalid Viber Auth Token». Токен скопирован не полностью или отозван в Admin Panel.
  • Диагностика пишет «Webhook ImpactBot не подтверждён». У Viber стоит адрес другого сервиса или другого канала: один токен держит ровно один адрес приёма. Переподключите канал.
  • Бот не отвечает. Воронка не опубликована либо в ней нет триггера на входящее сообщение.
  • Перестал отвечать после смены токена. Прежний адрес привязан к прежнему токену — переподключите канал с новым.
  • Рассылка не уходит части подписчиков. Это правила Viber про тех, кто не писал первым, а не сбой рассылки.