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

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

Обновлено: 12 декабря 2025 г

В этом документе объясняется, как предложить вашим бизнес-клиентам предварительно подтвержденные номера телефонов. Предварительно подтвержденные номера телефонов для бизнеса — это номера телефонов WhatsApp, которые уже были вами проверены, что избавляет клиентов от необходимости связываться с вами для получения одноразового пароля.

Скриншот предварительно подтвержденных телефонных номеров во встроенном процессе регистрации

Обратите внимание, что предварительно подтвержденные номера телефонов для бизнеса представлены WhatsApp Business Pre-Verified Phone Number , которые являются временными . Когда клиент из числа предприятий выбирает один из этих номеров и завершает процесс встроенной регистрации, временный объект будет заменен действительным объектом WhatsApp Business Phone Number . Вам необходимо получить идентификатор этого нового объекта и использовать его для регистрации номера в течение 90 дней.

Требования

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

Ограничения

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

Отображение предварительно проверенных номеров во встроенной системе регистрации

Вы можете отображать предварительно проверенные номера телефонов компаний в процессе встроенной регистрации, используя предварительно заполненные данные формы . Для этого добавьте 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-запрос / /phone_numbers для получения списка номеров телефонов WhatsApp Business в аккаунте WhatsApp Business.

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

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

GET /102290129340398/phone_numbers?display_phone_number=16505551234

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

Use the GET //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'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

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

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