WhatsApp Business Platform > On-Premises API > Reference

帳戶

/v1/account

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

請注意，如果叢集上已有註冊號碼，則再註冊新號碼時，Coreapp 將會重新啟動。

關係連線

以下關係連線連接至此節點：

關係連線	描述
`/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，僅在此帳戶啟用雙重認證時需要使用。