Управление номерами телефонов и сертификатами

В этом руководстве приведена общая информация, связанная с номерами телефонов для партнеров по решениям и клиентов. Кроме того, в нем содержатся сведения о соответствующих процедурах для партнеров по решениям в ситуациях, когда они отвечают за управление номером телефона и сертификатами компании-клиента.

Предварительная информация о номерах телефонов

Ниже приводится полезная для компаний информация о номерах телефонов в контексте регистрации на сайте поставщика.

Для регистрации на сайте поставщика с использованием WhatsApp компании необходим специальный номер телефона. Номер, уже зарегистрированный в приложении WhatsApp для обмена сообщениями или в приложении WhatsApp Business, использовать нельзя.

У компании может быть несколько номеров, связанных с бизнес-аккаунтом Meta, поэтому достаточно будет просто добавить номер телефона специально для WhatsApp.

Дополнительную информацию о номерах телефонов и платформе WhatsApp Business см. в этой статье.

Сведения о том, как перенести существующий зарегистрированный номер телефона WhatsApp, можно найти в этом разделе.

Инструкции для клиентов

Этот раздел предназначен для клиентов регистрации на сайте поставщика и содержит инструкции в отношении номеров телефонов.

Добавление номеров телефона в аккаунт WhatsApp Business

Добавить номер телефона в аккаунт WhatsApp Business (WABA) можно двумя способами:

1. Рекомендуемый вариант. Ещё раз пройдите регистрацию на сайте поставщика, выберите существующий аккаунт Business Manager и WhatsApp Business, добавьте и подтвердите номер.
2. В Business Manager перейдите в раздел WhatsApp Manager, откройте вкладку Номера телефонов и выберите Добавить номер телефона. Если вы используете эту функцию, партнеру по решениям потребуется вручную подтвердить номер телефона, так как в Business Manager эта процедура недоступна. По этой причине компаниям рекомендуется добавлять дополнительные номера посредством регистрации на сайте поставщика.

Инструкции для партнеров по решениям

В этом разделе содержатся инструкции по управлению номерами телефонов и сертификатами клиентов для партнеров по решениям.

Регистрация номеров телефонов для облачного API

После подтверждения телефона в процессе регистрации на сайте поставщика нужно выполнить вызов API к конечной точке register. Для этого укажите любое значение code_method (sms | voice). Поскольку номер телефона уже подтвержден, код регистрации не понадобится. Вызов API verify не требуется.

Можно также предварительно подтвердить номера телефонов и предложить их клиентам в процессе регистрации на сайте поставщика. Так клиентам не придется обращаться к вам за одноразовым паролем при регистрации. См. статью о предварительно подтвержденных номерах телефонов.

Регистрация номеров телефонов для локального API

После подтверждения телефона в процессе регистрации на сайте поставщика нужно выполнить вызов API к конечной точке account. Для этого укажите любое значение code_method (sms | voice). Поскольку номер телефона уже подтвержден, код регистрации не понадобится. Вызов API verify не требуется.

Можно также предварительно подтвердить номера телефонов и предложить их клиентам в процессе регистрации на сайте поставщика. Так клиентам не придется обращаться к вам за одноразовым паролем при регистрации. См. статью о предварительно подтвержденных номерах телефонов.

Получение статуса и сертификата номера телефона

С помощью конечной точки phone_numbers вы можете проверить статус отображаемого имени номера телефона и получить сертификат после изменения этого имени. Дополнительные сведения см. в статье Получение номеров телефонов.

Пример запроса

В следующем примере используйте ID назначенного аккаунта WhatsApp Business.

curl -i -X GET "https://graph.facebook.com/v21.0/{waba-id}/phone_numbers
  ?fields=
    display_phone_number,
    certificate,
    name_status,
    new_certificate,
    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",
      "certificate": "AbCdEfGhIjKlMnOpQrStUvWxYz",
      "new_certificate": "123AbCdEfGhIjKlMnOpQrStUvWxYz",
      "name_status": "APPROVED",
      "new_name_status": "APPROVED",
    }
  ]
}

Параметры ответа

Получение статуса одноразового пароля телефона

Чтобы проверить, был ли номер телефона подтвержден с помощью одноразового пароля, проверьте для этого номера поле code_verification_status. Сначала выполните вызов GET к конечной точке /{whatsapp-business-account-id}/phone_numbers:

curl -i -X GET \ 
"https://graph.facebook.com/v21.0/{waba-id}/phone_numbers
  ?access_token={your-access-token}"

Ответ будет содержать поле code_verification_status с одним из следующих значений: VERIFIED или NOT_VERIFIED. Ответ выглядит примерно так:

[
  {
    "code_verification_status": "NOT_VERIFIED",
    "id": "1754951608042154"
  }
]

Статус одноразового пароля также можно получить по ID номера телефона:

curl -i -X GET \ 
"https://graph.facebook.com/v21.0/{phone-number-id}
  ?access_token={your-access-token}"

Фильтрация номеров телефонов по режиму аккаунта

Вы можете запросить номера телефонов и отфильтровать их по признаку account_mode. Для этого запроса используются перечисленные ниже параметры.

Параметры запроса

Пример запроса

В следующем примере используйте ID назначенного аккаунта WhatsApp Business.

curl -i -X GET "https://graph.facebook.com/v21.0/{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"
	}
   }
}

Дополнительная информация

• Номера телефонов: обзор платформы WhatsApp Business
• Номера телефонов: перенос существующего зарегистрированного номера
• Справка: аккаунт WhatsApp Business