開始使用

本文件說明將內嵌註冊流程整合至網站或用戶端入口網站所需完成的步驟和必備條件。

準備工作

若要開始整合內嵌註冊流程,您必須先設定企業管理平台和 Meta 應用程式。

企業管理平台

您需要企業管理平台帳號來管理您的帳號額度和已加入之顧客的 WhatsApp Business 帳號(WABA)。如需有關建立商業帳號的資訊,請參閱建立企業管理平台。設定企業管理平台後,請驗證您的商家

Meta 應用程式

透過您的 Meta 開發人員帳號,建立企業類型的應用程式。您可以透過應用程式面板存取任何 Meta 應用程式,以控制設定和要求權限。

企業應用程式會自動核准適用於企業應用程式類型的所有權限和功能的標準存取,因此當您處於此存取層級時,就可以開發和測試您的應用程式。

標準存取實際上可限制商業應用程式只能存取具有應用程式或商家角色之應用程式用戶所擁有的資料。您的 Meta 應用程式必須經過應用程式審查,並要求 whatsapp_business_management 權限的進階存取權限,才能進行發佈。建議您儘快開始進行此程序。您不需要等待內嵌註冊完整實作,即可開始進行此程序。

您也需要為 WhatsApp 雲端 API 要求 whatsapp_business_messaging 權限,因為 API 呼叫需要該權限。

強烈建議您不要要求這兩個權限之外的其他權限,因為這會使註冊程序造成不必要拖延。

存取權杖

企業整合工具系統用戶存取權杖系統用戶存取權杖都可以用來存取已加入顧客的資料。您使用的權杖類型取決於您是使用「Facebook 登入」來配置內嵌註冊,還是使用「商家專用 Facebook 登入」來配置內嵌註冊,以及您是技術供應商還是解決方案供應商。

技術供應商

技術供應商較適合使用企業整合工具系統用戶存取權杖,因為這些權杖的範圍僅限於個別顧客。每當顧客完成以「商家專用 Facebook 登入」來配置的內嵌註冊時,您就可以藉由交換傳回給您的代碼來取得其中一個權杖。如果您是使用以「Facebook 登入」來配置內嵌註冊(不建議使用),則必須改用系統用戶存取權杖。

如果您是使用系統用戶存取權杖,系統用戶必須授予 whatsapp_business_management 權限給您的應用程式

解決方案合作夥伴

您必須使用系統用戶存取權杖,將您的帳號額度與加入的顧客分享。對於所有其他要求,較適合的解決方案是使用企業整合工具系統用戶存取權杖。

當顧客完成以「商家專用 Facebook 登入」來配置的內嵌註冊時,您可以藉由交換所傳回的代碼來取得企業整合工具系統用戶存取權杖。如果您是使用以「Facebook 登入」來配置內嵌註冊(不建議使用),則必須改用系統用戶存取權杖。

請注意,若要使用系統用戶存取權杖,您的系統用戶必須已授予 whatsapp_business_management 權限給您的應用程式(您可以在產生權杖時授予該權限),而且系統用戶必須被授予財務編輯角色,才能將您的帳號額度與加入的顧客分享。

若要將財務編輯角色授予您的系統用戶:

  1. 登入 Meta Business Suite
  2. 在左上角的下拉式功能表中找到您的商業帳號,然後點擊其「設定」(齒輪)圖示。
  3. 點擊企業管理平台設定
  4. 導覽至用戶 > 系統用戶
  5. 編輯用戶,並授予其財務編輯角色。

帳號額度

您必須設定帳號額度,以使用 WhatsApp Business 平台傳送訊息。您將與顧客分享此帳號額度,因此請務必在企業管理平台內的企業管理平台設定 > 付款中接受帳號額度分配 API 條款。

如需透過企業管理平台(而不是 API)分享帳號額度的相關資訊,請參閱分享每月開立帳單的使用權限

WhatsApp Business 平台內部部署 API 用戶端

如果您是使用內部部署 API,請確認您執行的 WhatsApp Business API 用戶端版本未過期。

整合程序

在整合程序中,您的 Meta 應用程式必須經過應用程式審查,並要求 whatsapp_business_management 權限的進階存取權限。建議您儘快開始進行此程序。您不需要等待內嵌註冊完整實作,即可開始進行此程序。

1:內嵌註冊流程

設定 Facebook JavaScript SDK 和「Facebook 登入」,將註冊流程內嵌在您的網站或用戶端入口網站中。您可以隨意將此流程內嵌在您擁有的多個網頁或入口網站中。

2:整合必要的端點

內嵌註冊流程後,整合必要的 API 端點以完成整合程序。若要移至下一個步驟,您必須能夠:

註冊完成後,請使用 message_templates 端點取得預先核准的訊息範本和命名空間,讓企業可以開始傳送消息。

您必須使用加密的端點(HTTPS)。如需詳細資訊,請參閱登入安全性

3:訂閱 WABA 以接收 Webhooks

商家完成註冊後,您可以訂閱想要接收其 Webhooks 的每個 WABA。您可以設定您的 Webhooks,以在發生下列狀況時通知您:

  • 手機號碼的名稱已更新,
  • 手機號碼的品質狀態已更新,以及
  • 帳號已審查、升級或封鎖。

選用

如有需要,您可以: