管理电话号码和证书

本指南简要介绍了解决方案合作伙伴电话号码和客户电话号码。此外，本指南还介绍了在解决方案合作伙伴需要管理客户的电话号码和证书时，他们需要采取的流程。

电话号码的初步信息

企业需要了解电话号码和嵌入式注册的一些基本信息。

企业需要借助专用号码通过嵌入式注册使用 WhatsApp。如果企业在 WhatsApp Messenger 或 WhatsApp Business 应用上主动注册了一个电话号码，则将无法使用相同的号码。

企业可以将多个电话号码与他们的 Meta 业务帐户相关联，因此他们只需添加另一个电话号码并将其用于 WhatsApp 即可。

嵌入式注册流程不支持企业使用已在 WhatsApp 应用程序的 Business 或消费者版中注册过的电话号码进行注册。

如需详细了解电话号码以及 WhatsApp Business 开放平台的相关信息，请参阅电话号码。

如需了解如何迁移已注册 WhatsApp 的现有电话号码，请参阅迁移电话号码。

客户指导

此部分面向嵌入式注册的客户，会为客户提供指导，介绍与电话号码相关的操作。

将电话号码添加到 WhatsApp Business 商业帐号

您可通过以下 2 种方法为 WhatsApp Business 商业帐号 (WABA) 添加其他电话号码：

[推荐] 再次执行嵌入式注册流程，选择现有商务管理平台和 WABA，添加相应号码，然后进行认证。
在商务管理平台中，转到 WhatsApp 管理工具的电话号码选项卡，然后选择添加电话号码。使用此选项时，解决方案合作伙伴需要手动认证电话号码，因为商务管理平台不支持电话号码认证。因此，我们建议企业按照嵌入式注册流程添加其他电话号码。

解决方案合作伙伴指导

此部分面向解决方案合作伙伴，提供客户电话号码和证书管理方面的指导。

注册用于云端 API 的电话号码

通过嵌入式注册流程成功认证电话号码后，向 register 端点发出 API 调用即可完成注册。为此，请提供任意一种 code_method (sms | voice)。由于电话号码已完成认证，您无需担心注册码。您无需执行 verify API 调用。

或者，您可以预先认证电话号码，然后在新嵌入式注册流程中向您的客户提供此号码。这样客户就不必在登录过程中联系您获取一次性密码。请参阅已预先认证的电话号码。

注册用于本地 API 的电话号码

通过嵌入式注册流程成功认证电话号码后，向 account 端点发出 API 调用即可完成注册。为此，请提供任意一种 code_method (sms | voice)。由于电话号码已完成认证，您无需担心注册码。您无需执行 verify API 调用。

必须在完成嵌入式注册流程后的 14 天内注册电话号码。如果未在该窗口期内注册号码，则必须再次完成嵌入式注册流程后，才能重新注册。

获取电话号码的状态和证书

您可以通过 phone_numbers 端点查看电话号码显示名的状态，并在名称更改后检索相应证书。如需了解详情，请参阅读取电话号码。

请求示例

在以下示例中，使用指定的 WABA 的编号。

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}"

如要获取 WhatsApp Business 商业帐号的编号，请前往商务管理平台 > 商业设置 > 帐号 > WhatsApp Business 商业帐号。找到您要使用的帐号，然后点击该帐号。系统随后将开启一个窗口，其中包含该帐号的编号等相关信息。

响应示例

{
  "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",
    }
  ]
}

响应参数

名称	描述
`name_status`	当前显示名请求的审核状态。点击左边栏中的箭头以了解可用选项。
可用选项	`APPROVED`：名称已获批准。您现在可以下载证书。 `DECLINED`：名称尚未获得批准。您不能下载证书。 `EXPIRED`：您的证书已过期，不可再下载。 `PENDING_REVIEW`：您的显示名请求正在审核中。您不能下载证书。 `NONE`：没有可用证书。
`new_name_status`	显示名更改请求的审核状态。仅当发出显示名更改请求后，此字段才会返回数据。
`certificate`	返回此电话号码当前的证书。
`new_certificate`	显示名更改获得批准后的新显示名证书。仅当显示名更改请求获得批准后，此字段才会返回数据，并会在使用新证书注册电话号码后失效。

获取电话号码的一次性密码状态

如要查看是否是通过一次性密码认证电话号码，请查看该号码的 code_verification_status 字段。首先，向 /{whatsapp-business-account-id}/phone_numbers 端点发出 GET 调用：

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"
  }
]

此外，您也可以通过调用电话号码编号获取一次性密码状态：

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

如要获取电话号码编号，请调用 https://graph.facebook.com/v21.0/{whatsapp-business-account-ID}/phone_numbers。请使用电话号码关联的 WhatsApp Business 商业帐号的编号替换 {whatsapp-business-account-ID}。如需获取示例，请参阅获取所有电话号码。

按帐号模式筛选电话号码

您可以查询电话号码，并按 account_mode 对电话号码进行筛选。此类请求可以使用下方所列的参数。

请求参数

名称	描述
`field`	包含要用于筛选的字段。在本例中，您应使用 `account_mode`。
`operator`	包含您想要筛选帐号的方式。在本例中，您应使用 `EQUAL`。
`value`	包含您寻找的帐号模式。点击左边栏中的箭头以获取支持的值。
支持的值	`SANDBOX`：帐号未认证。 `LIVE`：帐号不符合未认证试用体验的资格，或已升级为已认证帐号。

请求示例

在以下示例中，使用指定的 WABA 的编号。

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"
	}
   }
}