Номера телефонов корпоративных клиентов | Документация для разработчиков
Номера телефонов корпоративных клиентов
Обновлено: 27 февраля 2026 г
В этом документе описываются телефонные номера корпоративных клиентов, их требования и конечные устройства, обычно используемые для управления корпоративными телефонными номерами.
Основы
Для использования WhatsApp вашим корпоративным клиентам необходим выделенный номер телефона. Номера телефонов, уже используемые в приложении WhatsApp, не поддерживаются, но номера, используемые в приложении WhatsApp Business, можно зарегистрировать .
Корпоративные клиенты могут привязать к своему аккаунту Meta Business , при желании они могут добавить еще один номер для использования API
При заполнении формы встроенной регистрации ваши бизнес-клиенты должны указать номер телефона и отображаемое имя, которые они хотят видеть в приложении WhatsApp. Мы настоятельно не рекомендуем регистрироваться с использованием тестового или личного номера телефона, а также тестового отображаемого имени, поскольку их сложно изменить.
Инструкции для корпоративных клиентов
Этот раздел предназначен для клиентов Embedded Signup и содержит рекомендации по действиям, которые они могут выполнять в отношении телефонных номеров.
Добавить номера телефонов в бизнес-аккаунт WhatsApp
Существует два способа добавить дополнительные номера в бизнес-аккаунт WhatsApp (WABA):
Инструкции для партнеров по решениям
Этот раздел предназначен для партнеров по решениям и содержит инструкции по управлению телефонными номерами клиентов.
Получение телефонных номеров
Используйте GET /
Запрос
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> " } } }
Зарегистрируйте номера телефонов
После того, как корпоративный клиент успешно завершит процесс встроенной регистрации и его номер телефона будет подтвержден, необходимо зарегистрировать этот номер для использования в облачном API, выполнив вызов
POST / /register с messaging_product и pin . Подробности Шаге 4: Регистрация номера В качестве альтернативы вы можете предварительно проверить номера телефонов и предложить их своим клиентам в новом встроенном процессе регистрации. Это избавит клиентов от необходимости обращаться к вам за одноразовым паролем в процессе регистрации. См. раздел «Предварительно проверенные номера телефонов» .
Номер телефона необходимо зарегистрировать в течение 14 дней после прохождения процедуры встроенной регистрации. Если номер не будет зарегистрирован в течение этого периода, телефон должен пройти процедуру встроенной регистрации повторно перед регистрацией.
Получить метаданные телефона
Конечная
phone_numbers позволяет просмотреть статус отображаемого имени телефонного номера и другие метаданные.Пример запроса
В следующем примере используйте идентификатор назначенного WABA.
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> "
Чтобы найти идентификатор бизнес-аккаунта WhatsApp, перейдите в «Диспетчер бизнеса » > «Настройки бизнеса» > «Аккаунты» > «Бизнес-аккаунты WhatsApp» . Найдите нужный аккаунт и нажмите на него. Откроется панель с информацией об аккаунте, включая его идентификатор.
Пример ответа
{ "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", } ] }
Параметры отклика
| Имя | Описание |
|---|---|
name_status | Статус проверки текущего запроса на отображение имени. Доступные параметры: ОДОБРЕНО : Название утверждено.ОТКЛОНЕНО : Название не утверждено.ИСТЕК СРОК ДЕЙСТВИЯ : Утвержденное название устарело.PENDING_REVIEW : Ваш запрос на имя находится на рассмотрении.NONE : Отображаемое имя не задано. |
новый_имя_статус | Статус рассмотрения запроса на изменение отображаемого имени. Это поле отображает данные только в том случае, если запрос на изменение отображаемого имени был отправлен. |
Получить статус OTP для номера телефона
Чтобы проверить, был ли номер телефона подтвержден с помощью OTP (одноразового пароля), проверьте
code_verification_status . Сначала выполните GET- запрос к / конечная точка:curl -i -X GET \ "https://graph.facebook.com/<API_VERSION> /<WABA_ID> /phone_numbers ?access_token=<ACCESS_TOKEN> "
В ответе указывается значение code_verification_status с одним из следующих параметров:
VERIFIED или NOT_VERIFIED . Пример ответа выглядит следующим образом:[ { "code_verification_status": "NOT_VERIFIED", "id": "1754951608042154" } ]
В качестве альтернативы, вы можете узнать статус, позвонив по номеру телефона, указанному в идентификаторе:
curl -i -X GET \ "https://graph.facebook.com/<API_VERSION> /<PHONE_NUMBER_ID> ?access_token=<ACCESS_TOKEN> "
Для получения идентификатора номера телефона используйте «Аккаунт WhatsApp Business» > «Номер телефона» Подробную информацию об использовании «Получение номеров телефонов»
Фильтрация телефонных номеров по режиму учетной записи
Вы можете запрашивать номера телефонов и фильтровать их по параметру
account_mode . Для запроса можно использовать параметры, перечисленные ниже.Параметры запроса
| Имя | Описание |
|---|---|
поле | Содержит поле, используемое для фильтрации. В этом примере следует использовать account_mode . |
оператор | Указывает, как вы хотите отфильтровать учетные записи. В этом примере следует использовать EQUAL . |
ценить | Укажите, какой режим учетной записи вам нужен. Поддерживаемые значения: ПЕСОЧНИЦА : Учетная запись не подтверждена.В РЕАЛЬНОМ ВРЕМЕНИ : Учетная запись не подходит для неподтвержденной пробной версии или была переведена в подтвержденный статус. |
Пример запроса
В следующем примере используйте идентификатор назначенного WABA.
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" } } }
Комментарии отсутствуют
Комментарии отсутствуют