Разработка Viber-бота с интеграцией Битрикс24

Разработка Viber-бота с интеграцией Битрикс24

Viber остаётся популярным каналом в Беларуси, Украине и ряде стран СНГ. В отличие от WhatsApp, Viber предоставляет открытый Bot API бесплатно и без сложных согласований — любой может создать публичный аккаунт и подключить бота. Это упрощает разработку, но аудитория меньше, и это нужно учитывать при выборе каналов коммуникации.

Viber Bot API: что доступно

Viber предоставляет Viber Bot API через https://chatapi.viber.com/pa/. Регистрация бота — через создание Bot/Public Account в приложении Viber. После создания выдаётся auth_token.

Возможности, доступные в Viber Bot API:

• Текстовые сообщения, изображения, документы, видео, стикеры.
• Rich Messages — сообщения с кнопками (Keyboard API).
• Carousel — горизонтальный список карточек с кнопками (Rich Media).
• Получение профиля пользователя: имя, аватар, страна (но не телефон — это ключевое отличие от WhatsApp).
• Webhook на входящие сообщения.

Главное ограничение: Viber не передаёт номер телефона пользователя боту. Идентификатор — viber_id (уникальный хеш для каждой пары бот-пользователь). Для привязки к CRM нужно просить пользователя ввести телефон вручную или использовать кнопку «Поделиться контактом» (работает только в некоторых версиях клиента).

Архитектура интеграции с Битрикс24

Viber Bot API (webhook)
      ↓
Сервер бота (Python / Node.js)
      ↓ ↓
  Логика     Битрикс24 REST API
  + Redis    crm.contact.list
  (состояния) crm.lead.add
              imbot.message.add

Входящий вебхук от Viber:

{
  "event": "message",
  "sender": {
    "id": "01234567890A=",
    "name": "Иван Иванов",
    "country": "BY"
  },
  "message": {
    "type": "text",
    "text": "Статус заказа"
  }
}

Ответ через Viber API с кнопками:

POST https://chatapi.viber.com/pa/send_message
{
  "receiver": "01234567890A=",
  "type": "text",
  "text": "Введите номер заказа:",
  "keyboard": {
    "Type": "keyboard",
    "Buttons": [
      {"ActionType": "reply", "ActionBody": "operator", "Text": "Связаться с оператором"}
    ]
  }
}

Идентификация клиента без телефона

Отсутствие телефона в профиле Viber требует отдельного сценария верификации:

1. Бот приветствует пользователя, предлагает ввести телефон.
2. Пользователь вводит номер в формате +375....
3. Бот отправляет SMS-код подтверждения через SMS-провайдера.
4. Пользователь вводит код → бот привязывает viber_id к контакту CRM в поле UF_CRM_VIBER_ID.
5. При следующих обращениях — идентификация по viber_id без повторного ввода телефона.

Альтернатива для корпоративных сценариев: кнопка «Поделиться контактом» в Viber (тип share-phone). Работает не у всех версий клиента, но когда работает — передаёт телефон автоматически.

Интеграция с открытыми линиями Битрикс24

Viber подключается к открытым линиям нативно: CRM → Контакт-центр → Viber. Это простой путь без разработки — сообщения из Viber попадают в очередь операторов.

Для более сложных сценариев (бот + оператор) используют гибридную схему:

• Собственный сервер бота обрабатывает автоматизируемые запросы.
• При передаче оператору — бот отправляет сообщение в открытую линию через imopenlines.chat.sendMessage или создаёт чат через im.chat.add и добавляет историю.

Кейс: Viber-бот для доставки еды

Задача: сеть кафе в Минске, основная аудитория в Viber. Нужна запись заказов на доставку без звонка, подтверждение через бота.

Сценарий заказа через Carousel:

1. Клиент пишет «Заказать» → бот показывает категории меню кнопками.
2. Выбор блюд через Rich Media Carousel (карточки с фото, ценой, кнопкой «+»).
3. Корзина хранится в Redis по viber_id.
4. Ввод адреса доставки → проверка зоны доставки.
5. Оплата: кнопка «Оплатить онлайн» → ссылка на платёжную страницу.
6. После оплаты: создание сделки в Битрикс24 crm.deal.add со статусом «Принят», ответственный — менеджер точки.
7. Подтверждение и трекинг заказа через уведомления в Viber (send_message при смене стадии сделки).

Особенность: Rich Media Carousel в Viber ограничен 6 карточками за раз. Для большого меню — пагинация с кнопками «Ещё».

Результат: 40% заказов перешли из телефонных звонков в Viber-бота за первые два месяца. Средний чек через бота оказался на 12% выше — клиенты спокойнее выбирают и добавляют позиции.