Перейти к основному содержанию
Используйте приложение Meta и партнерское решение для подключения клиентов к WhatsApp через ваше программное обеспечение. Выполните онбординг технического партнера по разработке перед выполнением этих шагов. Сведения о варианте интеграции TP Lite см. в разделе Partner Direct Link.

Шаг 1. Добавление разрешенных доменов

Войдите в Meta Developer App Dashboard и перейдите в раздел Facebook Login for Business > Settings > Client OAuth settings:
Скриншот интерфейса YCloud
Установите следующие переключатели в положение Yes:
  • Client OAuth Login
  • Web OAuth Login
  • Enforce HTTPS
  • Embedded Browser OAuth Login
  • Use Strict Mode for redirect URIs
  • Login with the JavaScript SDK
⚠️ Примечания:
  • Embedded Signup работает на базе JavaScript SDK.
  • Когда корпоративные клиенты завершают процесс Embedded Signup, их WABA ID, business phone number ID и exchangeable token code возвращаются в окно, инициировавшее процесс, но только в том случае, если домен этой страницы добавлен как в Allowed Domains , так и в Valid OAuth Redirect URIs.
  • Добавьте все домены, на которых вы планируете развернуть Embedded Signup (включая тестовые домены в средах разработки).
  • Поддерживаются только домены с поддержкой HTTPS.

Шаг 2. Создание идентификатора конфигурации Facebook Login for Business

Конфигурация Facebook Login for Business определяет, какие разрешения запрашивать и какую дополнительную информацию собирать, когда корпоративные клиенты используют Embedded Signup. В консоли перейдите в раздел Facebook Login for Business > Configurations.
Скриншот интерфейса YCloud
Нажмите Create from template и выберите WhatsApp Embedded Signup Configuration With 60 Expiration Token , чтобы создать конфигурацию. Этот шаблон создает конфигурацию с наиболее часто используемыми разрешениями и уровнями доступа.
Скриншот интерфейса YCloud
После завершения настройки сохраните Configuration ID — он понадобится на следующем шаге.

Шаг 3. Интеграция Embedded Signup на ваш веб-сайт

Добавьте следующий HTML- и JavaScript-код на свой веб-сайт. Это полный код, необходимый для реализации Embedded Signup. Мы рекомендуем настраивать различные сценарии Embedded Signup в зависимости от вашего решения или потребностей клиентов:

Embedded Signup – создание аккаунта WhatsApp API

1. Создание кнопки Embedded Signup

⚠️ Примечания:
  • Замените appId, config_id и solutionID реальными значениями.
  • Фронтенд должен передать waba_id и phone_number_id на ваш бэкенд для получения WABA и регистрации номера (см. ниже).
Подробнее: https://developers.facebook.com/docs/whatsapp/embedded-signup/implementation 2. Привязка WABA и зарегистрированного номера После того как клиент завершит Embedded Signup, ваш фронтенд получит waba_id и phone_number_id и передаст их на ваш бэкенд для последующих вызовов API. Привязка WABA Вызовите YCloud WABA Binding API, затем свяжите его с соответствующим клиентским аккаунтом в вашей системе. Пример запроса:
Пример успешного ответа:
Примечание: если поле ответа paymentMethodAttached имеет значение true, это означает, что YCloud успешно привязал способ оплаты к этому WABA. В противном случае обратитесь в службу поддержки YCloud для решения проблемы. Регистрация номера телефона
Пример ответа

Embedded Signup – сосуществование с приложением WhatsApp Business

1. Создание кнопки Embedded Signup


2. Получение WABA и привязка к YCloud

После того как клиенты завершат Embedded Signup, ваш фронтенд получит waba_id. Передайте его на ваш бэкенд для дальнейших вызовов API. Вызовите YCloud SMB Bind API. После успешного завершения свяжите WABA с учетной записью вашего клиента в вашей системе.
Пример ответа

Часто задаваемые вопросы

Если вы правильно настроили solutionID , клиенты увидят настоящее название Solution Partner во время авторизации через Facebook.
Если они его не видят, конфигурация не вступила в силу.
Убедитесь, что процедура App Review пройдена.
Скриншот интерфейса YCloud
Это может произойти, если пользователь выбирает существующий WABA вместо создания нового.
К существующему WABA уже может быть привязан способ оплаты, который не был удален.
При открытии страницы Embedded Signup может появиться следующее сообщение:Приложение не активно
Это приложение сейчас недоступно, разработчик знает об этой проблеме. Вы сможете войти, когда приложение будет повторно активировано.
Это происходит, когда приложение находится в режиме Development , в котором доступ есть только у тестовых пользователей (см. App Dashboard > App roles > Roles / Test Users).Решение:
Переключите режим приложения на Live через Meta Apps, открыв соответствующее приложение в Dashboard.
Либо авторизуйте текущего пользователя. См.: Assign business assets to people in your business portfolio.
При открытии страницы Embedded Signup может появиться следующее сообщение:Функция недоступна
Вход через Facebook сейчас недоступен для этого приложения, так как мы обновляем дополнительные сведения о нем. Повторите попытку позже.
Решение:
Перейдите в App Dashboard > App Review > Permissions and Features и запросите расширенный доступ к public_profile .