Версия 3 | Документация для разработчиков
Версия 3
Обновлено: 11 декабря 2025 г
Мы внедряем систему версионирования для встроенной регистрации, которая будет соответствовать Graph API. Версия 3 будет выпущена 29 мая для всех партнеров и будет включать следующие изменения.
Теперь корпоративные клиенты могут завершить процедуру без указания номера телефона
Ранее в версии 2 для завершения процесса всегда требовалась регистрация подтвержденного номера телефона (если партнеры не включили обходной путь для номеров телефонов). Теперь вы можете завершить процесс со статусами, такими как «подтверждено», «неподтверждено» или «номер телефона отсутствует». Вы можете снова пройти через встроенную регистрацию, перейти в менеджер WhatsApp или партнер может использовать вызовы API для подтверждения номера .
Чтобы определить статус телефонного номера, ознакомьтесь с документацией по регистрации информации о сессии.
Ведение журнала информации о сессии включено автоматически
Всем партнерам, использующим версию 3, функция логирования информации о сессиях будет включена автоматически. Партнерам по-прежнему потребуется добавить обработчик событий в том же окне встроенной регистрации для обработки входящей информации.
Добавление features в конфигурацию
Теперь вы можете использовать свойство features для включения ряда функций во встроенной системе регистрации. Это свойство позволяет добавлять несколько функций вместо одной, как это было в версии 2, в свойстве featureType.
синтаксис запроса v3
// Регистрация метода запуска и обратного вызова const launchWhatsAppSignup = () => { FB.login(fbLoginCallback, { config_id: '<CONFIGURATION_ID> ', // Здесь указывается ваш идентификатор конфигурации response_type: 'code', override_default_response_type: true, extras: { version: 'v3' setup: {}, features: [<FEATURE_NAME> ], featureType: '<FEATURE_TYPE> ' } }| Заполнитель | Описание | Пример |
|---|---|---|
<FEATURE_NAME> | Название функции, которую необходимо включить в конфигурации ES. Примечание: Вы можете оставить это поле пустым, чтобы следовать стандартному алгоритму обработки данных. Возможные значения: app_only_install — Позволяет партнерам получать доступ к WABA только через API, используя бизнес-токен .marketing_messages_lite — Включает API MM для процесса регистрации в WhatsApp. | { features: [ { name: 'marketing_messages_lite' } ] } |
<FEATURE_TYPE> | Названия типов функций, которые необходимо включить в конфигурации ES. Значение может быть только whatsapp_business_app_onboarding , что включает в себя настраиваемый процесс регистрации номера телефона в приложении WhatsApp Business. | whatsapp_business_app_onboarding |
Удаление нескольких типов функций в конфигурации ES.
В версии 2 корпоративным клиентам, активирующим пользовательский процесс, потребуется пройти встроенную регистрацию несколько раз в зависимости от количества типов функций, добавленных в конфигурацию.
Удаление only_waba_sharing
Процесс обхода экрана с номером телефона позволяет упростить процедуру регистрации, предоставляя доступ к WABA без необходимости повторной настройки номера телефона. В версии 3 этот процесс больше не поддерживается. Если вы хотите использовать этот процесс, используйте версию 2.
Удаление marketing_messages_lite
Поддержка API маркетинговых сообщений для WhatsApp по-прежнему будет осуществляться через аргумент features. Если вы хотите продолжать использовать этот процесс, обновите свою конфигурацию следующим образом.
Устранение сосуществования
Для запуска процесса адаптации пользователей к приложению WhatsApp Business партнерам необходимо использовать
параметр whatsapp_business_app_onboarding вместо coexistence .Встроенная форма регистрации с предварительным заполнением больше не будет пропускать экраны.
Партнеры по-прежнему смогут предварительно заполнять информацию о своей компании во встроенной системе регистрации, но у бизнес-клиентов не будет возможности пропускать какие-либо экраны в процессе регистрации. Партнерам, которые все же хотят использовать этот процесс, следует придерживаться версии 2.
Компания Measurement Partners должна оставаться на версии 2
Обратите внимание, что на данный момент поддержка подключения к продуктам Measurement доступна только в версии 2. Продолжение поддержки партнеров Measurement имеет важное значение и будет реализовано в будущей версии.
Комментарии отсутствуют
Комментарии отсутствуют