Перейти к основному содержимому

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

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

Обновлено: 31 марта 2026 г
Для использования вашего корпоративного телефонного номера с Cloud API необходимо его зарегистрировать. Регистрация возможна только через API —- Вы не можете зарегистрировать номер через Менеджер WhatsApp⁠? (WAM) или панель управления приложения.
Чтобы подготовить свой номер для использования Cloud API, выполните следующие шаги:
    Добавьте свой рабочий номер телефона в свой аккаунт WhatsApp Business с помощью WhatsApp Manager .Подтвердите принадлежность номера с помощью WhatsApp Manager .Зарегистрируйте номер телефона вашей компании, выполнив вызов API к точке регистрации .
    Зарегистрируйте номер телефона вашей компании в следующих случаях:
      Создание учетной записи —- При использовании этого API зарегистрируйте номер телефона компании, который вы хотите использовать. Meta обеспечивает двухфакторную аутентификацию при создании учетной записи, что добавляет дополнительный уровень безопасности вашим аккаунтам.Смена имени —- Если ваш телефон уже зарегистрирован и вы хотите изменить его отображаемое имя, вы можете сделать это через Менеджер WhatsApp⁠? или через APIПосле утверждения изменения имени (подтверждения через систему) номер_имя_телефона_обновление Для повторной регистрации номера телефона, используя указанную ниже конечную точку, дождитесь подтверждения, так как повторная регистрация до подтверждения не возымеет эффекта. См Отображаемые имена для полного описания рабочего процесса.

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

      Если вы переносите номер телефона из локального 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» .
      приколоть
      Необходимый.
      Если для вашего подтвержденного рабочего номера телефона уже включена двухфакторная аутентификация, установите это значение равным вашему число'число's 6-значный PIN-код для двухфакторной аутентификации. Если вы не помните свой PIN-код, вы можете его изменить. См Двухэтапная проверка.
      Если для вашего подтвержденного рабочего номера телефона не включена двухфакторная аутентификация, установите это значение на 6-значный номер. Это будет новый подтвержденный рабочий номер телефона число'число'двухфакторная аутентификация с помощью PIN-кода.
      data_localization_region
      Необязательный.

      Если включено, позволяет локальное хранилище в рабочем телефонном номере. Значение должно представлять собой двухбуквенный код страны ISO 3166 (например, В) с указанием страны, в которой вы хотите хранить данные в состоянии покоя.

      Поддерживаемые значения:

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

                Если номер уже зарегистрирован, отмените его регистрацию, а затем зарегистрируйте его снова с этим параметром, чтобы включить локальное хранилище.

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

                локон
                'https://graph.facebook.com/v25.0/106540352242922/register
                '
                \
                -ЧАС 'Content-Type: application/json' \ -ЧАС «Авторизация: Предъявитель EAAJB...» \ -д ' { "messaging_product": "whatsapp", "pin": "212834" }

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

                локон 'https://graph.facebook.com/v25.0/106540352242922/register ' \
-ЧАС 'Content-Type: application/json' \
-ЧАС «Авторизация: Предъявитель EAAJB...» \
-д ' { "messaging_product": "whatsapp", "pin": "212834", "data_localization_region": "CH" }
                Для всех вызовов API требуется аутентификация с использованием токенов доступа.
                Разработчики могут аутентифицировать свои вызовы API с помощью токена доступа, сгенерированного в Панель управления приложения > WhatsApp > Настройка API.
                Партнеры по решениям должны пройти аутентификацию с помощью токена доступа whatsapp_business_messaging и whatsapp_business_management разрешения. См Токены доступа пользователей системы для информации.

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

                Отмена регистрации корпоративного телефонного номера делает его непригодным для использования с Cloud API и отключает локальное хранилище номера, если оно было включено. Для повторного использования номера необходимо его зарегистрировать заново.
                Для снятия с регистрации корпоративного телефонного номера выполните POST- запрос к PHONE_NUMBER_ID/deregister :
                Конечная точка Аутентификация
                Партнеры по решениям должны пройти аутентификацию с помощью токена доступа, имеющего whatsapp_business_management и whatsapp_business_messaging .

                Ограничения

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

                  Пример

                  Образец Запрос:
                  локон -X POST \
 'https://graph.facebook.com/v25.0/FROM_PHONE_NUMBER_ID/deregister' \
 -ЧАС 'Авторизация: Bearer ACCESS_TOKEN'
                  Успешный ответ выглядит следующим образом:
                  {
                  "успех": истинный
                  }
                  См. также
                  

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

            
                    
        
                    
    
                    

    
                    

    
    
                    
        
                    
             Вернуться наверх