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

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

Обновлено: 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-запрос / Конечная точка для получения списка номеров телефонов WhatsApp Business в аккаунте WhatsApp Business.

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

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

GET /102290129340398/phone_numbers?display_phone_number=16505551234

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

Используйте GET / Конечная точка для получения списка всех предварительно подтвержденных номеров телефонов WhatsApp Business , независимо от их статуса подтверждения, в пуле предварительно подтвержденных номеров телефонов вашей бизнес-учетной записи:

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

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

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

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

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