Интеграция с WhatsApp Business API

Интеграция с WhatsApp Business API позволяет вашим ботам общаться с клиентами через самый популярный мессенджер в мире. Поддерживаются как личные чаты, так и WhatsApp Business аккаунты.

Практический пример из опыта:

Турагентство подключило Salebot к WhatsApp для обработки запросов о турах. Клиенты присылают сообщения "Хочу в Турцию на май" → бот задаёт уточняющие вопросы (бюджет, даты, количество человек) → собирает контакты → передаёт данные менеджеру. За первый месяц через WhatsApp поступило 240 заявок, конверсия в продажу составила 18%. Клиенты ценят возможность общаться в привычном мессенджере без необходимости звонить.

Требования для подключения

📱

Бизнес-аккаунт WhatsApp

Нужен аккаунт WhatsApp Business, зарегистрированный через Facebook Business Manager. Личный аккаунт WhatsApp не подойдёт.

Важно: Номер телефона для WhatsApp должен быть "чистым" — не привязанным к личному WhatsApp.

🔑

Ключи доступа

Требуются API-ключи от Facebook: Permanent Access Token, Phone Number ID, Business Account ID.

Где взять: В Facebook Business Manager в разделе WhatsApp > API Setup.

🌐

Вебхук

Salebot должен быть доступен по HTTPS для получения вебхуков от WhatsApp. Cloud-версия Salebot уже имеет HTTPS.

Для self-hosted: Нужен SSL-сертификат и белый IP-адрес.

Пошаговая инструкция подключения

Шаг 1: Создание бизнес-аккаунта

  1. Перейдите в Facebook Business Manager
  2. Создайте бизнес-аккаунт (если ещё нет)
  3. В разделе "Активы" > "WhatsApp" нажмите "Добавить"
  4. Следуйте инструкциям по созданию аккаунта WhatsApp Business
  5. Подтвердите номер телефона (на него придёт код)

Шаг 2: Получение токенов

  1. В WhatsApp Business Manager перейдите в "API Setup"
  2. Скопируйте:
    • Phone Number ID (идентификатор номера)
    • Business Account ID (идентификатор бизнес-аккаунта)
  3. Нажмите "Generate Access Token" для создания Permanent Access Token
  4. Скопируйте токен (длинная строка) — он покажется только один раз!

Шаг 3: Настройка в Salebot

  1. В личном кабинете Salebot перейдите: Интеграции → WhatsApp
  2. Введите полученные данные:
    • Phone Number ID
    • Business Account ID
    • Permanent Access Token
  3. Нажмите "Подключить"
  4. Salebot автоматически настроит вебхук и проверит соединение

Шаг 4: Верификация шаблонов

WhatsApp требует предварительной верификации шаблонов сообщений для первой коммуникации. Salebot поможет с этим:

  1. Создайте шаблоны сообщений в Salebot (например, "приветственное", "подтверждение заказа")
  2. Отправьте их на модерацию в Facebook (занимает 1-3 дня)
  3. После одобрения шаблоны можно использовать в диалогах

Особенности WhatsApp

По сравнению с другими мессенджерами, WhatsApp имеет специфические ограничения и возможности:

⏱️

24-часовое окно

После того как пользователь написал вам, вы можете отвечать ему в течение 24 часов без шаблонов. После 24 часов — только предварительно одобренными шаблонами.

Стратегия: Важно отвечать быстро и поддерживать диалог в течение суток.

📋

Шаблоны сообщений

Для первой коммуникации или после 24 часов молчания нужно использовать одобренные шаблоны. Они имеют строгий формат.

Пример шаблона: "Привет, {{1}}! Ваш заказ №{{2}} готов к выдаче. Забрать можно по адресу: {{3}}."

💬

Кнопки и интерактивы

WhatsApp поддерживает кнопки быстрого ответа, списки, карусели товаров. Salebot автоматически конвертирует блоки конструктора в WhatsApp-формат.

Пример: Кнопки "Да", "Нет", "Позже" под сообщением.

Практические примеры использования

Пример 1: Поддержка клиентов

Сценарий: Клиент пишет в WhatsApp "У меня проблема с доставкой".

Работа бота:

  1. Бот: "Здравствуйте! Чтобы помочь с доставкой, укажите номер заказа."
  2. Клиент вводит номер
  3. Бот проверяет статус в системе и отвечает: "Ваш заказ №12345 в пути, курьер будет сегодня с 14:00 до 16:00."
  4. Если проблема сложная, бот: "Перевожу вас на оператора. Ожидайте, пожалуйста."

Результат: 70% запросов решаются автоматически, 30% передаются оператору.

Пример 2: Продажи через каталог

Сценарий: Магазин одежды размещает в Instagram кнопку "Написать в WhatsApp".

Работа бота:

  1. Клиент нажимает кнопку → открывается WhatsApp с предзаполненным сообщением "Хочу посмотреть новую коллекцию"
  2. Бот отправляет каталог товаров в виде интерактивной карусели
  3. Клиент выбирает товар, размер, цвет
  4. Бот оформляет заказ и отправляет платёжную ссылку

Результат: Конверсия из просмотра Instagram в покупку через WhatsApp — 8% (против 2% через сайт).

Решение проблем

Частые проблемы при интеграции и их решения:

❌

Токен не работает

Причина: Токен устарел или не имеет нужных разрешений.

Решение: Сгенерируйте новый токен в Facebook Business Manager с разрешениями: whatsapp_business_management, whatsapp_business_messaging.

📵

Сообщения не доходят

Причина: Номер телефона заблокирован WhatsApp за спам.

Решение: Используйте шаблоны для первой коммуникации, не отправляйте массовые рассылки без согласия.

🔧

Вебхук не работает

Причина: Salebot недоступен по HTTPS или firewall блокирует запросы.

Решение: Для cloud-версии Salebot проблем нет. Для self-hosted — настройте SSL и откройте порты.

Стоимость и лимиты

WhatsApp Business API — платный сервис. Тарификация:

Тарифы WhatsApp (на 2025 год)

  • Сессионные сообщения: Отправленные в течение 24 часов после сообщения пользователя. ~0.01-0.05 USD за сообщение в зависимости от страны.
  • Шаблонные сообщения: Отправленные после 24 часов или как первое сообщение. ~0.02-0.09 USD за сообщение.
  • Входящие сообщения: Бесплатно.

Пример расчёта: 1000 диалогов в месяц, в каждом в среднем 5 сообщений от бота = 5000 сообщений × 0.03 USD = 150 USD/мес.

Salebot не берёт дополнительную плату за интеграцию с WhatsApp — вы платите только Facebook за сообщения.

Советы по использованию

Из опыта работы с WhatsApp в Salebot:

  • Начинайте с шаблонов: Подготовьте и верифицируйте 5-10 основных шаблонов до запуска.
  • Оптимизируйте стоимость: Поощряйте пользователей отвечать в течение 24 часов, чтобы использовать более дешёвые сессионные сообщения.
  • Используйте кнопки: Кнопки быстрого ответа увеличивают конверсию и уменьшают количество вводимого текста.
  • Интегрируйте с CRM: Все диалоги из WhatsApp должны попадать в CRM для дальнейшей работы.
  • Тестируйте на разных устройствах: WhatsApp на iOS, Android и Web может по-разному отображать сообщения.

Что дальше?

После подключения WhatsApp: