Рабочие телефонные номера | Документация для разработчиков
рабочие телефонные номера
Обновлено: 27 февраля 2026 г
В этом документе описываются бизнес-номера телефонов WhatsApp, требования к ним, информация для управления и уникальные особенности.
Регистрация номеров телефонов компаний
Для использования номера телефона для отправки и получения сообщений через Cloud API необходимо зарегистрировать действующий рабочий номер телефона. Зарегистрированные номера можно использовать для повседневных целей, таких как звонки и текстовые сообщения, но их нельзя использовать с мессенджером WhatsApp («WhatsApp»).
Номера, уже используемые в WhatsApp, нельзя зарегистрировать, если их не удалить . Если ваш номер заблокирован в WhatsApp и вы хотите его зарегистрировать, сначала процедуру обжалования .
Обратите внимание, что после выполнения шагов, описанных в нашем документе «Начало работы» для вас будет автоматически сгенерирован и зарегистрирован тестовый
Требования к участию
К участию допускаются следующие номера телефонов:
Если вы регистрируете номер 1-800, см. раздел «Номера 1-800 и бесплатные номера» для получения дополнительной информации.
Методы регистрации
Примечание: описанные выше методы добавляют номер телефона в ваш бизнес-аккаунт 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 /Отображаемые имена
При регистрации рабочего телефонного номера необходимо указать отображаемое имя. Отображаемое имя отображается в профиле WhatsApp вашего рабочего телефонного номера, а также может отображаться вверху отдельных чатов и списка чатов при соблюдении определенных условий. Подробнее о том, как работают отображаемые имена, см. в нашем документе .
Бизнес-профили
Профиль компании предоставляет дополнительную информацию о вашем бизнесе, такую как адрес, веб-сайт, описание и так далее. Вы можете указать эту информацию при регистрации номера телефона вашей компании. Подробнее о том, как работают профили компаний, читайте в нашем «Профили компаний» .
Официальный статус бизнес-аккаунта
Рабочие телефонные номера могут получить статус официального бизнес-аккаунта (OBA). В списке контактов рядом с названием номера OBA отображается синяя галочка.
Ознакомьтесь с нашим «Официальный бизнес-аккаунт» , чтобы узнать, как запросить статус OBA для бизнес-телефонного номера.
Номера 1-800 и бесплатные номера
Возможно, вам потребуется зарегистрировать на платформе номер 1-800 или другой бесплатный номер. Эти номера обычно находятся за системой интерактивного голосового ответа (IVR). Звонок при регистрации через WhatsApp не может пройти через IVR. Номера телефонов, находящиеся за системой IVR, можно зарегистрировать, но они должны принимать звонки с международных номеров и иметь возможность перенаправлять SMS-сообщения или голосовые вызовы к реальному оператору.
Для регистрации телефонного номера, находящегося за системой интерактивного голосового ответа (IVR):
Номера телефонов, используемые в системе IVR и не способные принимать регистрационные звонки, не поддерживаются.
Ограничение на количество зарегистрированных автомобилей
В новых бизнес-портфелях первоначально допускается не более 2 зарегистрированных корпоративных телефонных номеров.
Если ваша компания пройдет верификацию или если вы достигли лимита в 2000 сообщений, Meta автоматически увеличит ваш лимит до 20. После увеличения будет отправлено уведомление Meta Business Suite, информирующее вас о новом лимите, и будет запущен веб-хук business_capability_update
max_phone_numbers_per_business , установленным на ваш новый лимит.Форматы номеров телефонов пользователей 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. После восстановления доверия повторно отправьте неудачно отправленное сообщение новому получателю (если таковой имеется) без хеша. Затем сохраните новый хеш клиента в веб-хуке статуса доставки сообщения.
Пост тело
{ "user_identity_change" : { "enable_identity_key_check":<ENABLE_IDENTITY_KEY_CHECK> }Набор
значение true , чтобы включить проверку личности, или false, чтобы отключить ее.Пример запроса на включение
Пример включения ответа
{ "success": true }Получить уровень пропускной способности
Используйте WhatsApp Business Phone Number уровень пропускной способности телефонного номера :
ПОЛУЧАТЬ /<WHATSAPP_BUSINESS_PHONE_NUMBER_ID> ?fields=throughputПолучите единый номер телефона
Чтобы получить информацию о номере телефона, отправьте GET-запрос на WhatsApp Business Phone Number :
Получить статус отображаемого имени (бета-версия)
Чтобы получить статус отображаемого имени, связанного с конкретным номером телефона, добавьте
fields=name_status Удаление номеров телефонов компаний
Удалять номера телефонов компаний могут только администраторы портфеля, при этом номера нельзя удалить, если они использовались для отправки платных сообщений в течение последних 30 дней.
Удаление рабочих телефонных номеров через WhatsApp Manager
Если ваш рабочий телефонный номер находится в статусе «Подключен», вам потребуется ввести PIN-код для двухфакторной аутентификации, чтобы удалить номер.
Если номер использовался для отправки платных сообщений в течение последних 30 дней, вы будете перенаправлены в «Аналитика» , где будет отображена дата последнего платного сообщения. Вы можете удалить номер через 30 дней после этой даты.
Удаление номеров телефонов компаний через API
Удалить рабочий номер телефона через API невозможно.
Перенос бизнес-телефонных номеров
Компоненты разговора
Вы можете включить полезные компоненты пользовательского интерфейса сообщений, чтобы упростить взаимодействие пользователей WhatsApp с вашей компанией. См. Компоненты диалога .
Комментарии отсутствуют
Комментарии отсутствуют