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

Ручная обработка заявок из Viber перегружает менеджеров. Клиенты ждут ответа, лиды теряются. Для бизнеса с аудиторией в Viber — например, доставка еды или сервисный центр — автоматизация через бота становится необходимостью. Мы создаём Viber-ботов, которые интегрируются с Битрикс24, и гарантируем, что 70–80% типовых запросов обрабатываются без участия человека. В отличие от WhatsApp, Viber предоставляет открытый Viber Bot API без сложных согласований — любой может создать публичный аккаунт. Но есть особенность: Viber не передаёт номер телефона. Как это обойти — расскажем ниже. Наши специалисты сертифицированы по направлению 1С-Битрикс и имеют опыт более 5 лет в разработке интеграций. Средняя экономия на операторах после внедрения такого бота — от 100 000 до 200 000 ₽ в месяц. А скорость ответа клиенту сокращается в 5 раз по сравнению с ручной обработкой.

Что такое Viber Bot API?

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

• Текстовые сообщения, изображения, документы, видео, стикеры.
• Rich Messages — сообщения с кнопками (Keyboard API).
• Carousel — горизонтальный список карточек с кнопками (Rich Media).
• Получение профиля пользователя: имя, аватар, страна (телефона нет).
• 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% выше — клиенты спокойнее выбирают и добавляют позиции. Экономия на операторах — около 50 часов в месяц. Свяжитесь с нами — мы подберём оптимальное решение для вашего бизнеса.

Оценка трудозатрат на типовые компоненты

Что входит в разработку Viber-бота под ключ

Сравнение с альтернативами: Viber-бот требует в 3-5 раз меньше бюджета, чем разработка мобильного приложения, и окупается за 2-3 месяца при 50+ заказах в день. Получите консультацию — мы оценим ваш проект бесплатно.

Процесс работы и сроки

1. Аналитика — 1-2 дня: описание сценариев, согласование прототипа.
2. Проектирование — 2-3 дня: архитектура, выбор стека, проектирование БД.
3. Разработка — от 5 до 15 дней в зависимости от сложности.
4. Интеграционное тестирование — 2-3 дня: проверка всех цепочек, нагрузочное тестирование.
5. Деплой и запуск — 1-2 дня: настройка сервера, домен, SSL, мониторинг.
6. Обучение команды — 1 день: инструктаж операторов, передача документации.

Ориентировочный срок — от 2 до 4 недель. Точную оценку даём после анализа требований. Свяжитесь с нами — обсудим ваш проект и подготовим коммерческое предложение.

Открытые линии: где всё начинается и ломается

Модуль «Открытые линии» (imopenlines) — штатный механизм Битрикс24 для омниканальных коммуникаций. Он связывает внешний канал с внутренним чатом через сущность Im\Model\ChatTable. Проблема в том, что из коробки настройки маршрутизации примитивные: «по очереди» или «всем сразу». Для реального отдела продаж с 15+ менеджерами, VIP-клиентами и SLA по времени ответа этого недостаточно. Мы дорабатываем маршрутизацию через обработчики событий OnImOpenLinesChatStart и REST API.

Менеджер переключается между пятью окнами, теряет сообщения, забывает ответить — клиент уходит к конкуренту, который ответил за 30 секунд. Настройка мессенджеров Битрикс24 собирает все каналы в один интерфейс, а CRM фиксирует каждое касание. Опыт показывает: после настройки среднее время первого ответа сокращается на 40% уже в первую неделю.

Как мы реализуем интеграцию мессенджеров

Подключаем Telegram, WhatsApp, Viber, VK, онлайн-чат, Email и другие каналы через штатные коннекторы или REST API. Каждый канал требует своей настройки, но результат единый — все сообщения попадают в открытые линии, а из них — в карточку клиента. Гарантируем, что ни одно обращение не потеряется: используем тегированное кэширование и агенты для проверки очередей.

Как подключить WhatsApp к Битрикс24?

WhatsApp — главный бизнес-канал. Интеграция через WhatsApp Business API с верифицированным аккаунтом. Настраиваем приём и отправку сообщений из интерфейса Б24 — они падают в открытую линию. Создаём HSM-шаблоны для инициации диалога (напоминание о брошенной корзине, статус заказа). Шаблоны проходят модерацию Meta — закладывайте 2-3 дня. Обеспечиваем передачу файлов, изображений, документов. Связываем переписку с контактом и сделкой через CRM_ENTITY_TYPE и CRM_ENTITY_ID.

Telegram: бесплатный канал с высоким охватом

Telegram Bot API бесплатный и хорошо документированный — приятная редкость среди мессенджеров. Интеграция в Битрикс24 выполняется через коннектор imopenlines. Настройка: подключаем бота к открытым линиям, настройка коннектора → Telegram. Приём сообщений, фото, видео, документов — всё маппится в чат Б24. Inline-кнопки и reply-клавиатуры для навигации. Webhook на https://yourdomain/rest/imconnector.register — регистрация коннектора. Интеграция с CRM: входящее сообщение создаёт лид через crm.lead.add или активность в сделке.

Telegram незаменим для:

• Поддержки через бота — типовые вопросы закрываются без оператора (до 70% обращений).
• Уведомлений: заказы, доставка, оплата — через Telegram Bot API sendMessage.
• Сбора лидов: бот задаёт квалифицирующие вопросы → создаёт лид.

Viber и VK: аудитория 35+ и соцсеть

Viber держит позиции в регионах. Подключаем бизнес-аккаунт через коннектор открытых линий. Используем Viber Business Messages — массовые рассылки с кнопками действий и rich-контентом. Приём и отправка из CRM работают сразу.

VK (ВКонтакте) — крупнейшая соцсеть в РФ. Интеграция через коннектор imopenlines сообщений сообщества. Обработка сообщений и комментариев из единого интерфейса. Автосоздание лида — обработчик OnImOpenLinesCrmCreate. Интеграция с VK Рекламой для трекинга источников через UTM. Бот для автоответов — VK Bot API + Callback API.

Почему важна правильная маршрутизация обращений?

Распределение обращений по операторам организовано через механизмы очередей. По умолчанию — «кто свободен». В реальности нужно сложнее:

• Определение ответственного по номеру или email из CRM — im.chat.get + поиск по crm.contact.list.
• Распределение по отделам на основе ключевых слов (NLP-классификатор или простой regex на первом сообщении).
• Приоритетная очередь для VIP — по сегменту в CRM.
• Эскалация при таймауте 5 минут — автопереключение на следующего.
• Переход на звонок прямо из чата — telephony.externalcall.register.

Используем кастомные обработчики событий OnImOpenLinesChatStart и REST API для реализации таких сценариев. Дополнительно подключаем Bizproc для сложных цепочек согласований и интеграцию с HL-блоками для хранения пользовательских параметров очередей. Результат: клиент не ждёт, оператор не перегружен.

Что входит в работу по интеграции мессенджеров

Чат-боты: сценарные и с NLP

Типы

Сценарные (rule-based): кнопочное меню, дерево решений. «Как оплатить» → «Где мой заказ» → «Часы работы». Передача на оператора при intent == 'unknown' → transfer_to_queue. Надёжно, предсказуемо, покрывает 60-70% типовых обращений.

С NLP: свободный текст на русском. Определение intent (купить, пожаловаться, узнать о доставке), извлечение сущностей (имя, дата, номер заказа). Контекстный диалог — помнит, о чём говорили. Реализуем на Rasa или Dialogflow, интеграция с Б24 через REST.

use Bitrix\Main\Loader;
use Bitrix\Imopenlines\Model\SessionTable;

Loader::includeModule('imopenlines');

$eventManager = \Bitrix\Main\EventManager::getInstance();
$eventManager->addEventHandler('imopenlines', 'OnImOpenLinesMessageReceive', function($event) {
    $message = $event->getParameter('message');
    $chatId = $event->getParameter('chatId');
    
    if (preg_match('/статус заказа (\d+)/i', $message, $matches)) {
        $orderId = $matches[1];
        // Получаем статус заказа через API
        $order = \Bitrix\Sale\Order::load($orderId);
        if ($order) {
            $status = $order->getField('STATUS_ID');
            \Bitrix\ImOpenLines\Chat::sendMessage($chatId, 'Ваш заказ №' . $orderId . ' в статусе: ' . $status);
        }
    }
});

Сценарии и реальный эффект

Сравнение: сценарный бот обрабатывает запросы в 5 раз быстрее оператора, а NLP-бот снижает fallback rate до 15% после обучения на реальных диалогах. Средняя экономия на зарплате операторов при внедрении чат-бота составляет значительную сумму — десятки тысяч рублей ежемесячно.

Процесс разработки

1. Анализ обращений — выгружаем историю из открытых линий, кластеризуем по темам. Определяем 80% типовых запросов.
2. Проектирование диалогов — карта на miro/figma. Каждая ветка заканчивается либо ответом, либо передачей оператору.
3. Разработка — логика, интеграция с CRM и внешними API. Для сценарных — конечный автомат на состояниях. Для NLP — pipeline: tokenizer → featurizer → classifier → response selector.
4. Обучение NLP — на реальных диалогах (не менее 500 примеров). Настройка threshold confidence.
5. Тестирование — прогон всех веток, edge cases (пустое сообщение, стикер, голосовое).
6. Оптимизация — мониторинг fallback rate, дообучение на новых диалогах каждые 2 недели.

Сроки

Результат — все обращения в едином окне, рутина автоматизирована, ни одно сообщение не теряется. Менеджеры продают, а не ищут нужный чат. Оцените, какие каналы нужны именно вам, — напишите, подберём под вашу нишу. Получите персональный расчёт срока и стоимости для вашего проекта.