Skip to main content
Partner Direct Link (TP Lite) — это вариант интеграции для Tech Partner YCloud. Вам потребуется запросить активацию функции в YCloud для вашего аккаунта, однако становиться партнером Meta не требуется. Создайте временную ссылку для онбординга на своем сервере. Клиент может открыть ее напрямую или с помощью кнопки на вашем сайте. Начните с Direct Link для тестирования интеграции, а затем используйте кнопку SDK, если хотите, чтобы клиенты проходили регистрацию во всплывающем окне.

Обзор интеграции

  1. Подготовьте свой аккаунт. Запросите у YCloud включение Partner Direct Link, создайте API-ключ и настройте обработчик Webhook.
  2. Настройте точку входа. Откройте Partner Direct Link в панели управления и настройте брендинг, URL перенаправления или разрешенные источники SDK (origins).
  3. Создайте ссылку. Ваш сервер запрашивает ссылку для онбординга клиента в вашей системе.
  4. Предоставьте клиенту возможность подключиться. Клиент открывает размещенную страницу или всплывающее окно SDK и проходит авторизацию в Meta.
  5. Подтвердите результат. Ваш бэкенд получает Webhook и связывает WABA с клиентом.

Перед началом работы

  1. Обратитесь в YCloud для включения Partner Direct Link для вашего аккаунта. Если вы еще не являетесь Tech Partner, подайте заявку на участие в программе.
  2. Создайте API-ключ в разделе Разработчикам > API-ключи.
  3. Настройте свой обработчик в разделе Разработчикам > Webhook и подпишитесь на whatsapp.business_account.updated.
Вызывайте API создания ссылок со своего сервера. Никогда не размещайте API-ключ в коде для браузера или мобильного приложения. Относитесь к каждому URL онбординга как к временным учетным данным: не публикуйте их на открытых страницах, в аналитике и общедоступных логах.
  1. Откройте панель управления YCloud для аккаунта, в котором включен Partner Direct Link.
  2. Разверните раздел Разработчикам в левом боковом меню.
  3. Нажмите Partner Direct Link , чтобы открыть страницу конфигурации.
Страница Partner Direct Link с основными настройками и предпросмотром размещенной страницы регистрации

Open Developers > Partner Direct Link to configure your branding and entry point. This example shows the settings before configuration.

Страница содержит Основные настройки для вашего брендинга и Интеграцию для создания ссылки, интеграции точки входа и подписки на Webhook. Используйте Предпросмотр размещенной страницы , чтобы увидеть интерфейс со стороны клиента.

Настройка брендинга и точки входа

Перейдите в Разработчикам > Partner Direct Link в панели управления YCloud. Заполните Основные настройки: Для источников SDK укажите точную схему, домен и (при необходимости) порт без пути. Добавляйте каждый поддомен или порт отдельно; подстановочные знаки (wildcards) не поддерживаются. В рабочей среде используйте HTTPS. HTTP разрешен только для локальной разработки (localhost). Direct Link работает без настройки разрешенных источников SDK; кнопка SDK требует их наличия.

Создание ссылки онбординга на вашем сервере

  • WhatsApp Business Platform (WHATSAPP_BUSINESS_PLATFORM): выберите этот режим для подключения номера и отправки сообщений через API и ваше программное обеспечение.
  • Совместное использование с WhatsApp Business App (WHATSAPP_BUSINESS_APP): выберите этот режим для подходящего существующего номера Business App, если клиент хочет продолжать использовать приложение и дополнительно отправлять сообщения через API на том же номере.
Поддерживаемые локали: en_US (английский), zh_CN (упрощенный китайский), es_ES (испанский), pt_BR (бразильский португальский), id_ID (индонезийский) и ru_RU (русский). Значения чувствительны к регистру. Другие значения возвращают HTTP 400. Пример ответа:
expiresAt — это время истечения срока действия в виде Unix timestamp в миллисекундах. Срок действия ссылки по умолчанию составляет два часа. Каждая ссылка подключает одного клиента к одному WABA. До завершения регистрации клиент может обновить страницу, повторить попытку или открыть ссылку в другом браузере, пока она остается действительной. После успешной привязки ссылку нельзя использовать для привязки другого WABA. Создайте новую ссылку, если клиенту необходимо изменить или добавить WABA. Добавьте кнопку подключения в клиентское приложение. Когда клиент нажимает её, запросите ссылку для подключения у своего сервера и выполните переход на onboardingUrl или откройте её в новом окне. Вы также можете отправить её лично клиенту по безопасному каналу связи один на один. Клиент открывает размещенную страницу и нажимает Продолжить с Meta. Он использует аккаунт Facebook с разрешением на управление своей компанией и выбирает или создает свою компанию, WABA и номер телефона в Meta. YCloud выполняет привязку и отображает результат.
Интеграция Direct Link с плейсхолдером URL онбординга и предварительным просмотром страницы регистрации клиента

Direct Link integration and the hosted page preview. This example has no generated onboarding link.

Если вы настроили URL перенаправления, после успешной регистрации происходит перенаправление на него с добавлением status=connected в качестве query-параметра. Используйте это для обновления страницы на стороне клиента; используйте вебхук ниже, чтобы подтвердить привязку в вашем бэкенде.

Вариант 2: Кнопка SDK

Добавьте origin вашей страницы в Allowed SDK origins, затем загрузите SDK. Код в браузере обращается к вашему бэкенду для получения ссылки. Маршрут /api/ycloud/onboarding-link ниже — это пример маршрута, который вы реализуете на своем сервере.
onStatus(result) сообщает о статусе регистрации: onError(error) означает, что SDK не удалось открыть регистрацию. Его code может быть POPUP_BLOCKED или INVALID_ONBOARDING_URL. onClose(event) срабатывает только тогда, когда клиент закрывает окно до получения окончательного результата, с reason: "USER_CLOSED". Эти колбэки обновляют ваш фронтенд. Используйте серверный Webhook как окончательный результат привязки.

Подтверждение привязки с помощью вебхука

Этап интеграции Partner Direct Link, показывающий событие вебхука whatsapp.business_account.updated

Subscribe to whatsapp.business_account.updated in Developers > Webhooks to receive the binding result.

YCloud отправляет whatsapp.business_account.updated на настроенный вами приемник вебхуков после успешной привязки. В следующем фрагменте показаны поля, используемые вашей интеграцией:
Когда updateEvent имеет значение PARTNER_ADDED, обрабатывайте WABA как вновь добавленный. Сопоставьте partnerCustomerId с вашим клиентом и сохраните WABA id. Значение paymentMethodAttached, равное true, означает, что прикрепление кредитной линии прошло успешно; false означает, что оно еще не завершено. Выполняйте дедупликацию доставок с помощью id события и возвращайте HTTP 2xx после успешного получения. См. раздел Webhooks для настройки приемника.