WhatsApp Business 平台

管理企業電話號碼

本指南為解決方案合作夥伴和顧客提供與電話號碼相關的總覽資訊。此外，本指南也包含解決方案合作夥伴在必須管理顧客的電話號碼和憑證時，可參考的程序資訊。

有關企業電話號碼的初步資訊

企業須知的部分詳細資料為電話號碼和內嵌註冊。

企業需要一個專屬電話號碼才能透過內嵌註冊使用 WhatsApp。如果企業在 WhatsApp Messenger 或 WhatsApp Business 應用程式中已有註冊使用中的電話號碼，則無法使用同一個電話號碼。

企業可擁有多個與 Meta 商業帳號相關聯的電話號碼，因此他們要做的就是新增另一個電話號碼供 WhatsApp 使用。

若電話號碼已在 WhatsApp Business 或 WhatsApp 消費者應用程式版本中註冊，企業將無法透過該電話號碼使用內嵌註冊流程進行註冊。

如需有關電話號碼和 WhatsApp Business 平台的詳細資訊，請參閱電話號碼。

如需如何移轉現有已註冊 WhatsApp 電話號碼的相關資訊，請參閱移轉電話號碼。

給企業顧客的指示

本節內容針對內嵌註冊的顧客，並提供有關可能執行與電話號碼相關之動作的指引。

在 WhatsApp Business 帳號中新增電話號碼

在 WhatsApp Business 帳號（WABA）中新增額外電話號碼的方法有兩種：

  1. [建議] 再次執行內嵌註冊流程，選擇現有的企業管理平台和 WABA，新增電話號碼並進行驗證。
  2. 在企業管理平台中，前往 WhatsApp 管理工具的電話號碼頁籤，然後選擇新增電話號碼。使用此選項時，解決方案合作夥伴必須手動驗證電話號碼，因為企業管理平台無法進行電話驗證。因此，建議企業遵循內嵌註冊流程來新增其他電話號碼。

給解決方案合作夥伴的指示

本節內容的適用對象為解決方案合作夥伴，旨在提供管理顧客電話號碼和憑證的相關指示。

取得電話號碼

使用 GET /<WABA_ID>/phone_numbers 端點取得企業顧客 WABA 的企業電話號碼清單。

要求

curl 'https://graph.facebook.com/<API_VERSION>/<CUSTOMER_WABA_ID>/phone_numbers' \ -H 'Authorization: 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>" }, "id": "<BUSINESS_PHONE_NUMBER_ID>" } ], "paging": { "cursors": { "before": "<BEFORE_CURSOR>", "after": "<AFTER_CURSOR>" } } }

使用雲端 API 註冊電話號碼

從內嵌註冊流程成功驗證電話後，向 register 端點發出 API 呼叫應可順利註冊。為此，請提供任何 code_method（sms | voice）。由於電話號碼已通過驗證，因此您不需擔心註冊代碼，也不需要進行 verify 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

顯示名稱變更獲得批准後，新顯示名稱的憑證。此欄位僅在顯示名稱變更要求獲得批准時，才會傳回資料，並且在電話號碼註冊新認證之前都可使用。

取得電話的一次性密碼狀態

若要查看電話號碼是否已通過 OTP（單次密碼）驗證，請檢查該號碼的 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-account-ID} 換成電話號碼所屬 WhatsApp Business 帳號的編號。如需範例，請參閱取得所有手機號碼。

依帳號模式篩選電話號碼

您可以查詢電話號碼，並根據其 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"
	}
   }
}

瞭解詳情