Розробка 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": "UA"
  },
  "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. Користувач вводить номер у форматі +380....
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% вищим — клієнти спокійно обирають і додають позиції.