WhatsApp Business API (Meta Cloud API)

Что нужно заранее

  • Бизнес-аккаунт Meta и приложение с продуктом WhatsApp.
  • Номер телефона, подтверждённый в WhatsApp Business Account.
  • Постоянный токен системного пользователя — временный токен из тестового экрана перестанет работать через сутки.
  • Роль администратора в проекте ImpactBot и свободный слот канала в тарифе.

Права и доступы

Токен системного пользователя должен иметь доступ к WhatsApp Business Account и к номеру. В подписках приложения нужно поле messages — без него входящие сообщения к нам не придут.

Подключение и вебхук

  1. Проект → «Каналы» → «Добавить канал» → WhatsApp, вкладка официального подключения.
  2. Заполните «Meta API Token», «Phone Number ID», «WhatsApp Business Account ID» и «Номер телефона».
  3. После сохранения откроется экран с «Callback URL» и «Verify Token».

Вебхук здесь настраивается вручную — это требование Meta. Скопируйте оба значения и вставьте их в приложении Meta: WhatsApp → Configuration → Edit → Callback URL и Verify token, затем подпишитесь на поле messages.

Проверка

Нажмите «Проверить» на карточке канала. Затем напишите на подключённый номер с другого телефона — диалог должен появиться в «Диалогах».

Частые ошибки

  • «WhatsApp Phone Number ID is required». Поле пустое: Phone Number ID берётся на экране API Setup, это не сам номер телефона.
  • «Invalid WhatsApp Cloud API credentials». Токен временный или не имеет доступа к этому номеру.
  • Meta не принимает Callback URL. Проверьте, что Verify Token скопирован точно, без пробела в конце.
  • Первое сообщение клиенту не уходит. Вне 24 часов после сообщения человека WhatsApp разрешает только заранее одобренные шаблоны.