Обзор интеграции
- Подготовьте свой аккаунт. Запросите у YCloud включение Partner Direct Link, создайте API-ключ и настройте обработчик Webhook.
- Настройте точку входа. Откройте Partner Direct Link в панели управления и настройте брендинг, URL перенаправления или разрешенные источники SDK (origins).
- Создайте ссылку. Ваш сервер запрашивает ссылку для онбординга клиента в вашей системе.
- Предоставьте клиенту возможность подключиться. Клиент открывает размещенную страницу или всплывающее окно SDK и проходит авторизацию в Meta.
- Подтвердите результат. Ваш бэкенд получает Webhook и связывает WABA с клиентом.
Перед началом работы
- Обратитесь в YCloud для включения Partner Direct Link для вашего аккаунта. Если вы еще не являетесь Tech Partner, подайте заявку на участие в программе.
- Создайте API-ключ в разделе Разработчикам > API-ключи.
- Настройте свой обработчик в разделе Разработчикам > Webhook и подпишитесь на
whatsapp.business_account.updated.
Поиск Partner Direct Link в панели управления
- Откройте панель управления YCloud для аккаунта, в котором включен 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.
Настройка брендинга и точки входа
Перейдите в Разработчикам > 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.
Вариант 1: Direct Link
Добавьте кнопку подключения в клиентское приложение. Когда клиент нажимает её, запросите ссылку для подключения у своего сервера и выполните переход наonboardingUrl или откройте её в новом окне. Вы также можете отправить её лично клиенту по безопасному каналу связи один на один.
Клиент открывает размещенную страницу и нажимает Продолжить с Meta. Он использует аккаунт Facebook с разрешением на управление своей компанией и выбирает или создает свою компанию, WABA и номер телефона в Meta. YCloud выполняет привязку и отображает результат.

Direct Link integration and the hosted page preview. This example has no generated onboarding link.
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 как окончательный результат привязки.
Подтверждение привязки с помощью вебхука
Subscribe to whatsapp.business_account.updated in Developers > Webhooks to receive the binding result.
whatsapp.business_account.updated на настроенный вами приемник вебхуков после успешной привязки. В следующем фрагменте показаны поля, используемые вашей интеграцией:
updateEvent имеет значение PARTNER_ADDED, обрабатывайте WABA как вновь добавленный. Сопоставьте partnerCustomerId с вашим клиентом и сохраните WABA id. Значение paymentMethodAttached, равное true, означает, что прикрепление кредитной линии прошло успешно; false означает, что оно еще не завершено.
Выполняйте дедупликацию доставок с помощью id события и возвращайте HTTP 2xx после успешного получения. См. раздел Webhooks для настройки приемника.

