Краткий ответ
Чтобы отправить сообщение в WhatsApp через API, подключите WhatsApp Business Account через партнёра Meta или Cloud API от Meta, соберите согласие на получение сообщений (opt-in) и получите одобрение шаблона сообщения. Отправьте шаблон, чтобы начать диалог. После ответа клиента вы сможете отправлять текст в свободной форме, медиа или интерактивные сообщения в течение 24-часового окна обслуживания клиентов.
Что нужно до первой отправки
- WhatsApp Business Account (WABA), обычно созданный через процесс Meta Embedded Signup на стороне партнёра, с подтверждённым бизнес-номером телефона и именем отображения.
- Минимум один одобренный шаблон сообщения в одной из категорий: маркетинговые, служебные (utility) или аутентификационные (authentication).
- Согласие на получение сообщений (opt-in) от каждого получателя, как требуют правила Meta.
- Способ оплаты. С 1 июля 2025 года Meta взимает плату за каждое доставленное сообщение в зависимости от категории и рынка получателя; актуальные ставки смотрите в прайс-листе Meta.
Шаблон или сообщение в свободной форме?
С 1 октября 2026 года Meta также берёт плату за сервисные сообщения (service) и служебные шаблоны (utility), отправленные внутри окна, после 1 000 бесплатных сервисных сообщений в месяц на каждый бизнес-номер телефона.
| Ситуация | Что можно отправить |
|---|---|
| Диалог начинаете вы | Только одобренный шаблон |
| Клиент написал вам в последние 24 часа | Сообщение любого типа: текст, медиа, интерактивное сообщение или шаблон |
| 24-часовое окно закрылось | Только одобренный шаблон |
| Отправка OTP-кода (одноразового кода) | Аутентификационный шаблон (authentication) |
Порядок отправки
- Создайте шаблон: укажите название, язык, категорию и примеры значений переменных, затем отправьте его на проверку в Meta.
- Дождитесь, когда статус шаблона станет «одобрен».
- Вызовите метод отправки, передав получателя, название шаблона, язык и значения переменных.
- Сохраните возвращённый ID и отслеживайте статусы SENT, DELIVERED, READ или FAILED через ваш вебхук.
Пример: отправка шаблона
В OmniChannels.ai каждое сообщение в WhatsApp отправляется через POST https://api.broadnet.me/whatsapp/message/sendbulk в формате multipart form data с токеном Bearer. Укажите messageType со значением TEMPLATE и передайте destinationNo, templateName, templateLanguage и bodyTemplateVariables. Вызов возвращает batchId, а статусы по каждому получателю приходят на ваш вебхук или через GET /whatsapp/message/bulk-insights.