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

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

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

Обновлено: 25 ноября 2025 г
Встроенная регистрация — это интерфейс аутентификации и авторизации, совместимый с настольными компьютерами и мобильными устройствами, который упрощает для ваших бизнес-клиентов создание необходимых ресурсов для их успешной регистрации на платформе WhatsApp Business.
Встроенная система регистрации собирает информацию, связанную с бизнесом, от ваших бизнес-клиентов, автоматически генерирует все необходимые для платформы ресурсы WhatsApp и предоставляет вашему приложению доступ к этим ресурсам, чтобы вы могли быстро предоставлять своим бизнес-клиентам услуги обмена сообщениями в WhatsApp.

Как это работает

Встроенная регистрация использует продукт Facebook Login for Business и наш JavaScript SDK. После настройки вы можете добавить ссылку или кнопку на свой веб-сайт или портал, которая запустит этот процесс.
Корпоративным клиентам, перешедшим по ссылке или кнопке, откроется новое окно, в котором они смогут:
    подтвердить их личность, используя их учетные данные Facebook или MetaBusinessПринимаю условия использования Cloud API, WhatsApp Business, Meta, Marketing Messages Lite API и Meta Business ToolВыберите несколько API WhatsApp и примите условия обслуживанияПредоставьте своему приложению доступ к ресурсам WhatsAppВыберите существующий бизнес-портфель или создайте новыйВыберите существующий аккаунт WhatsApp Business (WABA) или создайте новыйВведите и подтвердите их рабочий номер телефона (их собственный или предоставленный вами)Введите отображаемое имя, которое может отображаться вместо номера телефона в приложении WhatsApp
    После успешного завершения Embedded Signup возвращает идентификатор WABA клиента, идентификатор номера телефона компании и код обмена токена в окно, запустившее процесс. Вам необходимо отправить эти данные на свой сервер и использовать их в запросе между серверами для:
      обменять код на бизнес-токен, предназначенный для конкретного клиентазарегистрировать рабочий телефонный номер клиента для использования Cloud APIПодпишите ваше приложение на веб-хуки в WABA клиентаПредоставьте клиенту информацию о вашей кредитной линии (только для партнеров по решениям)
      После выполнения этих шагов, если вы являетесь партнером по решениям или сотрудничаете с таковым, клиент может немедленно начать использовать ваше приложение или приложение вашего партнера для обмена сообщениями. Если вы не являетесь партнером по решениям или не сотрудничаете с таковым, клиент должен сначала привязать способ оплаты к своему WABA, прежде чем сможет начать обмениваться сообщениями.
      Мы тестируем новый интерфейс встроенной регистрации для всех версий. Сам процесс остался неизменным, но после его завершения вы можете увидеть новую «Просмотреть руководство по настройке» . Нажав на нее, вы перейдете на новую страницу с инструкциями по настройке в WhatsApp Manager, где будут предложены дальнейшие шаги:
        Проверка бизнесаУрегулирование вопросов целостности данных и доступ к главной странице службы поддержки бизнесаОтправка первого сообщения через партнерское решениеОтправка сообщений, инициированных бизнесом, с использованием шаблонов

        Владение активами

        , владеют всеми своими ресурсами WhatsApp, которые они могут использовать с другими решениями Meta, такими как реклама, перенаправляющая на WhatsApp .
        Корпоративные клиенты также имеют полный доступ к WhatsApp Manager , который они могут использовать для доступа к своим ресурсам. Обратите внимание, что вы не можете ограничить этот доступ каким-либо образом. Список доступных ресурсов можно посмотреть здесь .

        Ограничения

        Ограничения на прием новых сотрудников

        По умолчанию вы можете подключить до 10 новых корпоративных клиентов в течение 7-дневного периода. В этот лимит включаются только новые клиенты. Вы можете увидеть текущее количество подключенных клиентов в «Менеджер WhatsApp > Обзор партнеров» . Вы получите уведомление по электронной почте, если приблизитесь к этому лимиту.
        Если вы успешно пройдете проверку бизнеса, проверку приложения и проверку доступа, мы автоматически увеличим ваш лимит до 200 новых бизнес-клиентов в течение 7 дней. Если вам необходимо подключать более 200 клиентов в неделю, подайте заявку на получение статуса бизнес -партнера Meta .
        Примечание: существующие бизнес-аккаунты WhatsApp (WABA), изначально созданные через приложение для разработчиков, нельзя выбрать или подключить напрямую через встроенную процедуру регистрации.

        Ограничения на обмен сообщениями для корпоративных клиентов

        Корпоративные клиенты, зарегистрированные через встроенную систему регистрации, изначально имеют стандартные лимиты на количество сообщений , которые можно увеличить с помощью API.

        Ограничения на количество телефонных номеров для корпоративных клиентов

          Номера корпоративных телефонов можно зарегистрировать для использования только с Cloud API. уже используемые в приложении WhatsApp Business номера телефонов компаний , но регистрации пользователей в приложении WhatsApp Business (так называемое «сосуществование») необходимо настроить процесс Для корпоративных клиентов, зарегистрированных через встроенную систему регистрации, действуют стандартные ограничения на количество сообщений .

          поток Cloud API

          Cloud API Flow вы найдете описание каждого экрана, который будет отображаться вашим бизнес-клиентам в рамках стандартной реализации встроенной регистрации.
          Обратите внимание, что если вам известна информация о бизнесе вашего клиента, вы можете внедрить эти данные , что может значительно сократить количество экранов, с которыми приходится взаимодействовать вашим клиентам.

          токены доступа

          Встроенная регистрация генерирует бизнес-токены . Когда бизнес-клиент завершает процесс встроенной регистрации, в качестве события сообщения возвращается код обмениваемого токена, который обрабатывается JavaScript SDK. Вам необходимо обменять этот код на бизнес-токен, используя вызов между серверами.
          Если вы являетесь поставщиком технологических услуг, вы будете использовать исключительно бизнес-токены.
          Если вы являетесь партнером по решениям, вы будете использовать свой токен доступа системного пользователя («системный токен») для предоставления доступа к кредитной линии подключенным бизнес-клиентам, а бизнес-токены — для всего остального. Обратите внимание, что системный пользователь, которому принадлежит токен, должен предоставить вашему приложению business_management и иметь администратора или финансового редактора в вашем бизнес-портфеле, чтобы иметь возможность предоставлять доступ к кредитной линии.

          Разрешения

          Встроенную регистрацию можно настроить для поддержки корпоративных мессенджеров для ваших клиентов. Если вас интересует только взаимодействие с облачным API, вам, скорее всего, понадобится только следующее:
            whatsapp_business_management — необходим, если вашему приложению требуется доступ к настройкам бизнес-аккаунта WhatsApp зарегистрированных клиентов и шаблонам сообщений. whatsapp_business_messaging необходим, если вашему приложению требуется доступ к настройкам бизнес-телефонов зарегистрированных клиентов или если ваше приложение будет использоваться клиентами для отправки и получения сообщений.
            внедрения вы можете указать, какие разрешения необходимы вашему приложению .
            экране авторизации Embedded Signup для всех, кто имеет администратора , разработчика или тестировщика в процессе будут отображаться только те разрешения, которые были одобрены для расширенного доступа в рамках проверки приложения

            Выставление счетов

            Партнеры по решениям

            Если вы являетесь партнером по решениям, у вас уже должна быть кредитная линия , и вы должны принять условия API распределения кредитов в «Настройки бизнеса > Платежи» в Meta Business Suite. Кроме того, вы должны предоставить информацию о своей кредитной линии всем клиентам в рамках процесса подключения.

            Поставщики технологий и технологические партнеры

            Если вы являетесь поставщиком или партнером в сфере технологий, ваши подключенные бизнес-клиенты должны добавить способ оплаты в свой аккаунт WhatsApp Business. Они могут сделать это, следуя инструкциям, описанным в нашей в «Добавление кредитной карты в аккаунт платформы WhatsApp Business» .

            Учетные записи в песочнице

            Вы можете протестировать встроенный процесс регистрации, используя свою учетную запись Facebook, но это может привести к появлению дополнительных бизнес-портфелей, WABA и номеров телефонов компаний. Если вы не хотите загромождать свою учетную запись Facebook тестовыми данными, вы можете вместо этого создать тестовую учетную запись в песочнице и использовать ее для имитации прохождения процесса регистрации бизнес-клиентом.
            После завершения процесса с использованием тестовой учетной записи вам будут возвращены идентификатор WABA этой учетной записи, идентификатор номера телефона компании и код обмена токена

            Ограничения учетной записи песочницы

              Срок действия тестовых учетных записей составляет 30 дней, после чего они деактивируются и должны быть активированы заново для повторного использования.С помощью тестовой учетной записи нельзя создавать дополнительные бизнес-портфели для тестовой среды, WABA-аккаунты или бизнес-телефонные номера; эти активы генерируются автоматически и отображаются во встроенном процессе регистрации.Учетная запись песочницы связана с администратором приложения. Для того чтобы ресурсы учетной записи песочницы отображались во встроенном процессе регистрации, администратор приложения должен войти в свою учетную запись разработчика Meta.Бизнес-портфолио тестового аккаунта не будет отображаться в Meta Business Suite или WhatsApp ManagerВы можете обменять возвращенный код токена на бизнес-токен учетной записи в тестовой среде и использовать его для получения данных об идентификаторе WABA этой учетной записи, однако номер телефона компании нельзя использовать для отправки или получения сообщений.

              Получение учетных записей в песочнице

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

                Удаление учетных записей в песочнице

                Удаление учетных записей в тестовой среде будет осуществляться постепенно в течение нескольких недель, начиная с 25 июня 2025 года.
                Если вы завершили тестирование и хотите сохранить чистоту тестовой среды, вы можете удалить свою учетную запись в песочнице. Удаление учетной записи в песочнице необратимо и удаляет все связанные с ней тестовые данные. Если вы случайно удалили свою учетную запись в песочнице, но вам нужно снова провести тестирование, вы должны создать новую.
                Чтобы удалить свою учетную запись в песочнице:
                  Перейдите в Панель управления приложением > WhatsApp > быстрого запуска .Найдите «Интеграции для тестирования» , а затем найдите свою учетную запись в тестовой среде.Нажмите кнопку «Удалить учетную запись» в

                  555 номеров телефонов для бизнеса

                  Корпоративные клиенты могут зарегистрировать до двух бизнес-номеров 555. Эти номера работают так же, как и стандартные бизнес-номера (в соответствии с правилами ценообразования, рейтингами качества и т. д.), но их отображаемые имена должны быть утверждены, прежде чем их можно будет использовать для отправки сообщений. Кроме того, номера 555:
                    У вас телефонный код США (+1)?У меня телефонный код 555Проверяются автоматическиНе может быть перенесено на другой аккаунт WhatsApp Business или использовано за пределами платформы WhatsApp Business
                    Если ваши бизнес-клиенты имеют право на номера 555, на экране добавления телефонного номера им автоматически будет предоставлена ​​возможность выбрать номер 555:

                    Миграция активов WhatsApp

                    Встроенная регистрация позволяет переносить данные зарегистрированных корпоративных клиентов несколькими способами. См. раздел «Перенос данных корпоративных клиентов» .

                    Обзор приложения

                    Вы не сможете подключать корпоративных клиентов, пока ваше приложение не получит одобрение на расширенный доступ ко всем необходимым разрешениям.
                    приложений и о том, какие документы необходимо предоставить для его успешного завершения, можно узнать в

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

                    Инструмент «Встроенная интеграция регистрации» — это инструмент настройки и тестирования, встроенный в панель управления приложения. Этот инструмент позволяет:
                      Запуск встроенной регистрации в различных конфигурациях процессаПросмотрите данные, которые возвращаются, когда бизнес-клиент завершает процессСгенерируйте код внедрения и запросы для адаптации новых клиентов, которые вы можете скопировать и вставить на свой веб-сайт, корпоративный клиентский портал и серверОтправляйте API-запросы к конечным точкам, которые вам понадобятся при регистрации клиентов, завершивших процесс
                      Доступ к инструменту интеграции можно получить, перейдя в Панель управления приложениями > WhatsApp > Встроенный конструктор регистрации .
                      Примечание: Вспомогательный инструмент для интеграции встроенной регистрации доступен только для приложений бизнес-типа. Тип вашего приложения можно посмотреть в верхней части панели управления приложением.

                      Вебхуки

                      В рамках процесса адаптации необходимо подписать ваше приложение на веб-хуки в WABA каждого бизнес-клиента, завершившего процедуру встроенной регистрации.
                      Веб-хуки будут запускаться и отправляться на URL-адрес обратного вызова, настроенный в вашем приложении, в соответствии с полями веб-хуков, на которые вы подписаны. Это означает, что все веб-хуки для всех ваших подключенных бизнес-клиентов будут отправляться на URL-адрес обратного вызова вашего приложения. Однако вы можете переопределить URL-адрес обратного вызова для отдельного аккаунта WhatsApp Business или бизнес-номера телефона. См. раздел «Переопределение веб-хуков» , чтобы узнать, как это сделать.

                      Локализация

                      Встроенная процедура регистрации доступна на 30 языках. Локализованная версия автоматически запускается в зависимости от языка, на котором корпоративный клиент использует Facebook.
                      Арабский, чешский, датский, греческий, английский (Великобритания), испанский (Испания), испанский, финский, французский (Франция), иврит, хинди, венгерский, индонезийский, итальянский, японский, корейский, норвежский (букмал), голландский, польский, португальский (Бразилия), португальский (Португалия), румынский, русский, шведский, тайский, турецкий, вьетнамский, упрощенный китайский (Китай), традиционный китайский (Гонконг), традиционный китайский (Тайвань).

                      Следующие шаги

                      Узнайте, как внедрить встроенную регистрацию на свой веб-сайт или портал.

                      Комментарии отсутствуют

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