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

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

Обновлено: 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
Премиум-тариф	Повышенная плата за специальные услуги	Не рекомендуется	Стандарт	Уточните у оператора связи, может ли номер принимать международные SMS-сообщения/звонки, проверьте готовность линии к приему входящих звонков и отключите переадресацию вызовов или функции IVR
Совместные расходы	Стоимость делится между звонящим и получателем	Не рекомендуется	Не рекомендуется	Уточните у оператора связи, может ли номер принимать международные SMS-сообщения/звонки, проверьте готовность линии к приему входящих звонков и отключите переадресацию вызовов или функции IVR
Универсальный доступ	Доступность для обслуживания клиентов по всему миру	Не рекомендуется	Стандарт	Уточните у оператора связи, может ли номер принимать международные SMS-сообщения/звонки, проверьте готовность линии к приему входящих звонков и отключите переадресацию вызовов или функции IVR
Персональный номер	Назначается отдельным лицам, не привязано к устройству	Не рекомендуется	Не рекомендуется	Уточните у оператора связи, может ли номер принимать международные SMS-сообщения/звонки, проверьте готовность линии к приему входящих звонков и отключите переадресацию вызовов или функции IVR
VoIP	Интернет-телефония, не привязанная к физической линии	Не рекомендуется	Стандарт	Убедитесь, что VoIP-провайдер поддерживает международные SMS/звонки с одноразовыми паролями (OTP); проверьте настройки предоставления доступа и учетной записи; убедитесь, что приложение/сервис работает и уведомления включены; убедитесь, что устройство подключено к сети и предоставлены необходимые разрешения
Только въезд	Принимайте только входящие звонки/сообщения	Не рекомендуется	Стандарт	Уточните у оператора связи, может ли номер принимать международные SMS-сообщения/звонки, проверьте готовность линии к приему входящих звонков и отключите переадресацию вызовов или функции IVR
Пейджер	Прикреплен к пейджерам (редко)	Не поддерживается	Не поддерживается	Не поддерживается
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 Manager > Инструменты учетной записи > Номера телефонов .Выберите номер телефона вашей компании.Нажмите «Двухфакторная аутентификация» .Нажмите «Изменить PIN-код» и завершите процедуру.

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

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

Используйте POST / Конечная точка для установки нового 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 отправьте POST- запрос на адрес PHONE_NUMBER_ID/request_code . В запросе укажите выбранный вами метод подтверждения и язык.

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

Параметры

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

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

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

После вызова API вы получите код подтверждения выбранным вами способом. Для завершения процесса подтверждения добавьте свой код в POST- запрос к PHONE_NUMBER_ID/verify_code .

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

Параметры

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

Пример

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

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`	`+16315551234`	Правильное число
`+1 (631) 555-1234`	`+16315551234`	Правильное число
`(631) 555-1234`	`+916315551234`	Возможно, неверный номер
`1 (631) 555-1234`	`+9116315551234`	Возможно, неверный номер

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

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

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

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

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

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

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

Отправьте POST-запрос на конечную точку « Номер телефона WhatsApp Business > Настройки» , чтобы включить или отключить проверку смены личности.

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

Пост тело

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

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

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

curl 'https://graph.facebook.com/v25.0/106850078877666/settings' \ -H '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": "Ваше последнее заявление прикреплено. См.... " } }'

Вебхуки

В вебхуках для входящих сообщений, использующих contacts , например, в вебхуке для текстовых сообщений , хэш клиента присваивается свойству identity_key_hash .

В вебхуках для исходящих сообщений ( вебхуках для сообщений о статусе ) хэш клиента присваивается recipient_identity_key_hash в statuses .

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

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

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

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

Чтобы получить список всех телефонных номеров, связанных с бизнес-аккаунтом WhatsApp, отправьте GET-запрос к WhatsApp Business Account > Phone Numbers .

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

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

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" } ] }

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

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

Параметры

Имя	Описание
`поле`	Значение: `account_mode`
`оператор`	Значение: `РАВНО`
`ценить`	Ценности: `ПЕСОЧНИЦА` , `ЖИЗНЬ`

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

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 может принимать одно из следующих значений:

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

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

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

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

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

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

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

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

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

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

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

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

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