WhatsApp Business Platform > On-Premises API > Reference

帳號

/v1/account

account 節點用於註冊 WhatsApp Business API 用戶端。

請注意，如果在已註冊號碼的叢集上註冊新號碼，核心應用程式將重新啟動。

關係連線

下列關係連線連結到此節點：

關係連線	說明
`/verify`	透過指定的方法收到註冊代碼後，請使用此關係連線完成帳號註冊。

準備工作

必備項目：

可登入服務的驗證權杖
與 WhatsApp Business 帳號相關聯的有效電話號碼
與該電話號碼相關聯的 WhatsApp 核准顯示名稱

複製 Base64 編碼憑證

此時將產生 Base64 編碼憑證字串，並在 WhatsApp Business API 用戶端註冊期間用於驗證。

在 Meta 企業管理平台中前往商業設定。
點擊帳號功能表下的 WhatsApp 帳號，從 WhatsApp 帳號清單中選擇您的 WhatsApp 帳號（如果尚未反白顯示的話）。
前往設定頁籤，並點擊「WhatsApp 管理工具」按鈕。
在電話號碼頁籤下，您應該會看到您的電話號碼。在您想要獲取憑證的電話號碼上點擊「查看」按鈕。
取得憑證
彈出對話方塊將在灰色方塊中顯示憑證字串。點擊取得憑證。
下載憑證字串
透過 account 端點註冊時，在 cert 參數中使用此憑證字串。

如需詳細資訊，請參閱顯示名稱文件。

限制

您必須使用 admin 帳號註冊應用程式。
如果您準備重新註冊帳號，註冊完成後需要重新啟動 Coreapp。

要求

向此端點發出 POST 呼叫，要求註冊代碼。在呼叫中，加入您的電話號碼和 base64 編碼憑證字串。您可以透過簡訊或語音通話接收代碼。

範例

POST /v1/account

{
    "cc": "COUNTRY_CODE",
    "phone_number": "PHONE_NUMBER_WITHOUT_COUNTRY_CODE",
    "method": "sms" or "voice",
    "cert": "VERIFIED_NAME_CERT_IN_BASE64",
    "pin": "EXISTING_6_DIGIT_PIN" # required if two-step verification is enabled
}

依據所收到的回應，您可以評估註冊程序是否已完成，或需要其他步驟才能完成。如果成功，您會收到下列其中一個 HTTP 狀態代碼。請視您收到的回應參閱相關說明：

201 Created - 帳號已存在。您已註冊過，因此不需執行任何步驟。
202 Accepted - 帳號不存在。根據您在申請中選擇的方法，查看您的簡訊或語音通話，取得註冊代碼。此回應將包括傳回的裝載，其中包含從 cert 參數解碼的 vname，以便您確認正在設定的顯示名稱正確無誤。如果正確，請繼續進行完成帳號註冊部分，以完成註冊。

{
  "account": [{
      "vname": "decoded-vname-from-cert"
  }]
}

如果傳回任何錯誤，請參閱錯誤和狀態訊息，瞭解更多資訊。

參數

名稱	說明
`cc`	必填。您正在註冊的電話號碼的數字國碼／區碼
`phone_number`	必填。您正在註冊的電話號碼，不含國碼／區碼或加號（`+`）。
`method`	必填。接收註冊代碼的方法選項：`voice`、`sms`
`cert`	必填。 Base64 編碼憑證。
`pin`	選填。現有的 6 位數 PIN 碼：只有當此帳號啟用雙因素驗證時才需要。