Номера телефонов корпоративных клиентов | Документация для разработчиков
Номера телефонов корпоративных клиентов
Обновлено: 27 февраля 2026 г
В этом документе описываются телефонные номера корпоративных клиентов, их требования и конечные устройства, обычно используемые для управления корпоративными телефонными номерами.
Основы
Для использования WhatsApp вашим корпоративным клиентам необходим выделенный номер телефона. Номера телефонов, уже используемые в приложении WhatsApp, не поддерживаются, но номера, используемые в приложении WhatsApp Business, можно зарегистрировать.
Корпоративные клиенты могут иметь несколько телефонных номеров, связанных с их учетной записью Бизнес-аккаунт Meta?, чтобы они могли добавить еще один номер для использования API если они того пожелают.
При заполнении формы встроенной регистрации ваши бизнес-клиенты должны указать номер телефона и отображаемое имя, которые они хотят видеть в приложении WhatsApp. Мы настоятельно не рекомендуем регистрироваться с использованием тестового или личного номера телефона, а также тестового отображаемого имени, поскольку их сложно изменить.
Инструкции для корпоративных клиентов
Этот раздел предназначен для клиентов Embedded Signup и содержит рекомендации по действиям, которые они могут выполнять в отношении телефонных номеров.
Добавить номера телефонов в бизнес-аккаунт WhatsApp
Существует два способа добавить дополнительные номера в бизнес-аккаунт WhatsApp (WABA):
Инструкции
для партнеров по решениям
Получение телефонных номеров
Запрос
curl 'https://graph.facebook.com/<API_VERSION> /<CUSTOMER_WABA_ID> /phone_numbers' \ -H 'Авторизация: Bearer'<CUSTOMER_BUSINESS_TOKEN> '
Ответ
{ "data": [ { "verified_name": "<VERIFIED_DISPLAY_NAME> ", "code_verification_status": "<VERIFICATION_STATUS> ", "display_phone_number": "<DISPLAY_PHONE_NUMBER> ", "quality_rating": "<QUALITY_RATING> ", "platform_type": "CLOUD_API", "throughput": { "level": "<THROUGHPUT_LEVEL> " }, "webhook_configuration": { "application": "<WEBHOOK_CALLBACK_URL> " }, "идентификатор": "<BUSINESS_PHONE_NUMBER_ID> " } ], "пагинация": { "курсоры": { "перед": "<BEFORE_CURSOR> ", "после": "<AFTER_CURSOR> " } } }
Зарегистрируйте номера телефонов
ПОЧТА /<PHONE_NUMBER_ID> /registermessaging_productприколотьПолучить метаданные телефона
номера телефоновПример запроса
curl -i -X GET "https://graph.facebook.com/<API_VERSION> /<WABA_ID> /phone_numbers ?fields= display_phone_number, name_status, new_name_status &access_token=<SYSTEM_USER_ACCESS_TOKEN> "
Пример ответа
{ "data": [ { "id": "1972385232742141", "display_phone_number": "+1 631-555-1111", "last_onboarded_time": "2023-08-22T19:05:53+0000", "name_status": "APPROVED", "new_name_status": "APPROVED", } ] }
Параметры отклика
| |
|
Получить статус OTP для номера телефона
статус_проверки_кодаПОЛУЧАТЬ/curl -i -X GET \ "https://graph.facebook.com/<API_VERSION> /<WABA_ID> /phone_numbers ?access_token=<ACCESS_TOKEN> "
ПРОВЕРЕНОНЕ ПРОВЕРЕНО[ { "code_verification_status": "NOT_VERIFIED", "id": "1754951608042154" } ]
curl -i -X GET \ "https://graph.facebook.com/<API_VERSION> /<PHONE_NUMBER_ID> ?access_token=<ACCESS_TOKEN> "
Фильтрация телефонных номеров по режиму учетной записи
режим_аккаунтаПараметры запроса
| |
| |
| |
Пример запроса
curl -i -X GET "https://graph.facebook.com/<API_VERSION> /<WABA_ID> /phone_numbers ?filtering=[{ "field":"account_mode", "operator":"EQUAL", "value":"SANDBOX"}] &access_token=<SYSTEM_USER_ACCESS_TOKEN> "
Пример ответа
{ "data": [ { "id": "1972385232742141", "display_phone_number": "+1 631-555-1111", "verified_name": "John's Cake Shop", "quality_rating": "UNKNOWN", } ], "paging": { "cursors": { "before": "abcdefghij" "after": "klmnopqr" } } }