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

рабочие телефонные номера

Обновлено: 27 февраля 2026 г

В этом документе описываются бизнес-номера телефонов WhatsApp, требования к ним, информация для управления и уникальные особенности.

Регистрация номеров телефонов компаний

Для использования номера телефона для отправки и получения сообщений через Cloud API необходимо зарегистрировать действующий рабочий номер телефона. Зарегистрированные номера можно использовать для повседневных целей, таких как звонки и текстовые сообщения, но их нельзя использовать с мессенджером WhatsApp («WhatsApp»).

Номера, уже используемые в WhatsApp, нельзя зарегистрировать, если их не удалить . Если ваш номер заблокирован в WhatsApp и вы хотите его зарегистрировать, сначала процедуру обжалования .

Обратите внимание, что после выполнения шагов, описанных в нашем документе «Начало работы» для вас будет автоматически сгенерирован и зарегистрирован тестовый

Требования к участию

К участию допускаются следующие номера телефонов:

принадлежит вамУкажите страну и код города (короткие коды не поддерживаются)возможность принимать голосовые вызовы или SMSЧисло должно обладать масштабируемыми возможностями .

Если вы регистрируете номер 1-800, см. раздел «Номера 1-800 и бесплатные номера» для получения дополнительной информации.

Методы регистрации

Панель управления приложения Если вы еще этого не сделали, выполните шаги, описанные в нашем «Начало работы» «Панель управления приложениями» > «WhatsApp» > «Настройка API» , чтобы добавить номер телефона.Meta Business Suite : При использовании Meta Business Suite вы можете зарегистрировать корпоративный номер телефона для создания бизнес-аккаунта WhatsApp .Менеджер WhatsApp : см. нашу статью в справочном центре « Как подключить свой номер телефона к бизнес-аккаунту WhatsApp» .Встроенная регистрация : Если вы работаете с партнером по решениям, он предоставит вам ссылку на встроенную регистрацию, которую вы сможете использовать для регистрации номера телефона.

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

Типы бизнес-телефонных номеров

В этой таблице классифицируются типы телефонных номеров и оценивается их пригодность для получения одноразовых паролей (OTP) через SMS, международные телефонные звонки и мгновенные звонки. Приводятся оценки вероятности успешной доставки в зависимости от типа номера и характеристик оператора связи. Кроме того, предлагаются практические рекомендации для пользователей по повышению успешности доставки без изменения типа телефонного номера.

Тип телефона Описание SMS OTP Голосовой OTP Действия

Мобильная версия (рекомендуется)

Присвоено мобильным устройствам/SIM-картам

Стандарт

Включите прием международных SMS/звонков, убедитесь, что устройство подключено к сотовой сети, предоставьте приложению необходимые разрешения

Фиксированная линия

Приписано к физическим точкам (стационарная телефонная связь)

Не рекомендуется

Стандарт

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

Бесплатный телефон

Звонок бесплатный, оплата производится получателем

Не рекомендуется

Стандарт

Уточните у оператора связи, может ли номер принимать международные SMS-сообщения/звонки, проверьте готовность линии к приему входящих звонков и отключите переадресацию вызовов или функции IVR

Премиум-тариф

Повышенная плата за специальные услуги

Не рекомендуется

Стандарт

Совместные расходы

Стоимость делится между звонящим и получателем

Не рекомендуется

Универсальный доступ

Доступность для обслуживания клиентов по всему миру

Не рекомендуется

Стандарт

Персональный номер

Назначается отдельным лицам, не привязано к устройству

Не рекомендуется

VoIP

Интернет-телефония, не привязанная к физической линии

Не рекомендуется

Стандарт

Убедитесь, что VoIP-провайдер поддерживает международные SMS/звонки с одноразовыми паролями (OTP); проверьте настройки предоставления доступа и учетной записи; убедитесь, что приложение/сервис работает и уведомления включены; убедитесь, что устройство подключено к сети и предоставлены необходимые разрешения

Только въезд

Принимайте только входящие звонки/сообщения

Не рекомендуется

Стандарт

Пейджер

Прикреплен к пейджерам (редко)

Не поддерживается

M2M/IoT

Межмашинное взаимодействие, интеллектуальные устройства

Не рекомендуется

Убедитесь, что устройство и SIM-карта поддерживают входящие международные SMS-сообщения/звонки

Статус

Корпоративные телефонные номера имеют статус, отражающий их рейтинг качества и текущий лимит сообщений . Для отправки и получения сообщений через API корпоративные телефонные номера должны иметь статус «подключено».

Просмотр статуса через WhatsApp Manager

Текущий статус вашего рабочего номера телефона отображается в «Статус» в меню «Менеджер WhatsApp» > «Инструменты учетной записи» > « Номера телефонов» .

Подробнее о рейтингах качества и статусах, отображаемых в WhatsApp Manager, можно узнать в нашей « О рейтинге качества вашего бизнес-номера телефона WhatsApp»

Получение статуса через API

Запросите статуса для вашего бизнес-номера телефона в WhatsApp. См. GET / Справочная информация содержит список возвращаемых значений статуса и их значений.

Пример запрос

curl 'https://graph.facebook.com/v25.0/106540352242922?fields=status' \ -H 'Авторизация: Bearer EAAJB...'

Пример ответа

{ "status": "CONNECTED", "id": "106540352242922" }

Отображаемые имена

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

Имя пользователя WhatsApp отображается в чате

Бизнес-профили

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

Официальный статус бизнес-аккаунта

Рабочие телефонные номера могут получить статус официального бизнес-аккаунта (OBA). В списке контактов рядом с названием номера OBA отображается синяя галочка.

В разделе контактов отображается синяя галочка «Официальный бизнес-аккаунт»

Ознакомьтесь с нашим «Официальный бизнес-аккаунт» , чтобы узнать, как запросить статус OBA для бизнес-телефонного номера.

Двухшаговый проверка

При регистрации корпоративного телефонного номера необходимо установить PIN-код для двухфакторной аутентификации. Ваш PIN-код потребуется при изменении PIN-кода или удалении телефонного номера с платформы.

Изменение PIN-кода через WhatsApp Manager

~~Для смены PIN-кода через WhatsApp Manager вам потребуется ваш текущий PIN-код. Чтобы изменить PIN-код:~~

~~Перейти к~~ ~~Менеджер WhatsApp~~⁠ > ~~Инструменты учетной записи~~ > ~~Номера телефонов~~.~~Выберите номер телефона вашей компании.Нажмите~~ ~~Двухэтапная проверка~~ ~~вкладка.Нажмите~~ ~~Изменить PIN-код~~ ~~Нажмите кнопку и завершите процесс.~~

~~Если у вас нет PIN-кода, вы можете изменить его с помощью API.~~

Изменение PIN-кода через API

~~Используйте~~ ~~ПОЧТА /<WHATSAPP_BUSINESS_PHONE_NUMBER_ID>~~ ~~Конечная точка для установки нового PIN-кода.~~

Пример запроса

curl 'https://graph.facebook.com/v25.0/106540352242922/' \ -H 'Content-Type: application/json' \ -H 'Authorization: Bearer EAAJB...' \ -d ' { "pin": "150954" }'

Пример ответа

~~В случае успеха:~~

{ "success": true }

Отключение двухфакторной аутентификации

Чтобы отключить двухфакторную аутентификацию в WhatsApp Manager, выполните действия, аналогичные изменению PIN-кода, но нажмите на кнопку.. ~~Отключите двухфакторную аутентификацию~~ Вместо этого нажмите кнопку в качестве последнего шага. На адрес электронной почты, связанный с вашим бизнес-портфелем, будет отправлено письмо со ссылкой. Используйте ссылку, чтобы отключить двухфакторную аутентификацию. После отключения вы можете снова включить ее, установив новый PIN-код.

~~Обратите внимание, что отключить двухфакторную аутентификацию с помощью API невозможно.~~

Номера 1-800 и бесплатные номера

Возможно, вам потребуется зарегистрировать на платформе номер 1-800 или другой бесплатный номер. Эти номера обычно находятся за системой интерактивного голосового ответа (IVR). Звонок при регистрации через WhatsApp не может пройти через IVR. Номера телефонов, находящиеся за системой IVR, можно зарегистрировать, но они должны принимать звонки с международных номеров и иметь возможность перенаправлять SMS-сообщения или голосовые вызовы к реальному оператору.

Для регистрации телефонного номера, находящегося за системой интерактивного голосового ответа (IVR):

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

Номера телефонов, используемые в системе IVR и не способные принимать регистрационные звонки, не поддерживаются.

Ограничение на количество зарегистрированных автомобилей

В новых бизнес-портфелях первоначально допускается не более 2 зарегистрированных корпоративных телефонных номеров.

Если ваша компания пройдет верификацию или если вы достигли лимита в 2000 сообщений, Meta автоматически увеличит ваш лимит до 20. После увеличения будет отправлено уведомление Meta Business Suite, информирующее вас о новом лимите, и будет запущен веб-хук business_capability_update max_phone_numbers_per_business , установленным на ваш новый лимит.

Проверять номера телефонов

Вам необходимо подтвердить номер телефона, который вы хотите использовать для отправки сообщений вашим клиентам. Подтверждение номера телефона осуществляется с помощью кода, отправленного по SMS/голосовому вызову. Процесс подтверждения можно выполнить с помощью вызовов Graph API, указанных ниже.

~~Для проверки номера телефона с помощью Graph API выполните следующее:~~ ПОЧТА ~~запрос к~~ НОМЕР_ТЕЛЕФОНА/код_запроса~~В ходе звонка укажите выбранный вами способ подтверждения и язык.~~

~~Конечная точка~~	~~Аутентификация~~
`/НОМЕР_ТЕЛЕФОНА_ID/код_запроса`	~~Пройдите аутентификацию с помощью системного токена доступа пользователя.~~ ~~Если вы запрашиваете код от имени другой компании, токен доступа должен иметь расширенные права доступа~~ `whatsapp_business_management` ~~разрешение.~~

Параметры

~~Имя~~	~~Описание~~
`код_метод` ~~нить~~	~~Необходимый.~~ ~~Выбранный метод проверки. Поддерживаемые варианты:~~ `SMSГОЛОС`
`язык` ~~нить~~	~~Необходимый.~~ ~~Этот язык состоит из двух символов~~ ~~код языка~~ ~~код. Например:~~ `"ен"`.

Пример запроса

curl -X POST 'https://graph.facebook.com/v25.0/106540352242922/request_code?code_method=SMS&language=en_US' \ -H 'Авторизация: Bearer EAAJB...'

После вызова API вы получите код подтверждения выбранным вами способом. Для завершения процесса подтверждения введите свой код в запрос ПОЧТА ~~запрос к~~ НОМЕР_ТЕЛЕФОНА/код_подтверждения.

~~Конечная точка~~	~~Аутентификация~~
`/НОМЕР_ТЕЛЕФОНА_ID/код_проверки`	~~Пройдите аутентификацию с помощью системного токена доступа пользователя.~~ ~~Если вы запрашиваете код от имени другой компании, токен доступа должен иметь расширенные права доступа~~ `whatsapp_business_management` ~~разрешение.~~

Параметры

~~Имя~~	~~Описание~~
`код` ~~числовая строка~~	~~Необходимый.~~ ~~Код, который вы получили после звонка~~ `Идентификатор_номера_телефона/код_запроса`.

Пример

~~Пример запроса:~~

curl -X POST \ 'https://graph.facebook.com/v25.0/FROM_PHONE_NUMBER_ID/verify_code' \ -H 'Авторизация: Bearer ACCESS_TOKEN' \ -F 'code=000000'

~~Успешный ответ выглядит следующим образом:~~

{ "success": true }

Форматы номеров телефонов пользователей WhatsApp

В запросах на отправку сообщений поддерживаются знаки плюса ( + ), дефисы ( - ), скобки ( , ) и

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

Например, если ваша компания находится в Индии (телефонный код страны 91 ) и вы отправляете сообщение на следующий номер телефона клиента в различных форматах:

Номер в запросе на отправку сообщения Номер сообщения, доставленного по адресу Исход

+16315551234

Правильное число

+1 (631) 555-1234

+16315551234

Правильное число

(631) 555-1234

+916315551234

Возможно, неверный номер

1 (631) 555-1234

+9116315551234

Возможно, неверный номер

Примечание: Для Бразилии и Мексики дополнительный префикс телефонного номера может быть изменен с помощью облачного API. Это стандартное поведение системы и не считается ошибкой.

Проверка изменения личности

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

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

Чтобы использовать хеш, включите его в запрос на отправку сообщения. Meta сравнивает хеш в запросе с текущим хешем клиента. Если хеши совпадают, сообщение будет доставлено. Если есть несоответствие, это означает, что клиент изменил свои данные с момента вашей последней отправки сообщения, и сообщение не будет доставлено. Вместо этого вы получите веб-перехватчик сообщений о состоянии с кодом ошибки 137000 , уведомляющий вас о сбое и несоответствии.

При получении веб-хука с несовпадающим хешем, следует предположить, что номеру телефона клиента больше нельзя доверять. Для восстановления доверия повторно проверьте личность клиента, используя другие каналы, не связанные с WhatsApp. После восстановления доверия повторно отправьте неудачно отправленное сообщение новому получателю (если таковой имеется) без хеша. Затем сохраните новый хеш клиента в веб-хуке статуса доставки сообщения.

Запрос синтаксис

~~Отправьте POST-запрос на~~ ~~Номер телефона WhatsApp для бизнеса > Настройки~~ ~~Конечная точка для включения или отключения проверки изменения личности.~~

ПОЧТА /<WHATSAPP_BUSINESS_PHONE_NUMBER> /настройки

Пост тело

{ "user_identity_change" : { "enable_identity_key_check":<ENABLE_IDENTITY_KEY_CHECK> }

Набор Установите значение true , чтобы включить проверку личности, или false, чтобы отключить ее.

Пример запроса на включение

локон

~~'https://graph.facebook.com/v25.0/106850078877666/settings'~~

~~-ЧАС~~

~~'Content-Type: application/json' \ -H 'Authorization: Bearer EAAJB...' \ -d ' { "user_identity_change": { "enable_identity_key_check": true } }'~~

Пример включения ответа

{ "success": true }

Пример отправить сообщение с галочкой

~~Это примерное сообщение будет доставлено только в том случае, если~~ recipient_identity_key_hash ~~Хэш-значение совпадает с текущим хэшем клиента.~~

curl 'https://graph.facebook.com/v25.0/106850078877666/messages' \ -H 'Content-Type: application/json' \ -H 'Authorization: Bearer EAAJB...' \ -d ' { "messaging_product": "whatsapp", "recipient_type": "individual", "to": "+16505551234", "recipient_identity_key_hash": "DF2lS5v2W6x=", "type": "text", "text": { "preview_url": false, "body": "Ваше последнее заявление прикреплено. См.... " } }'

Вебхуки

~~Входящих сообщений веб-хуки с~~ контакты ~~объект, например,~~ ~~веб-хук текстовых сообщенийХэш клиента присваивается~~ identity_key_hash ~~свойство.~~

~~В исходящих сообщениях используются веб-хуки (веб-хуки для сообщений о состоянии), хеш клиента присваивается~~ recipient_identity_key_hash ~~недвижимость в~~ статусы ~~объект.~~

Получить уровень пропускной способности

Используйте WhatsApp Business Phone Number уровень пропускной способности телефонного номера :

ПОЛУЧАТЬ /<WHATSAPP_BUSINESS_PHONE_NUMBER_ID> ?fields=throughput

Получать все телефонные номера

Чтобы получить список всех телефонных номеров, связанных с бизнес-аккаунтом WhatsApp, отправьте GET-запрос по адресу ~~Аккаунт WhatsApp для бизнеса > Номера телефонов~~ ~~конечная точка.~~

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

Синтаксис запроса

curl -X GET "https://graph.facebook.com/<API_VERSION> /<WABA_ID> /phone_numbers?access_token=<ACCESS_TOKEN> "

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

Пример ответа

{ "data": [ { "verified_name": "Jasper's Market", "display_phone_number": "+1 631-555-5555", "id": "1906385232743451", "quality_rating": "GREEN" }, { "verified_name": "Jasper's Ice Cream", "display_phone_number": "+1 631-555-5556", "id": "1913623884432103", "quality_rating": "NA" } ] }

Синтаксис запроса

curl -X GET "https://graph.facebook.com/<API_VERSION> /<WABA_ID> /phone_numbers?access_token=<SYSTEM_USER_ACCESS_TOKEN> ]&sort=['last_onboarded_time_ascending']"

Пример ответа

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

{ "data": [ { "verified_name": "Jasper's Ice Cream", "display_phone_number": "+1 631-555-5556", "id": "1913623884432103", "quality_rating": "NA" }, { "verified_name": "Jasper's Market", "display_phone_number": "+1 631-555-5555", "id": "1906385232743451", "quality_rating": "GREEN" } ] }

Фильтр телефонных номеров

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

Параметры

~~Имя~~	~~Описание~~
`поле`	~~Ценить:~~ `режим_аккаунта`
`оператор`	~~Ценить:~~ `РАВНЫЙ`
`ценить`	~~Ценности:~~ `ПЕСОЧНИЦА`, `ЖИТЬ`

Синтаксис запроса

curl -i -X GET "https://graph.facebook.com/<API_VERSION> /<WABA_ID> /phone_numbers?filtering=[{"field":"account_mode","operator":"EQUAL","value":"SANDBOX"}]&access_token=<ACCESS_TOKEN>

Пример ответа

{ "data": [ { "id": "1972385232742141", "display_phone_number": "+1 631-555-1111", "verified_name": "John's Cake Shop", "quality_rating": "UNKNOWN", } ], "paging": { "cursors": { "before": "abcdefghij", "after": "klmnopqr" } } }

Получите единый номер телефона

Чтобы получить информацию о номере телефона, отправьте GET-запрос на WhatsApp Business Phone Number :

Запрос синтаксис

Получите https://graph.facebook.com/<API_VERSION> /<PHONE_NUMBER_ID>

Пример запроса

curl \ 'https://graph.facebook.com/v15.0/105954558954427/' \ -H 'Авторизация: Bearer EAAFl...'

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

{ "code_verification_status" : "VERIFIED", "display_phone_number" : "15555555555", "id" : "105954558954427", "quality_rating" : "GREEN", "verified_name" : "Support Number" }

Получить статус отображаемого имени (бета-версия)

Чтобы получить статус отображаемого имени, связанного с конкретным номером телефона, добавьте fields=name_status

Образец запрос

curl \ 'https://graph.facebook.com/v15.0/105954558954427?fields=name_status' \ -H 'Авторизация: Bearer EAAFl...'

Пример ответа

{ "id" : "105954558954427", "name_status" : "AVAILABLE_WITHOUT_REVIEW" }

Он name_status ~~Значение может быть одним из следующих:~~

ОДОБРЕННЫЙ~~Название утверждено.~~ДОСТУПНО БЕЗ ОТЗЫВА~~Отображаемое имя готово к использованию без проверки.~~ОТКЛОНЕННЫЙ~~Название не утверждено.~~ИСТЕКШИЙСрок действия сертификата телефонного номера истек, и его нельзя использовать для регистрации телефонного номера для работы с API.ОЖИДАЕТСЯ ПРОВЕРКА~~Ваш запрос на присвоение имени находится на рассмотрении.~~НИКТОНомер телефона не имеет сертификата и не может быть использован для регистрации номера телефона для использования API.

Удаление номеров телефонов компаний

Удалять номера телефонов компаний могут только администраторы портфеля, при этом номера нельзя удалить, если они использовались для отправки платных сообщений в течение последних 30 дней.

Удаление рабочих телефонных номеров через WhatsApp Manager

Если ваш рабочий телефонный номер находится в статусе «Подключен», вам потребуется ввести PIN-код для двухфакторной аутентификации, чтобы удалить номер.

Загрузите свое бизнес-портфолио в WhatsApp Manager .Если панель «Номера телефонов» не загружается автоматически, перейдите в раздел «Инструменты учетной записи » (значок панели инструментов) > «Номера телефонов» .Нажмите на значок корзины рядом с номером телефона и завершите процесс.

Если номер использовался для отправки платных сообщений в течение последних 30 дней, вы будете перенаправлены в «Аналитика» , где будет отображена дата последнего платного сообщения. Вы можете удалить номер через 30 дней после этой даты.

Удаление номеров телефонов компаний через API

Удалить рабочий номер телефона через API невозможно.

Перенос бизнес-телефонных номеров

Вы можете перенести телефонные номера из одной WABA-системы в другую .

Компоненты разговора

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