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

After approval, open Partner > Tech Partner and select Partner Direct Link.
Настройка брендинга и точки входа
Перейдите в раздел 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.
Вариант 1: Direct Link
Добавьте кнопку подключения в ваше клиентское приложение. Когда клиент нажимает её, запросите ссылку для подключения с вашего сервера и перейдите по адресуonboardingUrl или откройте её в новом окне. Вы также можете отправить её клиенту конфиденциально по защищенному каналу связи один на один.
Клиент открывает размещенную страницу и нажимает Continue with Meta. Он использует аккаунт Facebook с разрешением на управление своей компанией и выбирает или создает компанию, WABA и номер телефона в Meta. YCloud завершает привязку и отображает результат.

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

