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

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

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

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

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

After approval, open Partner > Tech Partner and select Partner Direct Link.

Страница содержит раздел Basic settings для настройки брендинга и раздел Integration для создания ссылки, интеграции точки входа и подписки на события Webhook. Используйте Hosted page preview , чтобы увидеть страницу так, как ее видит клиент.

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

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

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

  • 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 в миллисекундах. Срок действия ссылки по умолчанию составляет два часа. Каждая ссылка связывает одного клиента с одним WABA. До завершения регистрации клиент может обновить страницу, повторить попытку или открыть ссылку в другом браузере, пока она остается действительной. После успешной привязки ссылка не может быть использована для привязки другого WABA. Создайте новую ссылку, если клиенту необходимо изменить или добавить WABA. Добавьте кнопку подключения в ваше клиентское приложение. Когда клиент нажимает её, запросите ссылку для подключения с вашего сервера и перейдите по адресу onboardingUrl или откройте её в новом окне. Вы также можете отправить её клиенту конфиденциально по защищенному каналу связи один на один. Клиент открывает размещенную страницу и нажимает Continue with 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. Используйте это для обновления страницы клиента; используйте Webhook ниже для подтверждения привязки на вашем бэкенде.

Вариант 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 как окончательный результат привязки.

Подтверждение привязки с помощью Webhook

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

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

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