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

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

Предварительно проверенные номера телефонов

Обновлено: 12 декабря 2025 г
В этом документе объясняется, как предложить вашим бизнес-клиентам предварительно подтвержденные номера телефонов. Предварительно подтвержденные номера телефонов для бизнеса — это номера телефонов WhatsApp, которые уже были вами проверены, что избавляет клиентов от необходимости связываться с вами для получения одноразового пароля.
Скриншот предварительно подтвержденных телефонных номеров во встроенном процессе регистрацииСкриншот предварительно подтвержденных телефонных номеров во встроенном процессе регистрации
Note that pre-verified business phone numbers are represented by WhatsApp Business Pre-Verified Phone Number objects, which are temporary. When a business customer selects one of these numbers and completes the Embedded Signup flow, the temporary object will be replaced by a valid Номер телефона WhatsApp для бизнеса object. You must get this new объект'объект's ID and use it to register the number within 90 days.

Требования

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

    Ограничения

      Вы несёте ответственность за отслеживание того, кто подтвердил получение предварительно проверенного корпоративного номера телефона.Если предварительно подтвержденный номер корпоративного телефона не будет востребован конечным пользователем в процессе встроенной регистрации в течение 90 дней после проверки, номер вернется в неподтвержденный статус и должен быть подтвержден повторно для восстановления его статуса на следующие 90 дней.Unclaimed pre-verified business phone numbers can’can't be re-verified until 45 days before they are scheduled to revert to an unverified status. This time is indicated by the verification_expiry_time field.Если вы добавите номер телефона в пул предварительно проверенных бизнес-номеров (Шаг 1), но не подтвердите его в течение 90 дней (Шаг 3), он будет удален из вашего пула, и вам придется добавить его заново.После того как корпоративный клиент подтвердит получение предварительно проверенного корпоративного номера телефона, у вас есть 90 дней на его регистрацию.

      Создание pre-verified numbers

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

      Шаг 1: Создайте предварительно подтвержденный номер телефона для вашей компании

      Используйте POST /<BUSINESS_PORTFOLIO_ID>/add_phone_numbers endpoint to add a pre-verified business phone number to your business portfolio’s pool of business phone numbers.
      Синтаксис запроса
      ПОЧТА /<BUSINESS_PORTFOLIO_ID> /add_phone_numbers ?phone_number=<PHONE_NUMBER>
      Ответ
      Upon success, the API will return a WhatsApp Business Pre-Verified Phone Number ID. Capture this value for use in the next request.
      { "идентификатор": "<WHATSAPP_BUSINESS_PRE_VERIFIED_PHONE_NUMBER_ID> " }
      Образец запроса
      curl -X POST 'https://graph.facebook.com/v25.0/506914307656634/add_phone_numbers?phone_number=15550783881' \ -H 'Авторизация: Bearer EAAJB...'

      Пример ответа
      { "id": "106540352242922" }
      Шаг 2: Запросите код подтверждения
      Используйте POST /<WHATSAPP_BUSINESS_PRE_VERIFIED_BUSINESS_PHONE_NUMBER_ID>/request_code endpoint to request a one-time-password over SMS or voice for the newly created pre-verified business phone number.
      Синтаксис запроса
      ПОЧТА /<WHATSAPP_BUSINESS_PRE_VERIFIED_PHONE_NUMBER_ID> /request_code ?code_method=<CODE_METHOD> &language=<LANGUAGE>

      Ответ
      Upon success, the API will return истинный.
      { "успех":<SUCCESS> }
      Кроме того, мы отправим на указанный номер телефона SMS или голосовое сообщение с одноразовым паролем. Сохраните этот одноразовый пароль для использования в следующем запросе.
      Синтаксис SMS с одноразовым паролем
      код WhatsApp<CODE>
      Синтаксис голосовых сообщений с одноразовым паролем
      Повторить три раза.
      Код подтверждения:<CODE>
      Образец запроса
      curl -X POST 'https://graph.facebook.com/v25.0/106540352242922/request_code?code_method=SMS&language=en_US' \ -H 'Авторизация: Bearer EAAJB...'

      Пример ответа
      { "success": true }
      Пример SMS-сообщения с одноразовым паролем
      Код WhatsApp 123-456
      Пример голосового сообщения с одноразовым паролем
      Повторить три раза.
      Код подтверждения: 123456
      Шаг 3: Проверьте номер
      Используйте POST /<WHATSAPP_BUSINESS_PRE_VERIFIED_PHONE_NUMBER>/verify_code endpoint to verify the number using its one-time-password.
      Синтаксис запроса
      ПОЧТА /<WHATSAPP_BUSINESS_PRE_VERIFIED_PHONE_NUMBER_ID> /verify_code ?code=<CODE>

      Ответ
      Upon success, the API will return истинный and the number will have its code_verification_status установить на VERIFIED for 90 days.
      { "успех":<SUCCESS> }
      Образец запроса
      curl -X POST 'https://graph.facebook.com/v25.0/106540352242922/verify_code?code=123456' \ -H 'Авторизация: Bearer EAAJB...'

      Пример ответа
      { "success": true }
      После того как у вас появится предварительно подтвержденный номер телефона компании со статусом "подтверждено" (или набор таких номеров), отобразите их в новом встроенном процессе регистрации.
      Отображение предварительно проверенных номеров во встроенной системе регистрации
      

      Вы можете отображать предварительно проверенные номера телефонов компаний в процессе встроенной регистрации, используя предварительно заполненные данные формы . Для этого добавьте  preVerifiedPhone со  ids в  настройки и присвойте идентификаторы ваших предварительно проверенных номеров телефонов компаний в виде массива строк свойству ids :
      

      

      { объем: '<SCOPE> ', extras: { feature: '<FEATURE> ', setup: { preVerifiedPhone: { ids: [<IDS> ] } } } }
      

      Например:
      

      

      { scope: 'business_management,whatsapp_business_management', extras: { feature: 'whatsapp_embedded_signup', version: 2, setup: { business: { name: 'Acme Inc.', email: ' [email protected] ', phone: { code: 1, number: '6505551234' }, website: 'https://www.acme.com', address: { streetAddress1: '1 Acme Way', city: 'Acme Town', state: 'CA', zipPostal: '94000', country: 'US' }, timezone: 'UTC-08:00' }, phone: { displayName: 'Acme Inc.', category: 'ENTERTAIN', description: 'Gears and widgets' }, preVerifiedPhone: { ids: ['106540352242922','105954558954427'] } } } }
      

      Обратите внимание, что если предварительно подтвержденный номер телефона компании со статусом «ПРОВЕРЕНО» не будет востребован в течение 90 дней после проверки, его статус изменится на «НЕПРОВЕРЕНО» , но он все равно будет отображаться во встроенном процессе регистрации. Если корпоративный клиент попытается получить неподтвержденный номер, он должен будет пройти проверку самостоятельно, то есть запросить у вас одноразовый пароль.
      

      Чтобы избежать подобных ситуаций, мы рекомендуем отслеживать, когда вы подтвердили номер, и повторно подтверждать его до того, как он снова станет неподтвержденным.
      

      Если вы дон'дон't know when you last verified a given pre-verified business phone number, request the code_verification_time и verification_expiry_time fields on the pre-verified business phone number ID. These fields indicate its most recent verification time and its verification expiration time.
      

      

      

      

      Определение того, был ли номер занят через встроенную регистрацию
      


      

      

      

      Получение и регистрация заявленных телефонных номеров
      

      После того как корпоративный клиент подтвердит предварительно проверенный номер телефона для бизнеса, он будет заменен проверенным номером телефона для бизнеса через WhatsApp ( объект WhatsApp Business Phone Number  code_verification_status  равным VERIFIED ).
      

      У вас будет 90 дней, чтобы зарегистрировать этот номер, используя его идентификатор. Если вы не зарегистрируете его в течение этого времени, он вернется в  «НЕПОДТВЕРЖДЕНО» , и вам придется запросить новый код подтверждения и использовать его для  проверки номера телефона WhatsApp для бизнеса .
      

      

      

      

      Получение заявленных номеров посредством регистрации сессии
      

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

      

      

      

      Получение заявленных номеров через API
      

      Если вы не используете логирование сессий, используйте GET-запрос /  /phone_numbers для получения списка номеров телефонов WhatsApp Business в аккаунте WhatsApp Business.
      

      Parse for the display_phone_number property on each object returned in the result set. If an object in the result set has a display_phone_number value that matches a number you used to create a pre-verified business phone number, the object represents the WhatsApp business phone number that has replaced the pre-verified business phone number. Copy this объект'объект's ID and use it to register the WhatsApp business phone number.
      

      В качестве альтернативы, вы можете использовать ту же конечную точку с  поля для запроса  display_phone_number и указать отображаемый номер телефона. Например:
      

      GET /102290129340398/phone_numbers?display_phone_number=16505551234

      

      

      

      

      Получите предварительно проверенные номера телефонов для бизнеса
      

      Используйте GET /<BUSINESS_PORTFOLIO_ID>/preverified_numbers endpoint to get a list of all WhatsApp Business Pre-Verified Phone Number objects, regardless of their verification status, in your business account’account's pool of pre-verified business phone numbers:
      

      ПОЛУЧАТЬ /<BUSINESS_ACCOUNT_ID> /preverified_numbers

      

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

      ПОЛУЧАТЬ /<BUSINESS_ACCOUNT_ID> /preverified_numbers?code_verification_status=VERIFIED

      

      

      

      Совместное использование
and unsharing pre-verified numbers
      Используйте POST /<BUSINESS_PORTFOLIO_ID>/share_preverified_numbers endpoint to to share pre-verified business phone numbers with a multi-partner solution you are a part of, or a DELETE request to the same endpoint to unshare them.
      Партнеры, использующие данное решение, могут предоставлять предварительно проверенные номера телефонов своих компаний в процессе внедрения встроенной системы регистрации.
      If you are sharing numbers with multiple business partners, we recommend that you advise your partners to get a list of shared pre-verified numbers before surfacing them in Embedded Signup. This reduces the likelihood of a partner attempting to surface a number that has already been claimed (claimed numbers do not appear in the flow, but the partner might not know this and wonder why it’s not appearing).
      Синтаксис запроса на совместное использование
      ПОЧТА /<BUSINESS_ID> /share_preverified_numbers ?partner_business_id=<PARTNER_BUSINESS_ID> &preverified_id=<PREVERIFIED_ID>

      Синтаксис запроса на отмену совместного доступа
      УДАЛИТЬ /<BUSINESS_ID> /share_preverified_numbers ?partner_business_id=<PARTNER_BUSINESS_ID> &preverified_id=<PREVERIFIED_ID>

      Ответ
      В случае успеха API вернет значение true. Если вы предоставляете доступ к номеру, сообщите своему деловому партнеру о новом предварительно подтвержденном номере и укажите его идентификатор. Если вы отказываетесь от предоставления доступа, номер больше не будет отображаться в реализации встроенной регистрации партнера.
      { "успех":<SUCCESS> }
      Пример запроса на совместное использование
      curl -X POST 'https://graph.facebook.com/v17.0/share_preverified_numbers?partner_business_id=506914307656634&preverified_id=1706193509821738' \ -H 'Авторизация: Bearer EAAH0...'
      Пример запроса на отмену доступа
      curl -X DELETE 'https://graph.facebook.com/v17.0/share_preverified_numbers?partner_business_id=506914307656634&preverified_id=1706193509821738' \ -H 'Авторизация: Bearer EAAH0...'
      Пример ответа
      { "success": true }
      Программная регистрация предварительно проверенных номеров
      

      If you have customized Embedded Signup to bypass the phone number addition screen, you can register pre-verified business phone numbers on an onboarded business клиент'клиент's WhatsApp Business Account programmatically. To do this, first complete all of the steps to create a pre-verified number, then use the pre-verified number ID to complete Step 1 и Step 4 в Register Phone Numbers document.
      
    
              
      
    
      

            
      
        
      
    
      

    
      

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