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

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

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

Обновлено: 12 декабря 2025 г
В этом документе объясняется, как предложить вашим бизнес-клиентам предварительно подтвержденные номера телефонов. Предварительно подтвержденные номера телефонов для бизнеса — это номера телефонов WhatsApp, которые уже были вами проверены, что избавляет клиентов от необходимости связываться с вами для получения одноразового пароля.
Скриншот предварительно подтвержденных телефонных номеров во встроенном процессе регистрацииСкриншот предварительно подтвержденных телефонных номеров во встроенном процессе регистрации
Обратите внимание, что предварительно проверенные номера телефонов компаний обозначены символом Предварительно подтвержденный номер телефона для WhatsApp Business объекты, которые являются временныйКогда корпоративный клиент выбирает один из этих номеров и завершает процесс регистрации через встроенную систему, временный объект будет заменен действительным номером Номер телефона WhatsApp для бизнеса объект. Вы должны получить этот новый объект'объект's ID и использовать его для зарегистрируйте номер в течение 90 дней.

Требования

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

    Ограничения

      Вы несёте ответственность за отслеживание того, кто подтвердил получение предварительно проверенного корпоративного номера телефона.Если предварительно подтвержденный номер корпоративного телефона не будет востребован конечным пользователем в процессе встроенной регистрации в течение 90 дней после проверки, номер вернется в неподтвержденный статус и должен быть подтвержден повторно для восстановления его статуса на следующие 90 дней.Невостребованные предварительно проверенные номера телефонов компаний может'может'Повторная проверка невозможна до истечения 45 дней до запланированного перехода в непроверенный статус. Это время обозначается символом verification_expiry_time поле.Если вы добавите номер телефона в пул предварительно проверенных бизнес-номеров (Шаг 1), но не подтвердите его в течение 90 дней (Шаг 3), он будет удален из вашего пула, и вам придется добавить его заново.После того как корпоративный клиент подтвердит получение предварительно проверенного корпоративного номера телефона, у вас есть 90 дней на его регистрацию.

      Создание предварительно проверенные номера

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

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

      Используйте ПОЧТА /<BUSINESS_PORTFOLIO_ID> /add_phone_numbers Конечная точка для добавления предварительно проверенного корпоративного номера телефона в пул корпоративных номеров телефонов вашего бизнес-портфеля.
      Синтаксис запроса
      ПОЧТА /<BUSINESS_PORTFOLIO_ID> /add_phone_numbers ?phone_number=<PHONE_NUMBER>
      Ответ
      В случае успеха API вернет Предварительно подтвержденный номер телефона для WhatsApp Business Идентификатор. Сохраните это значение для использования в следующем запросе.
      { "идентификатор": "<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: Запросите код подтверждения
      Используйте ПОЧТА /<WHATSAPP_BUSINESS_PRE_VERIFIED_BUSINESS_PHONE_NUMBER_ID> /request_code Конечная точка для запроса одноразового пароля по SMS или голосовой связи для вновь созданного предварительно подтвержденного корпоративного номера телефона.
      Синтаксис запроса
      ПОЧТА /<WHATSAPP_BUSINESS_PRE_VERIFIED_PHONE_NUMBER_ID> /request_code ?code_method=<CODE_METHOD> &language=<LANGUAGE>

      Ответ
      В случае успеха API вернет результат истинный.
      { "успех":<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: Проверьте номер
      Используйте ПОЧТА /<WHATSAPP_BUSINESS_PRE_VERIFIED_PHONE_NUMBER> /verify_code Конечная точка для проверки номера с помощью одноразового пароля.
      Синтаксис запроса
      ПОЧТА /<WHATSAPP_BUSINESS_PRE_VERIFIED_PHONE_NUMBER_ID> /verify_code ?code=<CODE>

      Ответ
      В случае успеха API вернет результат истинный и это число будет иметь свои статус_проверки_кода установить на ПРОВЕРЕНО в течение 90 дней.
      { "успех":<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 дней после проверки, его статус изменится на «НЕПРОВЕРЕНО» , но он все равно будет отображаться во встроенном процессе регистрации. Если корпоративный клиент попытается получить неподтвержденный номер, он должен будет пройти проверку самостоятельно, то есть запросить у вас одноразовый пароль.
      

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

      Если вы дон'дон'Если вы не знаете, когда в последний раз подтверждали определенный предварительно проверенный номер телефона компании, запросите подтверждение время_проверки_кода и verification_expiry_time Поля в предварительно проверенном идентификаторе бизнес-телефона. В этих полях указывается время последней проверки и время истечения срока действия проверки.
      

      

      

      

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


      

      

      

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

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

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

      

      

      

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

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

      

      

      

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

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

      Анализ для display_phone_number свойство каждого объекта, возвращаемого в результирующем наборе. Если у объекта в результирующем наборе есть display_phone_number Этот объект представляет собой номер телефона WhatsApp, заменивший предварительно подтвержденный рабочий номер телефона, который соответствует номеру, использованному для создания такого номера. Скопируйте это объект'объект'Используйте свой ID для регистрации бизнес-номера телефона WhatsApp.
      

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

      GET /102290129340398/phone_numbers?display_phone_number=16505551234

      

      

      

      

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

      Используйте ПОЛУЧАТЬ /<BUSINESS_PORTFOLIO_ID> /preverified_numbers конечная точка для получения списка всех Предварительно подтвержденный номер телефона для WhatsApp Business объекты, независимо от статуса их проверки, в вашем бизнесе счет'счет's пул предварительно проверенных бизнес-телефонных номеров:
      

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

      

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

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

      

      

      

      Совместное использование
и неразглашение предварительно проверенных номеров
      Используйте ПОЧТА /<BUSINESS_PORTFOLIO_ID> /share_preverified_numbers конечная точка для обмена предварительно проверенными номерами телефонов компаний с многопартнерское решение Вы являетесь участником или отправляете запрос на удаление к той же конечной точке, чтобы отменить общий доступ к ним.
      Партнеры, использующие данное решение, могут предоставлять предварительно проверенные номера телефонов своих компаний в процессе внедрения встроенной системы регистрации.
      Если вы делитесь контактными данными с несколькими деловыми партнерами, мы рекомендуем вам уведомить ваших партнеров об этом получить список общих предварительно проверенных номеров перед отображением их во встроенной системе регистрации. Это снижает вероятность того, что партнер попытается отобразить номер, который уже занят (занятые номера не отображаются в процессе регистрации, но партнер может об этом не знать и удивляться, почему он не отображается).
      Синтаксис запроса на совместное использование
      ПОЧТА /<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 }
      Программная регистрация предварительно проверенных номеров
      

      Если вы настроили встроенную форму регистрации для обойти экран добавления номера телефонаВы можете зарегистрировать предварительно проверенные номера телефонов для зарегистрированных компаний клиент'клиент'Создать бизнес-аккаунт WhatsApp программным способом. Для этого сначала выполните все необходимые шаги создать предварительно подтвержденный номерЗатем используйте предварительно проверенный номер для завершения Шаг 1 и Шаг 4 в Зарегистрируйте телефонные номера документ.
      
    
              
      
    
      

            
      
        
      
    
      

    
      

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