Предварительно проверенные номера телефонов | Документация для разработчиков
Предварительно проверенные номера телефонов
Обновлено: 12 декабря 2025 г
В этом документе объясняется, как предложить вашим бизнес-клиентам предварительно подтвержденные номера телефонов. Предварительно подтвержденные номера телефонов для бизнеса — это номера телефонов WhatsApp, которые уже были вами проверены, что избавляет клиентов от необходимости связываться с вами для получения одноразового пароля.
Обратите внимание, что предварительно подтвержденные номера телефонов для бизнеса представлены WhatsApp Business Pre-Verified Phone Number , которые являются временными . Когда клиент из числа предприятий выбирает один из этих номеров и завершает процесс встроенной регистрации, временный объект будет заменен действительным объектом WhatsApp Business Phone Number . Вам необходимо получить идентификатор этого нового объекта и использовать его для регистрации номера в течение 90 дней.
Требования
Ограничения
verification_expiry_time .Если вы добавите номер телефона в пул предварительно проверенных бизнес-номеров (Шаг 1), но не подтвердите его в течение 90 дней (Шаг 3), он будет удален из вашего пула, и вам придется добавить его заново.После того как корпоративный клиент подтвердит получение предварительно проверенного корпоративного номера телефона, у вас есть 90 дней на его регистрацию.Создание предварительно проверенных номеров
Выполните следующие шаги, чтобы создать предварительно подтвержденный номер телефона для бизнеса, отобразить его во встроенной системе регистрации и зарегистрировать после того, как его подтвердит бизнес-клиент.
Шаг 1: Создайте предварительно подтвержденный номер телефона для вашей компании
Используйте POST /
Синтаксис запроса
ПОЧТА /<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: Запросите код подтверждения
Используйте POST /
Синтаксис запроса
ПОЧТА /<WHATSAPP_BUSINESS_PRE_VERIFIED_PHONE_NUMBER_ID> /request_code ?code_method=<CODE_METHOD> &language=<LANGUAGE>
Ответ
В случае успеха API вернет
true .{ "успех":<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_ID> /verify_code ?code=<CODE>
Ответ
В случае успеха API вернет
true и для номера будет статус проверки кода (code_verification_status) в значение VERIFIED на 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 дней после проверки, его статус изменится на «НЕПРОВЕРЕНО» , но он все равно будет отображаться во встроенном процессе регистрации. Если корпоративный клиент попытается получить неподтвержденный номер, он должен будет пройти проверку самостоятельно, то есть запросить у вас одноразовый пароль.Чтобы избежать подобных ситуаций, мы рекомендуем отслеживать, когда вы подтвердили номер, и повторно подтверждать его до того, как он снова станет неподтвержденным.
Если вы не знаете, когда в последний раз подтверждали предварительно проверенный номер телефона компании, запросите
code_verification_time и verification_expiry_time в идентификаторе предварительно проверенного номера телефона компании. Эти поля указывают время последней проверки и время истечения срока действия проверки.Определение того, был ли номер занят через встроенную регистрацию
Получение и регистрация заявленных телефонных номеров
После того как корпоративный клиент подтвердит предварительно проверенный номер телефона для бизнеса, он будет заменен проверенным номером телефона для бизнеса через WhatsApp ( объект WhatsApp Business Phone Number
code_verification_status равным VERIFIED ).У вас будет 90 дней, чтобы зарегистрировать этот номер, используя его идентификатор. Если вы не зарегистрируете его в течение этого времени, он вернется в
«НЕПОДТВЕРЖДЕНО» , и вам придется запросить новый код подтверждения и использовать его для проверки номера телефона WhatsApp для бизнеса .Получение заявленных номеров посредством регистрации сессии
Если вы используете логирование сессий , идентификатор будет возвращен в событии сообщения и перехвачен вашим обработчиком событий. Отправьте этот идентификатор на свой сервер, а затем используйте его для регистрации бизнес-номера телефона WhatsApp.
Получение заявленных номеров через API
Если вы не используете логирование сессий, используйте GET-запрос /
Проанализируйте
display_phone_number каждого объекта, возвращенного в результирующем наборе. Если у объекта в результирующем наборе display_phone_number совпадает с номером, который вы использовали для создания предварительно подтвержденного рабочего номера телефона, то этот объект представляет собой рабочий номер телефона WhatsApp, который заменил предварительно подтвержденный рабочий номер телефона. Скопируйте идентификатор этого объекта и используйте его для регистрации рабочего номера телефона WhatsApp.В качестве альтернативы, вы можете использовать ту же конечную точку с
поля для запроса display_phone_number и указать отображаемый номер телефона. Например:GET /102290129340398/phone_numbers?display_phone_number=16505551234
Получите предварительно проверенные номера телефонов для бизнеса
Используйте GET /
ПОЛУЧАТЬ /<BUSINESS_ACCOUNT_ID> /preverified_numbers
Результаты автоматически сортируются по времени создания. Вы также можете использовать расширение полей, чтобы запросить
code_verification_status и получить от API только предварительно проверенные номера телефонов компаний с указанным статусом проверки:ПОЛУЧАТЬ /<BUSINESS_ACCOUNT_ID> /preverified_numbers?code_verification_status=VERIFIED
Передача и аннулирование предварительно проверенных номеров
Используйте POST /
Партнеры, использующие данное решение, могут предоставлять предварительно проверенные номера телефонов своих компаний в процессе внедрения встроенной системы регистрации.
Если вы делитесь номерами с несколькими деловыми партнерами, мы рекомендуем попросить их получить список предварительно проверенных номеров, прежде чем отображать их во встроенной системе регистрации. Это снизит вероятность того, что партнер попытается отобразить номер, который уже занят (занятые номера не отображаются в процессе регистрации, но партнер может об этом не знать и удивляться, почему они не отображаются).
Синтаксис запроса на совместное использование
ПОЧТА /<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 Business клиента, прошедшего регистрацию. Для этого сначала выполните все шаги по созданию предварительно подтвержденного номера , а затем используйте идентификатор предварительно подтвержденного номера для выполнения шагов 1 и 4 в «Регистрация номеров телефонов» .