Бизнес-аккаунт WhatsApp

Это подготовка на стороне Meta: всё, что нужно сделать до того, как открыть форму подключения в Lalexi. На выходе у вас будет четыре значения — номер, Phone number ID, WhatsApp Business Account ID и постоянный токен, — и с ними подключение занимает минуту: WhatsApp Business.

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

Освободите номер

Правило Meta: «Numbers already in use with WhatsApp cannot be registered unless they are deleted first» — номер, живущий в приложении WhatsApp, для API недоступен, пока аккаунт в приложении не удалён. Один номер — либо телефон, либо API, одновременно не бывает.

Номер в обычном WhatsApp или в приложении WhatsApp Business. Удалите аккаунт на телефоне: WhatsApp (или WhatsApp Business) → Настройки → Аккаунт → Удалить мой аккаунт, затем введите номер с кодом страны. После этого номер можно регистрировать в Cloud API.

Номер уже заведён в другом бизнес-аккаунте (WABA). Номер принадлежит только одному бизнес-аккаунту, поэтому его сначала удаляют в старом — в Business settings того портфеля, в разделе с WhatsApp-аккаунтами. Здесь есть три условия Meta:

• удалять номер может только администратор бизнес-портфеля;
• Meta спросит PIN двухшаговой проверки этого номера;
• номер, которым за последние 30 дней отправляли платные сообщения, удалить нельзя — придётся дождаться, пока срок пройдёт.

Номер заблокирован в WhatsApp. Сначала пройдите апелляцию у Meta и дождитесь разблокировки: заблокированный номер в Cloud API не регистрируется.

Какой номер подойдёт

• Мобильный — он должен принять код подтверждения по SMS или голосовым звонком.
• Короткие номера (short code) не поддерживаются совсем.
• Стационарные и VoIP Meta для SMS не рекомендует: код часто не доходит. Если другого номера нет, выбирайте подтверждение звонком.
• Номер не должен стоять в другом источнике Lalexi — дважды один и тот же номер подключить нельзя.

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

1. Откройте developers.facebook.com и войдите под своим аккаунтом Facebook.
2. My Apps → Create App. Укажите название приложения и контактный email.
3. В списке сценариев выберите Connect with customers through WhatsApp.
4. Выберите бизнес-портфель, которому будет принадлежать бизнес-аккаунт WhatsApp. Своего портфеля ещё нет — создайте его здесь же.
5. Просмотрите требования Meta и нажмите Create app.

Бизнес-аккаунт WhatsApp (WABA) Meta создаёт в этом же процессе — отдельно заводить его не нужно.

Шаг 2. Номер в бизнес-аккаунте

1. В приложении откройте Use cases → Connect with customers through WhatsApp → Customize → API Setup. В прежнем интерфейсе это WhatsApp → API Setup в левом меню.
2. Найдите блок Send and receive messages (в новом интерфейсе — Register your WhatsApp phone number) и в списке From нажмите добавление номера.
3. Заполните отображаемое имя бизнеса — его увидят клиенты в WhatsApp, — и данные компании.
4. Введите номер и выберите подтверждение: SMS или звонок. Введите пришедший код.

Тестовый номер, который Meta выдаёт новому приложению сама, для работы не годится: он только для пробных отправок на заранее внесённые номера. Подключайте свой.

Отображаемое имя Meta проверяет отдельно — оно может некоторое время висеть в статусе проверки. Каналу это не мешает: подключать номер в Lalexi можно, не дожидаясь одобрения имени.

Шаг 3. Два ID

На той же странице API Setup скопируйте и сохраните:

• Phone number ID — идентификатор номера;
• WhatsApp Business Account ID — идентификатор бизнес-аккаунта.

Оба — только цифры, и оба понадобятся в форме. Не перепутайте их местами: Lalexi в этом случае откажется создавать канал с ошибкой про неверные данные.

Шаг 4. Постоянный токен

Токен с вкладки API Setup — временный, он живёт сутки. Канал на нём создастся и на следующий день отвалится, поэтому нужен токен системного пользователя.

1. Откройте Business settings (business.facebook.com/settings) и выберите портфель, которому принадлежит бизнес-аккаунт WhatsApp.
2. Users → System users → Add. Задайте имя (например, Lalexi WhatsApp), роль — Admin, нажмите Create system user.
3. Выберите созданного пользователя → Assign assets и выдайте ему приложение из шага 1 и бизнес-аккаунт WhatsApp с полным доступом.
4. Нажмите Generate token и выберите то же приложение.
5. Token expiration — Never.
6. Отметьте права whatsapp_business_messaging и whatsapp_business_management. Без них канал не создастся.
7. Generate token и сразу скопируйте токен.

Вебхук настраивать не нужно

В инструкциях по Cloud API обычно есть отдельный шаг: вписать в приложении Meta Callback URL и Verify token и подписаться на события. В Lalexi этот шаг лишний. Получив ключи, Lalexi при создании канала сам:

• проверяет их у Meta — с неверными ключами канал просто не создастся;
• при необходимости регистрирует номер в Cloud API;
• подписывает приложение на ваш бизнес-аккаунт и задаёт для него адрес обратного вызова со своим токеном проверки — токен проверки Lalexi генерирует сам, вам его нигде вводить не надо;
• подписывается на входящие сообщения и на эхо сообщений, отправленных с телефона.

Поэтому после того, как токен скопирован, в панели Meta делать больше нечего.

Что должно получиться

Дальше — подключение канала в Lalexi: Настройки → Источники → Добавить источник → WhatsApp → WhatsApp Cloud.

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