WhatsApp Business API

Официальный канал WhatsApp через Meta Cloud API. В отличие от QR-шлюза, номер не привязан к телефону в руках — сообщения идут через инфраструктуру Meta, аккаунт не блокируется за автоматизацию.

Если официальный аккаунт вам не нужен, проще подключить WhatsApp по QR — см. статью про WhatsApp.

Что понадобится

  • Аккаунт Meta for Developers
  • Бизнес-аккаунт WhatsApp (WABA)
  • Номер телефона, не привязанный к обычному WhatsApp

Шаг 1. Приложение в Meta

  • Откройте developers.facebook.com → My Apps → Create App
  • Тип приложения — Business
  • Добавьте продукт WhatsApp

Шаг 2. Данные из API Setup

В разделе WhatsApp → API Setup заберите три значения:

  • Meta API Token — постоянный токен (временный живёт 24 часа, для боевого канала выпустите System User Token)
  • Phone Number ID — идентификатор номера, а не сам номер
  • WhatsApp Business Account ID (WABA ID)

Шаг 3. Подключение в ImpactBot

  • Проект → Каналы → карточка WABA → Подключить
  • Выберите способ Официально, Meta
  • Заполните Meta API Token, Phone Number ID, WABA ID и номер телефона в международном формате
  • Нажмите «Подключить»

Шаг 4. Webhook на стороне Meta

После подключения ImpactBot покажет Callback URL и Verify Token. Их нужно перенести в Meta:

  • WhatsApp → Configuration → Webhook → Edit
  • Вставьте Callback URL и Verify Token → Verify and save
  • Подпишитесь на поле messages

Пока подписка не сохранена, входящие сообщения до воронки не доедут.

Шаблоны сообщений

WhatsApp запрещает писать первым вне 24-часового окна: если клиент молчал больше суток, отправить можно только шаблон, заранее одобренный Meta. Шаблоны создаются в Meta Business Manager и оттуда подтягиваются в рассылки.

Ответ внутри 24 часов после сообщения клиента — свободный, шаблон не нужен.

Если не получилось

  • Verify and save не проходит — Verify Token скопирован с пробелом или из старого подключения; возьмите значение из карточки канала заново
  • Сообщения не приходят — не подписаны на поле `messages` в Configuration
  • Отправка отвечает ошибкой про 24-часовое окно — используйте одобренный шаблон
  • Через сутки канал замолчал — был выпущен временный токен; замените его на постоянный