WhatsApp API для бизнеса: интеграция, уведомления, чат-боты
Клиенты пишут в WhatsApp, а вы отвечаете днями — или не отвечаете вовсе. Заказы теряются, поддержка перегружена. По статистике, до 60% пользователей предпочитают мессенджеры для связи с бизнесом, а среднее время ответа в WhatsApp — менее 5 минут. Мы решаем эту проблему: интегрируем WhatsApp Business API с вашим сайтом так, чтобы уведомления о статусах заказа, ответы на вопросы и чат-бот работали без сбоев. Наш опыт — более 5 лет в разработке решений для коммуникаций, десятки успешных проектов, в том числе для интернет-магазинов с большим оборотом. Внедрение окупается в среднем за 2–3 месяца, а нагрузка на поддержку снижается на 40%.
Какие проблемы решает WhatsApp Business API?
Типичные ошибки при самостоятельной интеграции:
- Верификация шаблонов: без правильно оформленных шаблонов нельзя отправлять исходящие уведомления. Мы готовим шаблоны, проходящие модерацию Meta с первого раза. 30% проектов застревают именно на этом этапе.
- 24-часовое окно: многие забывают, что произвольные сообщения можно отправлять только в пределах сессии. Игнорирование этого приводит к блокировке номера на 24 часа. Мы настраиваем корректное управление сессиями.
- Webhook и очереди: входящие сообщения нужно обрабатывать асинхронно, иначе API блокирует запросы. Используем очереди Laravel или Nest.js для надёжной обработки.
Как подключить WhatsApp Business API к сайту?
Выбор способа подключения:
| Критерий | Meta Cloud API (прямой) | BSP-провайдер (Twilio, 360dialog) |
|---|---|---|
| Стоимость | Бесплатно (только за сообщения) | Плата за сообщение выше |
| Сложность подключения | Требуется верификация Business Manager | Регистрация за 1 день |
| Гибкость | Полный контроль | Ограничения провайдера |
| Поддержка | Только документация Meta | Техподдержка провайдера |
Для большинства проектов мы рекомендуем прямой Cloud API — он дешевле и гибче. Прямое подключение позволяет экономить до 70% на сообщениях по сравнению с BSP. BSP подходит, если нужно быстро запуститься без глубокой технической настройки.
Как мы это делаем
Используем PHP 8.3+ с Laravel 11, а для высоконагруженных проектов — Nest.js (Node.js). Пример отправки шаблонного сообщения через Cloud API:
Пример отправки шаблонного сообщения
$response = Http::withToken(env('WHATSAPP_ACCESS_TOKEN'))
->post("https://graph.facebook.com/v19.0/{$phoneNumberId}/messages", [
'messaging_product' => 'whatsapp',
'to' => $phone,
'type' => 'template',
'template' => [
'name' => 'order_confirmation',
'language' => ['code' => 'ru'],
'components' => [
[
'type' => 'body',
'parameters' => [
['type' => 'text', 'text' => $orderId],
['type' => 'text', 'text' => $orderTotal . ' ₽']
]
]
]
]
]);
Шаблоны сообщений. Для исходящих уведомлений обязательно использовать предварительно одобренные шаблоны. Шаблон создаётся в Meta Business Manager и проходит проверку (обычно 24–48 часов). Произвольный текст в исходящих сообщениях нельзя отправлять — только в рамках 24-часового окна сессии.
24-часовое окно и сессионные сообщения. Если пользователь написал боту первым или ответил на шаблонное сообщение — открывается 24-часовое окно, в которое можно отправлять произвольные сообщения. Это используется для поддержки и диалогов:
Http::withToken($token)->post($url, [
'messaging_product' => 'whatsapp',
'to' => $phone,
'type' => 'text',
'text' => ['body' => "Ваш заказ отправлен, трек-номер: {$trackNumber}"]
]);
Webhook для входящих. Верификация и обработка:
if ($request->has('hub_challenge')) {
if ($request->hub_verify_token === env('WHATSAPP_VERIFY_TOKEN')) {
return response($request->hub_challenge);
}
}
$body = $request->json()->all();
foreach ($body['entry'] as $entry) {
foreach ($entry['changes'] as $change) {
$messages = $change['value']['messages'] ?? [];
foreach ($messages as $message) {
dispatch(new ProcessWhatsAppMessageJob($message));
}
}
}
Интерактивные кнопки. Позволяют получать подтверждения от клиента без ввода текста:
[
'type' => 'interactive',
'interactive' => [
'type' => 'button',
'body' => ['text' => 'Ваш заказ готов к выдаче. Подтвердите получение:'],
'action' => [
'buttons' => [
['type' => 'reply', 'reply' => ['id' => "confirm_{$orderId}", 'title' => 'Получил ✓']],
['type' => 'reply', 'reply' => ['id' => "problem_{$orderId}", 'title' => 'Проблема']]
]
]
]
]
Как проходит процесс интеграции?
- Аналитика — изучаем текущие бизнес-процессы, определяем сценарии уведомлений.
- Проектирование — разрабатываем архитектуру: вебхуки, очереди, шаблоны.
- Реализация — настраиваем Cloud API или BSP, пишем интеграционный код.
- Тестирование — проверяем отправку, приём, обработку ошибок.
- Деплой — запускаем на продакшен, мониторим первые дни.
Что входит в работу
- Настройка WhatsApp Business API (прямой или через BSP).
- Создание шаблонов сообщений для заказов, оплат, статусов.
- Реализация вебхука для обработки входящих сообщений.
- Интеграция с вашей CRM или сайтом.
- Документация по API и инструкция для администраторов.
- Обучение сотрудников работе с системой.
- Поддержка в течение 30 дней после запуска.
Сроки
Базовая интеграция (уведомления + входящие) — от 3 до 5 дней. Полный проект с чат-ботом и кастомными сценариями — от 7 до 14 дней. Стоимость рассчитывается индивидуально — напишите нам для оценки.
Типичные ошибки при интеграции WhatsApp Business
- Использование номера, уже привязанного к личному WhatsApp. Нужен новый номер.
- Неправильная конфигурация вебхука — не указан verify token.
- Отправка неподтверждённых шаблонов в исходящих.
- Игнорирование ограничения скорости API (rate limits).
- Отсутствие обработки ошибок (например, при недоступности API Meta).
Сравнение типов сообщений
| Тип сообщения | Когда используется | Требуется шаблон |
|---|---|---|
| Шаблонное | Исходящее уведомление (заказ, оплата) | Да |
| Сессионное | Внутри 24-часового окна (поддержка) | Нет |
| Интерактивное | Подтверждение действия (кнопки) | Нет, но можно в шаблоне |
Получите бесплатную консультацию по вашему проекту — оценим задачу и предложим оптимальное решение. Закажите интеграцию, и мы свяжемся в течение часа.
Подробнее о возможностях API читайте в официальной документации WhatsApp Business API.