Embedded Signup в WhatsApp для ваших клиентов: собственное приложение Tech Provider или размещённая страница
SaaS может подключить номера приложения WhatsApp Business своих клиентов к Cloud API через Embedded Signup от Meta двумя способами. Можно стать Tech Provider от Meta самостоятельно: это потребует верификации бизнеса, App Review с двумя видео и собственной сборки Embedded Signup. Либо отправить клиентов на размещённую страницу Embedded Signup, которую ведёт провайдер, уже имеющий этот статус, и получить готовое подключение.
easyCoexistence запускает Embedded Signup от Meta с Coexistence на размещённой странице с вашим названием, поэтому клиенты подключают номера без того, чтобы вы становились Tech Provider.
Новых клиентов-бизнесов, которых Tech Provider может подключить за скользящие 7 дней: 10 по умолчанию, 200 после верификации и проверки.
Записи экрана, которые App Review требует от Tech Provider: отправка и получение сообщения и создание шаблона сообщения.
Заявленное Meta среднее время рассмотрения App Review для приложения WhatsApp.
Самая старая версия приложения WhatsApp Business, которую клиент может подключить через Coexistence.
Срок действия кода, который возвращает Embedded Signup и который сервер обменивает на бизнес-токен клиента.
Какие есть два способа подключить номера ваших клиентов?
Оба используют Embedded Signup от Meta с Coexistence и приводят к одному результату: номер клиента в Cloud API продолжает работать в приложении WhatsApp Business, а ваш бэкенд хранит собственный бизнес-токен клиента. Различие в том, кто выполняет требования Meta и отвечает за код вокруг всплывающего окна.
| Your own Tech Provider app | easyCoexistence's hosted page | |
|---|---|---|
| Before the first customer | Business verification, App Review and your own Embedded Signup build | An API key and a card on the account |
| Name in Meta's popup | Your app | easyCoexistence, with your name on the page around it |
| Code you maintain | The popup, the token exchange, webhook subscriptions and the history sync | A session request and a return page |
| The 14-day rule | A PARTNER_REMOVED webhook for your app to handle | connection.disconnected with PRIMARY_INACTIVITY |
| Meta's message charges | On the customer's WhatsApp Business Account | On the customer's WhatsApp Business Account |
Что требует Meta, чтобы стать Tech Provider?
Meta перечисляет шаги в руководстве «Become a Tech Provider», которое App Dashboard открывает в разделе онбординга Tech Provider для сценария WhatsApp:
- Приложение Meta со сценарием WhatsApp, подключённое к вашему Business Portfolio.
- Верификация бизнеса, которая идёт первой: Meta запускает App Review только для верифицированного бизнеса.
- Настройки приложения, такие как иконка, политика конфиденциальности и категория.
- Расширенный доступ к
whatsapp_business_messagingиwhatsapp_business_management, который выдаётся через App Review с письменным объяснением и записью экрана для каждого. - Всего две записи экрана: отправка сообщения из вашего приложения и его получение в WhatsApp, а также создание вашим приложением шаблона сообщения.
Что вы создаёте после одобрения?
Сам процесс подключения, который пошагово описан в руководствах Meta по Embedded Signup:
- Сценарий на вашем сайте через Facebook Login for Business и JavaScript SDK от Meta, на HTTPS-доменах, которые вы разрешили в приложении.
- Coexistence, включённый в конфигурацию сценария, с журналированием сессий, которое Meta для него требует.
- Серверный вызов, который обменивает возвращённый код на бизнес-токен клиента в течение 30 секунд.
- Вебхуки: ваше приложение подписано на аккаунт каждого клиента с полями
account_update, history,smb_app_state_syncиsmb_message_echoes. - Синхронизация контактов и истории в течение 24 часов после подключения; после этого клиент должен отключиться и пройти сценарий заново.
Что берёт на себя размещённая страница?
Всю часть со всплывающим окном. easyCoexistence запускает Embedded Signup с Coexistence через собственное приложение Meta как Tech Provider, на странице easycoexistence.com, где показано ваше название. Обмен токеном, подписка на вебхуки и запрос истории происходят там, а ваш бэкенд получает connection id. Если в сессии указан webhook_url, Meta доставляет сообщения номера прямо на ваш сервер, вместе с разовым импортом контактов и, если клиент разрешит, до 180 дней чатов. Ваш код затем обращается к Graph API Meta напрямую с токеном клиента, а easyCoexistence следит за номером и отправляет подписанные события при его изменении.
Что видит ваш клиент?
Страницу с вашим названием и одну кнопку «Подключить». Перед открытием окна Meta чек-лист просит клиента подтвердить пять пунктов: актуальное приложение WhatsApp Business, номер, который используется не менее 7 дней, отсутствие на нём других API-провайдеров или инструментов автоматизации, отсутствие неофициальных приложений и телефон под рукой с входом в Facebook. От клиента не запрашиваются аккаунт, e-mail или карта.
Что происходит внутри всплывающего окна Meta?
Сначала клиент входит через Facebook, авторизует приложение и вводит номер; затем он видит профиль приложения WhatsApp Business для этого номера и подтверждает его. Далее клиент выбирает или создаёт Business Portfolio и сканирует QR-код внутри приложения WhatsApp Business; Meta также отправляет на номер сообщение WhatsApp со ссылкой на код. В приложении клиент нажимает «Подключить» и решает, делиться ли историей чатов. В конце указываются название аккаунта, часовой пояс и условия Meta. Порядок может меняться, пока Meta внедряет сценарий, который начинается с номера телефона.
Чьё название показывает всплывающее окно Meta?
Название приложения, которое запрашивает доступ. На размещённой странице это easyCoexistence, его нельзя переименовать, а страница вокруг окна показывает ваше название из partner_name. Собственное приложение Tech Provider показывает название вашего приложения, но ценой верификации, проверки и сборки, описанных выше.
Что такое правило 14 дней?
Meta отключает номер Coexistence, если телефон с приложением WhatsApp Business неактивен около 14 дней, и указывает причину как PRIMARY_INACTIVITY. Клиент подключается снова, пройдя сценарий заново с тем же номером. Через размещённую страницу easyCoexistence следит за каждым номером и отправляет на ваш events URL событие connection.disconnected с этой причиной, поэтому новая ссылка на подключение для клиента может вернуть номер.
Распространённые ошибки
- Построение на Embedded Signup v2 или v3. Meta вывела обе версии из эксплуатации 15 октября 2026 года, и запросы к ним обрабатываются как v4.
- Запрос разрешений, которые приложение не использует. Meta называет лишние разрешения распространённой причиной отклонения заявки в App Review.
- Одна запись для двух разрешений. Meta ожидает отдельную запись экрана и письменное объяснение для каждого и может отклонить видео, на котором показано несколько разрешений.
- Просьба подключиться с того же телефона, на котором находится номер. Окно Meta там открывается в новой вкладке, а QR-код нужно сканировать тем же телефоном, поэтому удобнее компьютер.
Ваш бэкенд получает собственный токен каждого клиента, Meta доставляет сообщения прямо на ваш вебхук, а отключения приходят к вам подписанными событиями. От US$ 9 до US$ 0,75 за подключение в месяц, дешевле по мере добавления подключений, первые 3 дня бесплатно.
Часто задаваемые вопросы
Нужно ли быть Meta Tech Provider, чтобы подключать номера WhatsApp моих клиентов?
Только если вы запускаете Embedded Signup из собственного приложения Meta. Отправка клиентов на размещённую страницу, которую ведёт Tech Provider, подключает их номера без вашей собственной верификации бизнеса и App Review.
Сколько по времени занимает App Review Meta для приложения WhatsApp?
Meta указывает среднее время около 24 часов. Верификация бизнеса должна быть завершена до начала проверки, а каждая отклонённая заявка добавляет ещё один круг.
Продолжает ли мой клиент пользоваться приложением WhatsApp Business?
Да. Приложение работает на его телефоне рядом с API, а сообщения синхронизируются между ними. Некоторые функции приложения меняются: списки рассылки становятся только для чтения, а исчезающие сообщения и сообщения одноразового просмотра отключаются.
Кто платит Meta за сообщения?
Клиент. Meta выставляет счёт за сообщения, отправленные через API, на бизнес-аккаунт WhatsApp самого клиента, с платёжным методом, который он добавляет там. Сообщения, отправленные из приложения WhatsApp Business, остаются бесплатными.
Читайте дальше
Подключите первый канал за две минуты.
Не нужно ждать проверок платформ. Подключите WhatsApp, Instagram, TikTok или другой канал, затем попросите ИИ опубликовать пост, ответить или подготовить отчёт и посмотрите, как он работает.
- 3 дня бесплатно
- Отмена в любой момент
- Только официальные API
- Мониторинг 24/7
Проверено по состоянию на