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

Встроенная регистрация на хостинге | Документация для разработчиков

Встроенная регистрация на хостинге

Обновлено: 4 ноября 2025 г
Если вы не хотите внедрять встроенную регистрацию, добавляя код JavaScript на свой веб-сайт или клиентский портал, вы можете использовать ссылку, при нажатии на которую отобразится веб-страница с описанием этапов регистрации и кнопка, запускающая процесс встроенной регистрации:

Ограничения

Встроенная регистрация с использованием хостинга («Hosted ES») может использоваться только для подключения бизнес-клиентов к Cloud API, и этот процесс нельзя настроить.

Требования

    Для того чтобы стать партнером по решениям или поставщиком технологий, необходимо выполнить все необходимые шаги.Если ваше приложение предназначено для обмена сообщениями, оно должно уметь отправлять сообщения, управлять шаблонами и иметь правильно настроенную конечную точку веб-перехватчика в рабочей среде.Ваше приложение должно быть подписано на account_update .Партнеры по решениям должны иметь кредитную линию.
    Вам также понадобится:
      Ваш системный токен .Секрет вашего приложения.

      Шаг 1: Создание конфигурации входа через Facebook для бизнеса

      Если у вас еще нет конфигурации для входа через Facebook для бизнеса, вам необходимо ее создать. Конфигурация для входа через Facebook для бизнеса определяет, какие разрешения запрашивать и какую дополнительную информацию собирать у бизнес-клиентов, которые получают доступ к встроенной регистрации.
      Перейдите в раздел «Вход через Facebook для бизнеса» > «Настройки» и нажмите «+ Создать конфигурацию» , чтобы начать процесс настройки.
      Используйте имя, которое поможет вам отличить эту конфигурацию от любых других, которые вы можете создать в будущем. При завершении процесса обязательно выберите вариант входа через встроенную форму регистрации WhatsApp:
      При выборе ресурсов и разрешений отбирайте только те ресурсы и разрешения, которые действительно понадобятся вашим бизнес-клиентам.
      Например, если вы выберете «Каталоги» , но вам на самом деле не нужен доступ к каталогам клиентов, ваши клиенты, скорее всего, прервут процесс на экране выбора каталога и попросят вас уточнить.

      Шаг 2: Получите URL-адрес Hosted ES

      Перейдите в WhatsApp > Быстрый старт и нажмите «Просмотреть процесс адаптации» .
      Найдите регистрации в интеграции Zero . URL-адрес, отображаемый в карточке, — это URL-адрес страницы регистрации:
      Нажмите кнопку «Копировать» , чтобы скопировать URL-адрес в буфер обмена. Привяжите этот URL-адрес к кнопке на вашем веб-сайте или в клиентском портале, которая при нажатии откроет URL-адрес в новом окне браузера.
      Чтобы увидеть, как это выглядит, вы можете открыть URL-адрес в новом окне или вкладке браузера, или щелкнуть синюю иконку «новое окно», что сделает то же самое.
      Эта страница для новых пользователей выглядит так:
      Нажмите «Начать» . Это схема взаимодействия, которую увидят бизнес-клиенты, нажав на кнопку на вашем веб-сайте или в клиентском портале. При желании вы можете пройти весь процесс до конца.

      Шаг 3: Получение идентификаторов активов клиентов

      Когда корпоративный клиент завершает процесс, запускается веб-перехватчик account_update событием PARTNER_ADDED . Из полезной нагрузки веб-перехватчика можно получить идентификатор бизнес-аккаунта WhatsApp клиента и идентификатор его бизнес-портфеля .

      Шаг 4: Сгенерируйте хеш HMAC-SHA256

      Сгенерируйте хеш HMAC-SHA256 из секретного ключа вашего приложения и системного токена.

      Пример использования Bash для Linux и macOS

      

      echo -n "<SYSTEM_TOKEN> " | openssl dgst -sha256 -hmac "<APP_SECRET> "
      

        — Ваш системный токен.— Ваш секрет приложения ( Панель управления приложением > Настройки приложения > Основные )

        

        

        

        Шаг 5: Получите бизнес-токен
        

        Используйте POST /  /system_user_access_tokens  бизнес-токена клиента . (Нацельтесь на идентификатор бизнес-портфеля клиента, а не на свой).
        

        

        

        Запрос
синтаксис
        curl 'https://graph.facebook.com/<API_VERSION> /<BUSINESS_PORTFOLIO_ID> /system_user_access_tokens' \ -H 'Content-Type: application/x-www-form-urlencoded' \ -H 'Authorization: Bearer<SYSTEM_TOKEN> ' \ -d 'appsecret_proof=<APPSECRET_PROOF> ' \ -d 'fetch_only=true'
          <API_VERSION> — Версия API.<APPSECRET_PROOF> — Хэш HMAC-SHA256 вашего секретного ключа приложения и системного токена.<BUSINESS_PORTFOLIO_ID> — Идентификатор бизнес-портфеля корпоративного клиента.<SYSTEM_TOKEN> — Ваш системный токен.
          Синтаксис ответа
          В случае успеха:
          { "access_token": "<BUSINESS_TOKEN> " }
            <BUSINESS_TOKEN> — Бизнес-токен корпоративного клиента.
            Шаг 6: Получите идентификатор номера корпоративного телефона клиента
            Используйте ПОЛУЧАТЬ /<WHATSAPP_BUSINESS_ACCOUNT_ID> /номера_телефона Конечная точка для получения и сохранения идентификатора номера корпоративного телефона клиента.
            Синтаксис запроса
            curl 'https://graph.facebook.com/<API_VERSION> /<WHATSAPP_BUSINESS_ACCOUNT_ID> /phone_numbers' \ -H 'Авторизация: Bearer'<BUSINESS_TOKEN> '
              <API_VERSION> — Версия API.<BUSINESS_TOKEN> — Бизнес-токен корпоративного клиента.<WABA_ID> — Идентификатор бизнес-аккаунта WhatsApp клиента.
              Синтаксис ответа
              { "data": [ { "verified_name": "<VERIFIED_NAME> ", "code_verification_status": "<CODE_VERIFICATION_STATUS> ", "display_phone_number": "<DISPLAY_PHONE_NUMBER> ", "quality_rating": "<QUALITY_RATING> ", "platform_type": "<PLATFORM_TYPE> ", "пропускная способность": { "уровень": "<THROUGHPUT_LEVEL> " }, "last_onboarded_time": "<LAST_ONBOARDED_TIME> ", "webhook_configuration": { "application": "<WEBHOOK_CALLBACK_URL> " }, "идентификатор": "<BUSINESS_PHONE_NUMBER_ID> " } ] }
                <BUSINESS_PHONE_NUMBER_ID> — Идентификатор рабочего телефонного номера.<CODE_VERIFICATION_STATUS> — Статус подтверждения номера корпоративного телефона.<DISPLAY_PHONE_NUMBER> — Номер телефона компании, указанный на дисплее.<LAST_ONBOARDED_TIME> — Unix-метка времени, указывающая, когда номер был добавлен в бизнес-аккаунт WhatsApp клиента (по сути, когда клиент успешно завершил процедуру)<PLATFORM_TYPE> — Платформа.<QUALITY_RATING> — Рейтинг качества бизнес-телефонных номеров.<THROUGHPUT_LEVEL> — Уровень пропускной способности.<VERIFIED_NAME> — Подтвержденное имя по рабочему номеру телефона.<WEBHOOK_CALLBACK_URL> — URL-адрес обратного вызова веб-перехватчика, связанный с номером.
                Шаг 7: Подключение клиента к системе
                

                Для подключения корпоративного клиента выполните действия, описанные в соответствующем руководстве по подключению ниже:
                

                  Подключение корпоративных клиентов в качестве поставщика технологий или технологического партнера (пропустите шаг 1)Внедрение корпоративных клиентов в качестве партнеров по решениям (пропустите шаг 1)
                  
    
                          
                  
    
                  

            
                  
        
                  
    
                  

    
                  

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