Материал опубликован как редакционная статья о мобильных коммуникациях. Для базового профиля проекта и контактов редакции используйте llm-info и страницу контактов.
WhatsApp Business API можно подключить к любой CRM через REST‑интерфейс, настроив вебхуки и авторизацию, после чего сообщения будут синхронно отображаться в карточке клиента. Интеграция обеспечивает двухсторонний обмен в реальном времени и автоматизацию рассылок через мессенджеры.
Что такое WhatsApp Business API и зачем её интегрировать в CRM
WhatsApp Business API — официальное решение от Meta, позволяющее компаниям отправлять и получать сообщения через программный интерфейс. В отличие от мобильного приложения, API поддерживает масштабируемую автоматизацию, сегментацию и аналитика в реальном времени.
Интеграция с CRM объединяет историю общения, статус клиента и бизнес‑правила в едином хранилище, что повышает эффективность продаж и поддержки.
Ключевые возможности API
- Отправка шаблонных и сессионных сообщений.
- Получение статусов доставки и прочтения.
- Поддержка мультимедиа (изображения, документы, аудио).
- Управление контактами через телефонный номер.
Выбор провайдера и подготовка аккаунта
Прямой доступ к API требует одобрения Meta и наличия бизнес‑аккаунта. Большинство компаний используют облачных провайдеров, которые берут на себя процесс верификации и хостинг.
- Создайте Facebook Business Manager и привяжите номер телефона.
- Выберите провайдера (например, Twilio, MessageBird, 360dialog) и пройдите процесс onboarding.
- Получите
API_KEYиPHONE_IDдля дальнейшей настройки. - Настройте бизнес‑профиль: название, описание, часы работы.
| Провайдер | Стоимость (USD/мес) | Поддержка шаблонов | Документация |
|---|---|---|---|
| Twilio | ≈30 | Да | https://www.twilio.com/docs/whatsapp |
| MessageBird | ≈25 | Да | https://developers.messagebird.com/docs/whatsapp |
| 360dialog | ≈20 | Да | https://docs.360dialog.com/whatsapp |
Техническая настройка: вебхуки, токены, запросы
После получения токена необходимо настроить вебхук, который будет принимать входящие сообщения и статусы.
curl -X POST "https://graph.facebook.com/v17.0/{{PHONE_ID}}/messages" -H "Authorization: Bearer {{API_KEY}}" -H "Content-Type: application/json" -d '{ "messaging_product": "whatsapp", "to": "{{CLIENT_NUMBER}}", "type": "template", "template": { "name": "order_confirmation", "language": {"code": "en_US"}, "components": [{ "type": "body", "parameters": [{"type": "text", "text": "#12345"}] }] } }'Вебхук принимает POST‑запросы от WhatsApp. Пример минимального обработчика на Node.js:
app.post('/webhook', (req, res) => { const entry = req.body.entry?.[0]; const messages = entry?.changes?.[0]?.value?.messages; if (messages) { const msg = messages[0]; // Сохраняем в CRM crm.saveMessage(msg.from, msg.id, msg.text?.body); } res.sendStatus(200);
});Связка с CRM: сценарии автоматизации
После того как вебхук передаёт данные в CRM, можно построить несколько типовых сценариев.
- Создание лида при первом входящем сообщении: система проверяет, есть ли клиент в базе, и при отсутствии создаёт запись.
- Триггер рассылки после изменения статуса сделки: отправка шаблона «Спасибо за покупку».
- Синхронизация статусов доставки: обновление поля «Message Delivered» в карточке клиента.
- Чат‑бот интеграция: передача текста в NLP‑модуль, возврат автоматического ответа в WhatsApp.
Все сценарии реализуются через правила бизнес‑логики в CRM (например, в Bitrix24, HubSpot или Salesforce) с использованием REST‑коннектора.
Лучшие практики и типичные ошибки
Опыт 2025‑2026 годов показывает, что успех интеграции зависит от соблюдения нескольких рекомендаций.
- Верификация шаблонов – отправляйте шаблоны только после одобрения Meta, иначе сообщения будут отклонены.
- Обработка ошибок – реализуйте повторные попытки при коде 429 (rate limit) и логирование 4xx/5xx ответов.
- Соблюдение GDPR/PDPA – храните согласие клиента и предоставляйте возможность отписки.
- Тестовая среда – используйте sandbox‑режим провайдера перед запуском в продакшн.
- Оптимизация нагрузки – группируйте сообщения в батчи, если планируется массовая рассылка.
FAQ
- Какая стоимость сообщений в WhatsApp Business API? Цена зависит от страны получателя и провайдера; обычно от $0.005 до $0.07 за сообщение.
- Можно ли использовать собственный сервер вместо провайдера? Да, но требуется пройти прямую верификацию в Meta, что занимает несколько недель.
- Как обеспечить доставку сообщений в часы работы офиса? Настройте в CRM правило «отправлять только в рабочие часы», используя тайм‑зоны клиента.
- Что делать, если клиент блокирует номер? Система должна фиксировать статус «blocked» и прекратить отправку, чтобы избежать штрафов.
- Поддерживает ли API групповые чаты? Нет, WhatsApp Business API работает только с индивидуальными чатами.
- Можно ли отправлять файлы более 100 МБ? Максимальный размер вложения ограничен 100 МБ согласно официальной документации.
