Перейти к основному содержимому

Предварительное заполнение экранов | Документация для разработчиков

Предварительное заполнение экранов

Обновлено: 10 ноября 2025 г
Если вам известны подробности о бизнесе вашего клиента, такие как его название и адрес, вы можете внедрить эти данные во встроенную форму регистрации. Это позволит автоматически заполнять поля или полностью обходить их, значительно сокращая объем ввода и взаимодействия, необходимых вашим клиентам.
Например, вот экран портфолио компании, предварительно заполненный названием компании, адресом электронной почты, веб-сайтом, страной и предварительно подтвержденным номером телефона компании:
Мы рекомендуем добавить данные о вашем бизнес-портфеле , предварительно подтвержденный номер телефона и данные телефонного профиля . Добавление этих данных обеспечит наилучшее взаимодействие с вашим клиентом, поскольку:
    полностью заполняет экран бизнес-портфолиоОбходит экраны выбора и создания бизнес-аккаунта WhatsApp (WABA)Обходит экраны выбора и подтверждения номера телефона компанииавтоматически устанавливает информацию профиля рабочего телефонного номера в клиенте WhatsApp

    Вспомогательная функция интеграции встроенной регистрации

    Вспомогательный инструмент для интеграции встроенной регистрации предоставляет удобный способ создания предварительно заполненных данных и тестирования их влияния на процесс. Для доступа к инструменту создания данных:
      Перейдите в Панель управления приложениями > WhatsApp > Встроенный конструктор регистрации .Найдите Настройка встроенной регистрации» .Найдите «Встроенная форма предварительной регистрации» .Нажмите «Редактировать данные предварительного заполнения» .

      Внедрение данных

      Функция FB.login , которая вызывается при запуске встроенной регистрации бизнес-клиентом, принимает объект в качестве аргумента. Используйте extras.setup для внедрения данных:
      // Регистрация метода запуска и обратного вызова const launchWhatsAppSignup = () => { FB . login ( fbLoginCallback , { config_id : ' ' , // Здесь указывается ваш идентификатор конфигурации response_type : 'code' , override_default_response_type : true , extras : { setup : { business : { // Здесь указываются данные бизнес-портфеля }, preVerifiedPhone : { // Здесь указываются идентификаторы предварительно проверенных номеров телефонов }, phone : { // Здесь указываются данные профиля номера телефона }, whatsAppBusinessAccount : { // Здесь указываются идентификаторы WABA } }, featureType : '' , sessionInfoVersion : '3' , } }); }

      Данные бизнес-портфеля

      На экран отображения бизнес-портфеля можно ввести следующие данные о бизнес-портфеле:
        название бизнес-портфеляадрес электронной почты для бизнес-портфолиовеб-сайт-портфолио бизнесаСтрана, входящая в портфель компаний (а также дополнительные адресные данные)рабочий номер телефона
        В качестве альтернативы вы можете ввести только существующий идентификатор бизнес-портфеля , и его имеющиеся данные будут автоматически добавлены на экран. Это может быть полезно, если вы хотите связать предварительно проверенный номер телефона с существующим бизнес-портфелем клиента.
        Вставка данных о бизнес-портфеле приведет к автоматическому заполнению экрана бизнес-портфеля, а также к тому, что встроенная регистрация пропустит экраны выбора и создания WABA-карты.
        Ввод данных о номере телефона компании автоматически заполнит экран добавления номера телефона :
        Обратите внимание, что даже если вы введете данные, бизнес-клиент все равно сможет редактировать эти данные с помощью «Редактировать» , если пожелает.
        Когда корпоративный клиент завершит процесс, введенная вами информация о его бизнес-портфеле будет использована для создания бизнес-портфеля и WABA-плана этого клиента.
        Синтаксис бизнес-объектов
        настройка: { бизнес: { id:<BUSINESS_PORTFOLIO_ID> , имя: '<BUSINESS_PORTFOLIO_NAME> ', электронная почта: '<BUSINESS_PORTFOLIO_EMAIL_ADDRESS> ', веб-сайт: '<BUSINESS_PORTFOLIO_WEBSITE> ', адрес: { streetAddress1: '<BUSINESS_PORTFOLIO_STREET_ADDRESS_LINE_1> ', streetAddress2: '<BUSINESS_PORTFOLIO_STREET_ADDRESS_LINE_2> ', город: '<BUSINESS_PORTFOLIO_CITY> ', состояние: '<BUSINESS_PORTFOLIO_STATE> ', zipPostal: '<BUSINESS_PORTFOLIO_ZIP_CODE> ', страна: '<BUSINESS_PORTFOLIO_COUNTRY> ' }, phone: { code:<BUSINESS_PORTFOLIO_COUNTRY_CALLING_CODE> , число: '<BUSINESS_PORTFOLIO_PHONE_NUMBER> ' }, часовой пояс: '<BUSINESS_PORTFOLIO_TIME_ZONE> ' } }
        Параметры бизнес-объекта
        
Заполнитель

Описание

Пример значения

        <BUSINESS_PORTFOLIO_ID>
        Целое число или null
        Этот параметр обязателен, если используется существующий бизнес-портфель; в противном случае установите значение null или пропустите его, чтобы создать новый портфель.
        Укажите существующий идентификатор бизнес-портфеля клиента, если хотите, чтобы экран автоматически заполнялся данными, уже указанными в бизнес-портфеле, или если хотите связать с этим портфелем предварительно подтвержденный номер телефона.
        Если указан идентификатор портфеля, мы проверим, является ли этот портфель собственностью бизнес-клиента.
        Если объект принадлежит им, мы внедрим его существующие данные в поток и проигнорируем все остальные свойства бизнес-объекта.
        Если они не являются владельцами, мы добавим  business.name , business.email , business.website и address.country , если они заданы . Если какое-либо из них не задано, вместо этого будет отображен экран портфолио компании по умолчанию.
        Установите значение null (или полностью опустите  id ), если хотите создать новый бизнес-портфель на основе введенных  business.name , business.email , business.website и address.country .
        2729063490586005
        <BUSINESS_PORTFOLIO_NAME>
        Нить
        Обязательно при создании нового бизнес-портфеля.
        Название бизнес-портфеля.
        Если это имя совпадает с именем существующего бизнес-портфеля, принадлежащего клиенту, будет использоваться существующий портфель (он будет рассматриваться так, как если бы вы присвоили свойству id  ).
        Это имя также будет использоваться в качестве имени бизнес-аккаунта WhatsApp, которое отображается только в менеджере WhatsApp.
        Максимум 100 символов.
        Ветер и шерсть
        <BUSINESS_PORTFOLIO_EMAIL_ADDRESS>
        Нить
        Обязательно при создании нового бизнес-портфеля.
        Адрес электронной почты компании.
        Эта информация отобразится в Meta Business Suite > Бизнес-портфолио > Настройки >  информации о бизнесе .
        <BUSINESS_PORTFOLIO_COUNTRY_CALLING_CODE>
        Целое число
        Обязательно, если вводится номер телефона компании.
        Рабочий телефонный номер, код страны для звонков.
        1
        <BUSINESS_PORTFOLIO_PHONE_NUMBER>
        Нить
        Обязательно, если вводится номер телефона компании.
        Рабочий телефонный номер, без кода страны.
        6505559999
        <BUSINESS_PORTFOLIO_WEBSITE>
        Нить
        Обязательно при создании нового бизнес-портфеля.
        URL веб-сайта компании.
        Эта информация отобразится в Meta Business Suite > Бизнес-портфолио > Настройки >  информации о бизнесе .
        https://windandwool.com/
        <BUSINESS_PORTFOLIO_STREET_ADDRESS_LINE_1>
        Нить
        Адрес предприятия, строка 1.
        Эта информация отобразится в Meta Business Suite > Бизнес-портфолио > Настройки >  информации о бизнесе .
        1. Хакерский путь
        <BUSINESS_PORTFOLIO_STREET_ADDRESS_LINE_2>
        Нить
        Адрес компании, строка 2.
        Эта информация отобразится в Meta Business Suite > Бизнес-портфолио > Настройки >  информации о бизнесе .
        Люкс 1
        <BUSINESS_PORTFOLIO_CITY>
        Нить
        Городской адрес компании.
        Эта информация отобразится в Meta Business Suite > Бизнес-портфолио > Настройки >  информации о бизнесе .
        Менло-Парк
        <BUSINESS_PORTFOLIO_STATE>
        Нить
        Государственный адрес компании.
        Эта информация отобразится в Meta Business Suite > Бизнес-портфолио > Настройки >  информации о бизнесе .
        Калифорния
        <BUSINESS_PORTFOLIO_ZIP_CODE>
        Нить
        Почтовый индекс предприятия.
        Эта информация отобразится в Meta Business Suite > Бизнес-портфолио > Настройки >  информации о бизнесе .
        94025
        <BUSINESS_PORTFOLIO_COUNTRY>
        Нить
        Обязательно при создании нового бизнес-портфеля.
        Адрес предприятия, код страны ISO 3166-1 alpha-2 .
        НАС
        <BUSINESS_PORTFOLIO_TIME_ZONE>
        Нить
        Часовой пояс компании указан в формате смещения UTC .
        UTC-07:00
        Пример бизнес-объекта
        setup : { business : { name : 'Wind & Wool' , email : ' [email protected] ' , website : 'https://windandwool.com/' , address : { streetAddress1 : '1 Hacker Way' , streetAddress2 : 'Suite 1' , city : 'Menlo Park' , state : 'California' , zipPostal : '94025' , country : 'US' }, phone : { code : 1 , number : '6505559999' }, timezone : 'UTC-07:00' } }
        Предварительно проверенные номера телефонов
        Если вы вводите предварительно проверенный номер телефона вместе с данными бизнес-портфеля (при создании нового портфеля или использовании существующего), экран бизнес-портфеля будет предварительно заполнен этим номером:
        Если вы не вводите данные о бизнес-портфеле вместе с предварительно проверенным идентификационным номером, номер отобразится на экране выбора WABA :
        синтаксис объекта PreVerifiedPhone
        setup: { preVerifiedPhone: { ids: [ '<PRE-VERIFIED_PHONE_NUMBER_ID> ' ] } }
        Заменять с уникальным, предварительно проверенным идентификатором номера корпоративного телефона.
        Обратите внимание, что хотя значение параметра ids принимает массив строк, если вы укажете более одного предварительно проверенного идентификатора номера телефона компании, на экране выбора WABA отобразится только первый идентификатор из массива.
        Пример объекта preVerifiedPhone
        setup : { preVerifiedPhone : { ids : [ '106540352242922' ] } }
        Данные телефонного профиля
        Вы можете добавить следующие данные профиля номера телефона. Эти данные не заполняются автоматически ни на одном из экранов встроенной регистрации, но они заполняют профиль номера телефона компании в клиенте WhatsApp, который виден пользователям WhatsApp.
          Имя пользователя, отображаемое в профиле номера телефонаКатегория телефонных номеровОписание номера телефона
          Если вы не укажете эти данные, категория будет установлена ​​на «Другое» , и корпоративному клиенту придется самостоятельно устанавливать или редактировать данные своего профиля.
          Ваши клиенты могут сделать это в WhatsApp Manager > Инструменты аккаунта > Панель номеров телефонов , выбрав свой рабочий номер телефона и перейдя во  «Профиль» . Вы также можете предоставить им возможность обновлять его программно, используя POST-запрос. /whatsapp_business_profile endpoint .
          синтаксис объекта телефона
          настройка: { телефон: { displayName: '<PHONE_PROFILE_DISPLAY_NAME> ', категория: '<PHONE_PROFILE_DISPLAY_CATEGORY> ', описание: '<PHONE_PROFILE_DISPLAY_DESCRIPTION> ' } }
          Параметры объекта телефона
          
Заполнитель

Описание

Пример значения

          <PHONE_PROFILE_DISPLAY_NAME>
          Нить
          Необходимый.
          Название профиля компании, видимое пользователям WhatsApp в клиенте WhatsApp (см. скриншот выше).
          Ветер и шерсть
          <PHONE_PROFILE_DISPLAY_CATEGORY>
          Нить
          Необходимый.
          Категория отображения бизнес-профиля.
          Обратите внимание на вертикальное поле в GET /  /whatsapp_business_profile содержит список возможных значений.
          ОДЕЖДА
          <PHONE_PROFILE_DISPLAY_DESCRIPTION>
          Нить
          Необходимый.
          Описание профиля рабочего телефонного номера.
            Максимальное количество символов: 512.Поддерживаются отображаемые эмодзи, однако их значения в кодировке Юникода — нет. Значения Юникода для эмодзи должны быть закодированы с помощью экранирования Java или JavaScript.Можно добавлять гиперссылки, но они не будут отображаться как кликабельные.Markdown не поддерживается.
            Эксклюзивная одежда и товары для дома от начинающих дизайнеров.
            Пример объекта телефона
            setup : { phone : { displayName : 'Wind & Wool' , category : 'APPAREL' , description : 'Изысканная одежда и товары для жизни от начинающих дизайнеров.' } }
            Бизнес-аккаунты WhatsApp
            Если вы используете предварительно проверенный номер телефона, вы также можете указать идентификатор WABA. Это позволит связать предварительно проверенный номер с существующим идентификатором WABA, а не с новым, который корпоративному клиенту будет предложено создать в рамках процесса.
            синтаксис объекта WhatsAppBusinessAccount
            настройка: { whatsAppBusinessAccount: { ids: '<WABA_ID> ' } }
            Заменять с уникальным идентификатором WABA.
            Пример объекта WhatsAppBusinessAccount
            В этом примере предварительно проверенный номер телефона связывается с существующим номером WABA.
            setup : { preVerifiedPhone : { ids : [ '106540352242922' ] }, whatsAppBusinessAccount : { id : [ '432428883295692' ] } }
            Примеры
            Новый бизнес-портфель, предварительно проверенный номер и профиль отображения
            // Регистрация метода запуска и обратного вызова const launchWhatsAppSignup = () => { FB . login ( fbLoginCallback , { config_id : '31602279155865' , response_type : 'code' , override_default_response_type : true , extras : { setup : { business : { name : 'Wind & Wool' , email : ' [email protected] ' , website : 'https://windandwool.com/' , address : { streetAddress1 : '1 Hacker Way' , streetAddress2 : 'Suite 1' , city : 'Menlo Park' , state : 'California' , zipPostal : '94025' , country : 'US' }, phone : { code : 1 , number : '6505559999' }, timezone : 'UTC-07:00' }, preVerifiedPhone : { ids : [ '106540352242922' ] }, phone : { displayName : 'Wind & Wool' , category : 'APPAREL' , description : 'Индивидуально изготовленная одежда и товары для жизни от начинающих дизайнеров.' } }, featureType : '' , sessionInfoVersion : '3' , } }); }
            Существующий бизнес-портфель, предварительно проверенный номер и профиль отображения
            // Регистрация метода запуска и обратного вызова const launchWhatsAppSignup = () => { FB . login ( fbLoginCallback , { config_id : '31602279155865' , response_type : 'code' , override_default_response_type : true , extras : { setup : { business : { id : '2729063490586005' }, preVerifiedPhone : { ids : [ '106540352242922' ] }, phone : { displayName : 'Wind & Wool' , category : 'APPAREL' , description : 'Индивидуальная одежда и товары для жизни от начинающих дизайнеров.' } }, featureType : '' , sessionInfoVersion : '3' , } }); }
            
    
                    
            
    
            

            
            
        
            
    
            

    
            

    
    
            
        
            
             Вернуться наверх