# Как интегрировать WhatsApp Business API в CRM: пошаговое руководство

- Опубликовано: 2026-09-03T16:24:04+00:00
- Обновлено: 2026-09-03T16:24:04+00:00
- Автор: Кира Астахова
- Канонический URL: https://smsblog.ru/tarify-i-ceny/kak-integrirovat-whatsapp-business-api-v-crm-poshagovoe-rukovodstvo/

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 МБ согласно официальной документации.

## Источники

- В материале не указаны внешние источники.