Как подключить WhatsApp Business API: пошаговое руководство

Когда решение об использовании API принято, возникает вопрос: как его запросить и интегрировать? Разберём процесс по шагам.

1. Что подготовить заранее

Перед подачей заявки понадобится:

• Регистрационные документы компании — для верификации бизнеса;
• Номер, не зарегистрированный в WhatsApp — он станет номером отправителя (если номер уже используется в обычном приложении, его нужно оттуда отвязать);
• Аккаунт Facebook Business Manager — на нём строится вся официальная структура API;
• Домен и бренд-ресурсы — для проверки отображаемого имени (Display Name).

2. Два пути: официальный прямой или через провайдера

• Прямая интеграция с Cloud API от Meta — подходит командам с техническими ресурсами, готовым самостоятельно проходить проверку и поддерживать интеграцию;
• Через внешнего провайдера (BSP/платформу) — платформа берёт на себя оформление, проверку, управление несколькими аккаунтами и надёжность. Запуск быстрее, операционной нагрузки меньше.

Большинству команд, ориентированных на маркетинговые коммуникации, работа через платформу экономит кучу времени на проверках и интеграции.

3. Шаги запроса и интеграции

1. Пройдите верификацию компании в Business Manager;
2. Привяжите номер отправителя — зарегистрируйте незанятый номер для API и подтвердите его через SMS или звонок;
3. Настройте отображаемое имя — отправьте его на проверку (оно должно соответствовать правилам нейминга);
4. Подключите обмен сообщениями — интегрируйте endpoint отправки и вебхуки для приёма событий;
5. Создайте шаблоны сообщений — для маркетинговых и уведомительных рассылок нужны предварительно одобренные шаблоны;
6. Проведите сквозное тестирование — проверьте отправку, приём и статусные колбэки на небольшом объёме перед масштабированием.

4. Что сделать сразу после запуска

Запустили API — это не значит, что можно слать без ограничений. Первый пакет действий:

• Проверьте список номеров — отфильтруйте невалидные номера с помощью специальной проверки;
• Прогрейте аккаунты — постепенно увеличивайте объём отправки с новых номеров;
• Соблюдайте правила — следуйте лимитам и контентным ограничениям для массовых рассылок.

5. Типичные проблемы на проверке

• Отображаемое имя отклонено — должно совпадать с брендом, без вводящих в заблуждение формулировок;
• Номер не удаётся зарегистрировать — убедитесь, что он не используется в обычном WhatsApp;
• Шаблон отклонён — маркетинговые шаблоны должны быть понятными, использовать переменные и избегать манипулятивного языка.

Резюме

Основной путь получения API WhatsApp Business выглядит так: собрать документы → выбрать способ (напрямую или через платформу) → пройти верификацию и привязать номер → настроить отображаемое имя и шаблоны → протестировать и запускать. Работа через платформу обычно самый быстрый вариант.