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

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

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

Обновлено: 14 ноября 2025 г
В этом документе описаны шаги по программной регистрации бизнес-номеров телефонов в бизнес-аккаунтах WhatsApp (WABA).
Обратите внимание, что встроенная регистрация автоматически выполняет шаги 1-3 (если вы не пропускаете экран добавления номера телефона ), поэтому вам нужно выполнить шаг 4 только после того, как корпоративный клиент завершит процесс. Однако, если вы отключили выбор номера телефона, вам необходимо выполнить все 4 шага.
Регистрация бизнес-телефонных номеров — это четырехэтапный процесс:
    Создайте номер в формате WABA.Получите код подтверждения для этого номера.Используйте код для проверки номера.Зарегистрируйте подтвержденный номер для использования API.
    Эти шаги описаны ниже.
    Вы также можете повторить все 4 шага, чтобы зарегистрировать номера телефонов для бизнеса сразу в нескольких местах.

    Ограничения

    Номера телефонов компаний должны соответствовать нашим требованиям к номерам телефонов .

    Шаг 1: Создайте номер телефона

    Отправьте POST-запрос на Аккаунт WhatsApp для бизнеса > Номера телефонов Конечная точка для создания корпоративного телефонного номера в базе данных WABA.

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

    ПОЧТА /<Идентификатор бизнес-аккаунта WhatsApp>/номера телефонов

    Пост тело

    { "cc": "<CC> ", "номер телефона": "<PHONE_NUMBER> ", "verified_name": "<VERIFIED_NAME> " }
    Свойства тела
    
Заполнитель

Описание

Пример значения

    <CC>
    Нить
    Необходимый.

    
Код страны, по которому звонит телефонный номер.
    1
    <PHONE_NUMBER>
    Нить
    Необходимый.

    
Номер телефона, с кодом страны или без него.
    15551234
    <VERIFIED_NAME>
    Нить
    Необходимый.

    
Номер телефона отображаемое имя⁠.
    Счастливый кустарник
    Ответ
    В случае успеха API возвращает идентификатор номера телефона компании. Сохраните этот идентификатор для использования на следующем шаге.
    { "идентификатор": "<ID> " }
    Свойства отклика
    
Заполнитель

Описание

Пример значения

    <ID>
    Непроверенная информация Номер телефона WhatsApp для бизнеса ИДЕНТИФИКАТОР.
    106540352242922
    Пример запроса
    локон 'https://graph.facebook.com/v25.0/102290129340398/phone_numbers' \
-ЧАС 'Content-Type: application/json' \
-ЧАС «Авторизация: Предъявитель EAAH7...» \
-д '{ "cc": "1", "phone_number": "14195551518", "verified_name": "Lucky Shrub" }'
    Пример ответа
    { "id": "110200345501442" }
    Шаг 2: Запросите код подтверждения
    

    Отправьте POST-запрос на  «Запрос кода подтверждения для бизнес-номера телефона WhatsApp» , чтобы получить код подтверждения на бизнес-номер телефона.
    

    

    

    Запрос
синтаксис
    ПОЧТА /<WHATSAPP_BUSINESS_PHONE_NUMBER_ID>/request_code
  ?код_метод=<КОД_МЕТОД>&язык=<ЯЗЫК>
    Параметры строки запроса
    

    

    



Заполнитель 

Описание 

Пример значения 




    

    <CODE_METHOD>
    


    

    Необходимый.
    


    
Указывает способ доставки кода подтверждения на рабочий телефонный номер. Возможны следующие значения: SMS или ГОЛОС.
    


    

    SMS
    



    

    <LANGUAGE>
    


    

    Необходимый.
    


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


    

    en_US
    

    

    

    

    Ответ
    

    

    { "успех":<SUCCESS> }
    

    

    

    

    Свойства отклика
    

    

    



Заполнитель 

Описание 

Пример значения 




    

    <SUCCESS>
    


    

    Логическое значение, указывающее на успех или неудачу.
    


    
В случае успеха API ответит следующим образом: истинный и код подтверждения будет отправлен на рабочий номер телефона способом, указанным в вашем запросе.
    


    

    истинный
    

    

    

    Пример
запрос
    локон -X POST 'https://graph.facebook.com/v25.0/110200345501442/request_code?code_method=SMS&language=en_US' \
-ЧАС «Авторизация: Предъявитель EAAJB...»
    Пример ответа
    { "success": true }
    Пример доставки SMS
    

    Пример SMS-сообщения на английском языке, содержащего код подтверждения и отправленного на рабочий телефонный номер:
    

    

    Код WhatsApp 123-830
    

    

    

    

    Шаг 3: Проверьте номер
    

    Отправьте POST-запрос на  WhatsApp Business Phone Number > Verify Code , чтобы подтвердить номер телефона компании, используя код подтверждения, содержащийся в SMS-сообщении или голосовом сообщении, доставленном на номер.
    

    

    

    Запрос
синтаксис
    ПОЧТА /<WHATSAPP_BUSINESS_PHONE_NUMBER_ID>/verify_code
  ?код=<КОД>
    Параметры строки запроса
    

    

    



Заполнитель 

Описание 

Пример значения 




    

    <CODE>
    

    Нить
    


    

    Необходимый.
    


    
Код подтверждения без дефиса.
    


    

    123830
    

    

    

    

    Ответ
    

    

    { "успех":<SUCCESS> }
    

    

    

    

    Свойства отклика
    

    

    



Заполнитель 

Описание 

Пример значения 




    

    <SUCCESS>
    


    

    Логическое значение, указывающее на успех или неудачу.
    


    
В случае успеха API ответит следующим образом: истинный, что указывает на проверку номера телефона компании.
    


    

    истинный
    Пример запроса
    локон -X POST 'https://graph.facebook.com/v25.0/110200345501442/verify_code?code=123830' \
-ЧАС «Авторизация: Предъявитель EAAJB...»
    Пример ответа
    { "success": true }
    Шаг 4: Зарегистрируйте номер
    Отправьте POST-запрос на Номер телефона WhatsApp для бизнеса > Регистрация Конечная точка для регистрации номера телефона компании для использования с API.
    Синтаксис запроса
    ПОЧТА /<Идентификатор номера бизнес-телефона>/регистрация
    Пост тело
    { "messaging_product": "whatsapp", "pin": "<PIN> " }
    Свойства тела
    
Заполнитель

Описание

Пример значения

    <PIN>
    Нить
    Необходимый.

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

    
Если для подтвержденного номера телефона компании не включена двухфакторная аутентификация, установите это значение на 6-значное число. Это будет PIN-код двухфакторной аутентификации номера телефона компании.
    123456
    Ответ
    В случае успеха API ответит следующим образом: истинный, что означает успешную регистрацию.
    { "успех":<SUCCESS> }
    Свойства отклика
    
Заполнитель

Описание

Пример значения

    <SUCCESS>
    Логическое значение, указывающее на успех или неудачу.

    
В случае успеха API ответит следующим образом: истинный, что означает успешную регистрацию.
    истинный
    Пример запроса
    локон 'https://graph.facebook.com/v25.0/110200345501442/register' \
-ЧАС 'Content-Type: application/json' \
-ЧАС «Авторизация: Предъявитель EAAJB...» \
-д ' { "messaging_product": "whatsapp", "pin": "123456" }'
    Пример ответа
    { "success": true }
    
    
            
    
    
    

            
    
        
    
    
    

    
    

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