ВойтиНачать бесплатный пробный период
easyCoexistence Официальные API

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.

10 to 200

Новых клиентов-бизнесов, которых Tech Provider может подключить за скользящие 7 дней: 10 по умолчанию, 200 после верификации и проверки.

2 videos

Записи экрана, которые App Review требует от Tech Provider: отправка и получение сообщения и создание шаблона сообщения.

About 24 hours

Заявленное Meta среднее время рассмотрения App Review для приложения WhatsApp.

2.24.17

Самая старая версия приложения WhatsApp Business, которую клиент может подключить через Coexistence.

30 seconds

Срок действия кода, который возвращает Embedded Signup и который сервер обменивает на бизнес-токен клиента.

Какие есть два способа подключить номера ваших клиентов?

Оба используют Embedded Signup от Meta с Coexistence и приводят к одному результату: номер клиента в Cloud API продолжает работать в приложении WhatsApp Business, а ваш бэкенд хранит собственный бизнес-токен клиента. Различие в том, кто выполняет требования Meta и отвечает за код вокруг всплывающего окна.

Your own Tech Provider appeasyCoexistence's hosted page
Before the first customerBusiness verification, App Review and your own Embedded Signup buildAn API key and a card on the account
Name in Meta's popupYour appeasyCoexistence, with your name on the page around it
Code you maintainThe popup, the token exchange, webhook subscriptions and the history syncA session request and a return page
The 14-day ruleA PARTNER_REMOVED webhook for your app to handleconnection.disconnected with PRIMARY_INACTIVITY
Meta's message chargesOn the customer's WhatsApp Business AccountOn 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 или карта.

1Your pageYour name, the checklist and one Connect button
2Meta's popupFacebook sign-in, the number, then the business portfolio
3QR codeScanned from inside the WhatsApp Business app
4In the appConnect, then Confirm: share chat history or not
5Back to youConnected, then your redirect_url

Что происходит внутри всплывающего окна 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-код нужно сканировать тем же телефоном, поэтому удобнее компьютер.
Настройка с EasyCoexistence

Ваш бэкенд получает собственный токен каждого клиента, 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 к вашему приложениюРазмещённые ссылки для подключения номеров WhatsApp и аккаунтов соцсетей: запрос сессии, перенаправление, статусы, срок действия и повторные попытки.Тарифы Unified API для SaaS-платформ: от US$ 9 до US$ 0,75 за подключениеСколько платит платформа за каналы клиентов: от US$ 9 до US$ 0,75 за подключение. Расчёт для 10, 100 и 1 000 клиентов, сборы Meta отдельно.Лимиты и правила Partner API: политики Meta, 20 сообщений в секунду и правило 14 днейПравила, которые платформа соблюдает для каналов клиентов: политики Meta для WhatsApp, 20 сообщений в секунду на номер Coexistence и правило 14 дней.Что означает статус Meta Tech Provider и почему это важноЧто означает статус Meta Tech Provider, какие требования он предъявляет и что меняет для клиента.Какие номера подходят для CoexistenceВерсия приложения, тип аккаунта и доступ к портфелю, а также причины отказа Meta при подключении номера к Coexistence.Подключение номера шаг за шагомЧто происходит при подключении номера через Coexistence, какие действия нужны и какие решения уже нельзя изменить.

Подключите первый канал за две минуты.

Не нужно ждать проверок платформ. Подключите WhatsApp, Instagram, TikTok или другой канал, затем попросите ИИ опубликовать пост, ответить или подготовить отчёт и посмотрите, как он работает.

  • 3 дня бесплатно
  • Отмена в любой момент
  • Только официальные API
  • Мониторинг 24/7

Проверено по состоянию на