Как подключить WhatsApp Business API: пошаговая инструкция
· 7 мин чтения · IT Komek
WhatsApp Business API подключается напрямую через Meta, без посредников и абонентской платы: нужны бизнес-портфолио в Meta, приложение разработчика, номер без аккаунта в обычном WhatsApp и сервер, который принимает сообщения. Ниже — шаги в том порядке, в котором мы сами подключали свой номер, и ошибки, на которых обычно застревают.
Что понадобится
- Бизнес-портфолио в Meta (бывший Business Manager).
- Отдельный номер телефона, на котором нет аккаунта WhatsApp или WhatsApp Business.
- Документы компании для подтверждения: для ТОО — справка о государственной регистрации.
- Сервер или облачный бэкенд с адресом HTTPS, куда Meta будет присылать сообщения.
Шаг 1. Приложение и тестовый номер
На developers.facebook.com создайте приложение типа Business и добавьте сценарий «Связь в WhatsApp». Meta сразу выдаёт тестовый номер, идентификатор номера (Phone number ID) и идентификатор аккаунта WhatsApp Business. Тестовый номер пишет только номерам, которые вы добавили в список получателей.
Шаг 2. Постоянный токен
Токен со страницы настройки живёт 24 часа. Для работы нужен токен системного пользователя: в настройках бизнес-портфолио создайте системного пользователя, назначьте ему приложение и аккаунт WhatsApp с полным контролем и сгенерируйте токен со сроком «Никогда» и разрешениями whatsapp_business_messaging и whatsapp_business_management.
Частая ошибка: непроверенной компании Meta разрешает только одного системного администратора. Создайте пользователя с ролью «Сотрудник» — для отправки сообщений этого достаточно. Вторая частая ошибка — назначить пользователю только приложение и забыть аккаунт WhatsApp: тогда отправка возвращает «Authorization Error».
Шаг 3. Подключение своего номера
В разделе настройки API нажмите «Добавить номер телефона», укажите отображаемое имя компании и категорию, подтвердите номер кодом из SMS.
Если Meta пишет, что номер зарегистрирован в существующем аккаунте WhatsApp, на номере есть аккаунт в приложении. Его нужно удалить именно через «Настройки → Аккаунт → Удалить аккаунт», а не просто выйти. Удаление доходит до Meta не сразу — иногда через час-два.
Шаг 4. Вебхук
Укажите адрес, на который Meta будет присылать входящие сообщения и статусы доставки, и пароль для проверки (verify token). Подпишитесь на поле messages. Каждый запрос Meta подписывает секретом приложения — сервер обязан проверять подпись, иначе любой сможет прислать поддельное сообщение.
Сервер должен отвечать Meta сразу, а сам ответ клиенту готовить в фоне: если ответа долго нет, Meta повторяет вебхук, и без защиты от повторов клиент получит два одинаковых ответа.
Шаг 5. Подтверждение компании и правила
- Подтверждение компании занимает от одного до нескольких дней и снимает ограничения на количество диалогов.
- Отвечать свободно можно 24 часа после последнего сообщения клиента. Позже — только одобренным шаблоном.
- Номер, подключённый к API, не работает в приложении WhatsApp на телефоне. Отвечать вручную придётся из CRM или другой панели.
- Звонки в WhatsApp на таком номере принимаются через отдельный Calling API.
