WhatsApp Business

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

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

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

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

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

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

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

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

1. Откройте Настройки → Источники (в английском интерфейсе — Settings → Inboxes) и нажмите Добавить источник (Add Inbox).

2. Выберите канал WhatsApp.

   

3. На шаге выбора провайдера нажмите WhatsApp Cloud. Вариант Twilio нужен, только если ваши номера обслуживает Twilio.

   

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

   

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

5. Нажмите Создать канал WhatsApp.

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

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

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

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

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

24-часовое окно и шаблоны

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

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

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

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

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