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

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

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

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

    Ограничения

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

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

    Отправьте POST-запрос на WhatsApp Business Account > Phone Numbers , чтобы создать рабочий номер телефона в WABA.

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

    POST /< WHATSAPP_BUSINESS_ACCOUNT_ID >/ phone_numbers

    Пост тело

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

Описание

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

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

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

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

Описание

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

    <ID>
    106540352242922
    Пример запроса
    curl 'https://graph.facebook.com/ v25.0 /102290129340398/phone_numbers' \ - H 'Content-Type: application/json' \ - H 'Authorization: Bearer EAAH7...' \ - d '{ "cc": "1", "phone_number": "14195551518", "verified_name": "Lucky Shrub" }'
    Пример ответа
    { "id": "110200345501442" }
    Шаг 2: Запросите код подтверждения
    Отправьте POST-запрос на  «Запрос кода подтверждения для бизнес-номера телефона WhatsApp» , чтобы получить код подтверждения на бизнес-номер телефона.
    Синтаксис запроса
    POST /< WHATSAPP_BUSINESS_PHONE_NUMBER_ID >/ request_code ? code_method =< CODE_METHOD > & language =< LANGUAGE >
    Параметры строки запроса
    
Заполнитель

Описание

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

    <CODE_METHOD>
    Необходимый.

    Указывает способ доставки кода подтверждения на рабочий телефонный номер. Возможны варианты SMS или VOICE .
    SMS
    <LANGUAGE>
    Необходимый.

    
Указывает язык, использованный в предоставленном проверочном коде.
    en_US
    Ответ
    { "успех":<SUCCESS> }
    Свойства отклика
    
Заполнитель

Описание

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

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

    В случае успеха API ответит значением true , и на номер телефона компании будет отправлен проверочный код, используя метод, указанный в вашем запросе.
    истинный
    Пример запроса
    curl - X POST 'https://graph.facebook.com/ v25.0 /110200345501442/request_code?code_method=SMS&language=en_US' \ - H 'Авторизация: Bearer EAAJB...'
    Пример ответа
    { "success": true }
    Пример доставки SMS
    Пример SMS-сообщения на английском языке, содержащего код подтверждения и отправленного на рабочий телефонный номер:
    Код WhatsApp 123-830
    Шаг 3: Проверьте номер
    Отправьте POST-запрос на  WhatsApp Business Phone Number > Verify Code , чтобы подтвердить номер телефона компании, используя код подтверждения, содержащийся в SMS-сообщении или голосовом сообщении, доставленном на номер.
    Синтаксис запроса
    POST /< WHATSAPP_BUSINESS_PHONE_NUMBER_ID >/ verify_code ? code =< CODE >
    Параметры строки запроса
    
Заполнитель

Описание

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

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

    
Код подтверждения без дефиса.
    123830
    Ответ
    { "успех":<SUCCESS> }
    Свойства отклика
    
Заполнитель

Описание

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

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

    В случае успеха API ответит значением true , указывая на то, что номер телефона компании был проверен.
    истинный
    Пример запроса
    curl - X POST 'https://graph.facebook.com/ v25.0 /110200345501442/verify_code?code=123830' \ - H 'Авторизация: Bearer EAAJB...'
    Пример ответа
    { "success": true }
    Шаг 4: Зарегистрируйте номер
    Отправьте POST-запрос на  WhatsApp Business Phone Number > Register , чтобы зарегистрировать номер телефона компании для использования с API.
    Синтаксис запроса
    POST / <BUSINESS_PHONE_NUMBER_ID> / register
    Пост тело
    { "messaging_product": "whatsapp", "pin": "<PIN> " }
    Свойства тела
    
Заполнитель

Описание

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

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

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

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

Описание

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

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

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

            
    
        
    
    
    

    
    

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