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

Зарегистрируйте номер телефона для бизнеса

Обновлено: 31 марта 2026 г

Для использования вашего рабочего телефонного номера с Cloud API необходимо его зарегистрировать. Регистрация возможна только через API — вы не можете зарегистрировать номер через WhatsApp Manager WAM ) или панель управления приложения.

Чтобы подготовить свой номер для использования Cloud API, выполните следующие шаги:

Добавьте свой рабочий номер телефона в свой аккаунт WhatsApp Business с помощью WhatsApp Manager .Подтвердите принадлежность номера с помощью WhatsApp Manager .Зарегистрируйте номер телефона вашей компании, выполнив вызов API к точке регистрации .

Зарегистрируйте номер телефона вашей компании в следующих случаях:

Создание учетной записи — При использовании этого API зарегистрируйте номер телефона компании, который вы хотите использовать. Meta обеспечивает двухфакторную аутентификацию при создании учетной записи, что добавляет дополнительный уровень безопасности вашим аккаунтам.Изменение имени — Если ваш телефон уже зарегистрирован и вы хотите изменить его отображаемое имя, вы можете сделать это через WhatsApp Manager или через API . После того, как изменение имени будет одобрено (подтверждено phone_number_name_update ), повторно зарегистрируйте свой номер телефона, используя указанную ниже конечную точку. Дождитесь подтверждения перед повторной регистрацией, так как повторная регистрация до подтверждения не возымеет эффекта. Полный алгоритм действий см. в разделе « Отображаемые имена» .

Исключение при миграции

Если вы переносите номер телефона из локального API в облачный API, перед регистрацией номера телефона в облачном API необходимо выполнить дополнительные шаги. Полный процесс описан «Перенос из локального API в облачный API»

Зарегистрируйте номер телефона для бизнеса

Для регистрации подтвержденного номера телефона вашей компании, отправьте POST- запрос на адрес PHONE_NUMBER_ID/register . Включите в запрос параметры, указанные ниже.

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

Ограничения

Количество запросов к точке регистрации ограничено 10 запросами на один бизнес-номер в течение 72-часового переходного периода.

При отправке запроса на регистрацию API проверяет, сколько запросов на регистрацию этого номера вы уже отправили за последние 72 часа. Если вы уже отправили 10 запросов, API вернет код ошибки 133016 , и регистрация номера будет заблокирована на следующие 72 часа.

Параметры

Имя	Описание
`messaging_product`	Необходимый. Используемая служба обмена сообщениями. Установите ее на `«WhatsApp»` .
`приколоть`	Необходимый. Если для вашего подтвержденного рабочего номера телефона уже включена двухфакторная аутентификация, установите это значение равным 6-значному PIN-коду вашей двухфакторной аутентификации. Если вы не помните свой PIN-код, вы можете его изменить. См. раздел « Двухфакторная аутентификация» . Если для вашего подтвержденного корпоративного номера телефона не включена двухфакторная аутентификация, установите это значение на 6-значный номер. Это будет PIN-код двухфакторной аутентификации для нового подтвержденного корпоративного номера телефона.
`data_localization_region`	Необязательный. Если указано, включает локальное хранилище на рабочем телефонном номере. Значение должно представлять собой двухбуквенный код страны ISO 3166 (например, `IN` ), указывающий страну, в которой вы хотите хранить данные в состоянии покоя. Поддерживаемые значения: Азиатско-Тихоокеанский регион Австралия: `AU`Индонезия: `ID`Индия: `ИН`Япония: `JP`Сингапур: `SG`Южная Корея: `KR` Европа ЕС (Германия): `DE`Швейцария: `CH`Соединенное Королевство: `GB` ЛАТАМ Бразилия: `BR` МЭА Бахрейн: `БХ`Южная Африка: `ZA`Объединенные Арабские Эмираты: `AE` НОРАМ Канада: `CA` После включения локального хранилища его нельзя отключить или изменить напрямую. Вместо этого необходимо отменить регистрацию номера и зарегистрировать его заново без этого параметра (для отключения) или добавить параметр с новым кодом страны (для изменения). Если номер уже зарегистрирован, отмените его регистрацию, а затем зарегистрируйте его снова с этим параметром, чтобы включить локальное хранилище.

Пример запроса без использования локального хранилища

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

Отмена регистрации корпоративного телефонного номера делает его непригодным для использования с Cloud API и отключает локальное хранилище номера, если оно было включено. Для повторного использования номера необходимо его зарегистрировать заново.

Для снятия с регистрации корпоративного телефонного номера выполните POST- запрос к PHONE_NUMBER_ID/deregister :

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

Ограничения

Данная конечная точка не может быть использована для отмены регистрации корпоративного телефонного номера, который используется одновременно с Cloud API и приложением WhatsApp Business .Отмена регистрации не удаляет номер телефона и историю его сообщений. Чтобы удалить номер телефона и его историю, см. раздел «Удаление номера телефона из WABA» .Количество запросов к точке отмены регистрации ограничено 10 запросами на один номер телефона компании в течение 72-часового скользящего окна. Если вы превысите это количество, API вернет код ошибки 133016 , и отмена регистрации номера телефона компании будет заблокирована на следующие 72 часа.

См. также

Сброс PIN-кодаЛокальное хранилище через Cloud API