WhatsApp Business

Как подключить официальный номер WhatsApp Business через WhatsApp Cloud API: ключи Meta, поля формы, вебхук, 24-часовое окно и шаблоны.

Это подключение официального номера через WhatsApp Cloud API от Meta. Номер живёт в бизнес-аккаунте WhatsApp (WABA), а не на телефоне, и переписка идёт по бизнес-правилам Meta.

Нужен обычный номер с телефона — это WhatsApp по QR-коду, другая инструкция.

Что нужно подготовить заранее

Всё это делается на стороне Meta, до захода в Lalexi:

Бизнес-аккаунт WhatsApp (WABA) в Meta Business.
Номер телефона, заведённый в WABA. Он не должен быть при этом привязан к обычному приложению WhatsApp или WhatsApp Business — номер живёт либо там, либо в API. Если номер уже занят, его сначала освобождают.
Приложение в Meta for Developers с подключённым продуктом WhatsApp.
Постоянный токен доступа — токен системного пользователя с правами whatsapp_business_messaging и whatsapp_business_management. Временный токен с вкладки «API Setup» живёт сутки: канал на нём создастся, а на следующий день отвалится.

На странице приложения WhatsApp → API Setup заодно скопируйте два значения: Phone number ID и WhatsApp Business Account ID.

Ничего из этого ещё не сделано — пройдите это по шагам: Бизнес-аккаунт WhatsApp.

Подключение делает администратор пространства: раздел Настройки → Источники сотруднику с ролью «оператор» открыт лишь частично: стандартные источники он не заводит — см. Команда.

Как подключить

Откройте Настройки → Источники (в английском интерфейсе — Settings → Inboxes) и нажмите Добавить источник (Add Inbox).
Выберите канал WhatsApp.
На шаге выбора провайдера нажмите WhatsApp Cloud. Вариант Twilio нужен, только если ваши номера обслуживает Twilio.

Заполните форму:

Форма подключения WhatsApp Cloud API

Поле	Что вводить
Имя источника	Как канал будет называться в списке чатов, например «WhatsApp Business».
Номер телефона	Номер из WABA в международном формате: со знаком `+`, без пробелов и дефисов.
ID номера телефона	Phone number ID из панели Meta — только цифры.
ID бизнес-аккаунта	WhatsApp Business Account ID из панели Meta — только цифры.
Ключ API	Постоянный токен доступа.

Нажмите Создать канал WhatsApp.
На следующем шаге добавьте операторов — сотрудников, которые будут видеть эти переписки, и себя в том числе. Без этого шага диалоги никому не видны.

Что происходит само

Ничего дописывать в панели Meta не нужно — Lalexi при создании канала сам:

проверяет ключи, обращаясь к Meta (если данные неверны, канал просто не создастся);
при необходимости регистрирует номер в Cloud API;
прописывает вебхук у Meta — адрес обратного вызова и токен проверки, чтобы входящие сообщения приходили в Lalexi.

Посмотреть Webhook Verification Token и текущий API Key, заменить ключ на новый или обновить список шаблонов можно потом в самом источнике: его карточка → вкладка Configuration.

Это правило Meta, а не Lalexi: свободно писать клиенту можно только 24 часа после его последнего сообщения. Когда окно закрылось, поле ответа блокируется с подсказкой, что доступны только шаблоны, и отправить можно лишь одобренный шаблон — выбрать его можно там же, в окне диалога.

Шаблоны создаются и проходят модерацию на стороне Meta. Кнопка Sync Templates во вкладке Configuration подтягивает свежий список — нажмите её после того, как Meta одобрит новый шаблон.

Чего у этого канала нет

Официальный номер не участвует в инструментах, рассчитанных на личные аккаунты: он не занимает слот в лимите подключений, у него нет вкладки «Подключение» и он недоступен в рассылках, прогреве и «Новом сообщении»; его сообщения не попадают в Расход. SLA, контроль качества и отчёты работают как обычно.

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

Симптом	Причина
При создании канала — ошибка про неверные данные	Токен без нужных прав, временный (уже истёк) токен, либо перепутаны местами ID номера и ID бизнес-аккаунта.
Форма не принимает номер	Номер должен начинаться с `+` и идти без пробелов, скобок и дефисов.
Форма не принимает ID	В обоих полях ID — только цифры, без пробелов.
Номер уже используется	Один и тот же номер нельзя завести в двух источниках. Удалите старый источник или используйте другой номер.
Канал создан, но входящие не приходят	Проверьте, что номер в WABA закреплён за тем же приложением, чей токен вы указали, и что приложение не в режиме разработки с ограничениями.
Нельзя написать первым — «только шаблон»	Закрылось 24-часовое окно. Отправьте одобренный шаблон.