我們正在實施一項變更,在內嵌註冊流程中儲存權杖時,將會授予共用 API 存取權限。若在內嵌註冊流程中發生非預期的問題或影響,請聯絡支援團隊。

內嵌註冊

內嵌註冊是與桌面和行動裝置相容的驗證和授權介面,可讓商家顧客輕鬆產生所需的資產,以便您成功將其加入 WhatsApp Business 平台。

發生錯誤
播放此影片時發生問題。

內嵌註冊流程會向商家顧客收集商家相關資訊、自動產生平台需要的所有 WhatsApp 資產,並將這些資產的存取權限授予您的應用程式,讓您能夠快速為商家顧客提供 WhatsApp 訊息服務。

透過內嵌註冊加入的顧客擁有其所有 WhatsApp 資產,並可將這些資產用於 WhatsApp 發訊廣告等其他 Meta 解決方案。

運作方式

內嵌註冊利用「商家專用 Facebook 登入」產品和我們的 JavaScript SDK。配置完成後,您可以在自己的網站或入口網站中加入用來啟動此流程的連結或按鈕。

點擊連結或按鈕的商家顧客會看到一個新視窗,可以在其中執行以下操作:

  • 使用 Facebook 或 Meta 商家憑證來驗證其身分
  • 授予您的應用程式存取其 WhatsApp 資產的權限
  • 選擇現有的商家資產管理組合或建立新的組合
  • 選擇現有的 WhatsApp Business 帳號(WABA)或建立新的帳號
  • 輸入並驗證他們的公司電話號碼(他們自己的電話號碼,或您提供的電話號碼)
  • 輸入顯示名稱,可代替顯示 WhatsApp 用戶端中的號碼

成功完成後,內嵌註冊會將顧客的 WABA 編號、商家電話號碼編號和可交換的權杖代碼傳回產生流程的視窗。您必須將此資料傳送到您的伺服器,並在伺服器對伺服器呼叫中使用此資料來執行下列操作:

  • 以此代碼來交換顧客範圍的企業權杖
  • 註冊顧客的商家電話號碼以供雲端 API 使用
  • 將您的應用程式訂閱至顧客 WABA 上的 Webhooks
  • 與顧客分享您的帳號額度(僅限解決方案合作夥伴)

這些步驟完成後,如果您是解決方案合作夥伴或與解決方案合作夥伴合作,顧客可以立即開始使用您或您合作夥伴的應用程式傳送訊息。如果您不是解決方案合作夥伴,或未與解決方案合作夥伴合作,則顧客必須先將付款方式附加至其 WABA,才能開始傳送訊息。

限制

加入數量上限

根據預設,您在連續 7 天內,最多可以加入 10 個商家顧客。只有新加入的顧客會計入此限制。您可以在 WhatsApp 管理工具 > 合作夥伴總覽面板中查看目前已加入的顧客數量。如果您接近此限制,將會收到電子郵件通知。

如果您完成商家驗證、應用程式審查和存取權驗證,我們會自動將您的數量上限提高到連續 7 天內可加入 200 個新商家顧客。如果您每週需要加入超過 200 個顧客,請申請成為 Meta 企業合作夥伴

商家顧客訊息數量上限

透過內嵌註冊加入的商家顧客從標準訊息數量上限開始,可以透過 API 用量來提高數量上限。

商家顧客電話號碼限制

  • 商家電話號碼只能註冊用於雲端 API。
  • 不支援已註冊用於內部部署 API 或是 WhatsApp 或 WhatsApp Business 應用程式所使用的商家電話號碼。
  • 透過內嵌註冊加入的商家顧客會從預設商家電話號碼限制開始。

預設流程

請參閱預設流程,瞭解商家顧客在內嵌註冊部分預設實作中會看到的每個畫面說明。

請注意,如果您知道顧客的商家相關資訊,可以插入此資料,如此可大幅減少顧客必須與之互動的畫面數量。

存取權杖

內嵌註冊會產生企業整合系統用戶存取權杖(「企業權杖」)。當商家顧客完成內嵌註冊流程時,可交換的權杖代碼會以訊息事件的形式傳回,並由 JavaScript SDK 擷取。您必須使用伺服器對伺服器呼叫,以此代碼來交換企業權杖。

如果您是技術供應商,只會使用企業權杖。

如果您是解決方案合作夥伴,則會使用系統用戶存取權杖(「系統權杖」)來與已加入的商家顧客共享您的帳號額度,並將企業權杖用於所有其他事項。請注意,權杖所代表的系統用戶必須已將 business_management 權限授予您的應用程式,並且必須已被授予您的商家資產管理組合管理員財務編輯角色,才能共享您的帳號額度。

權限

內嵌註冊可以配置為向您的商家顧客要求大部分權限,但您可能只需要:

  • whatsapp_business_management — 如果您的應用程式需要存取已加入的顧客 WhatsApp Business 帳號設定和訊息範本,則需要此權限。
  • whatsapp_business_messaging — 如果您的應用程式需要存取已加入的顧客商家電話號碼設定,或顧客會使用您的應用程式來傳送和接收訊息,則需要此權限。

您可以指定應用程式在實作程序期間需要哪些權限。

請注意,應用程式處於開發模式時,具有應用程式管理員開發人員測試人員角色的任何人都會在內嵌註冊的授權畫面中看到這些權限。然而,將應用程式切換為上線模式後,就只有透過應用程式審查程序批准進階存取的權限,才會出現在流程中。

帳單

解決方案合作夥伴

如果您是解決方案合作夥伴,您必須已經擁有帳號額度,並且已在 Meta Business Suite 的企業管理平台設定 > 付款面板中接受帳號額度分配 API 條款。此外,您必須與加入程序中的任何顧客共享您的帳號額度。

技術供應商和技術合作夥伴

如果您是技術供應商或技術合作夥伴,已加入的商家顧客必須在其 WhatsApp Business 帳號中新增付款方式。他們可以按照使用說明文章「將信用卡新增到 WhatsApp Business 平台帳號」中所述的步驟來執行此操作。

555 商家電話號碼

已驗證商家的商家顧客,或雲端 API 訊息數量上限已提高的商家,符合最多兩個 555 商家電話號碼的資格。

這些號碼的運作方式與標準商家電話號碼相同(顯示名稱必須接受審查和批准、受對話式定價規則規範、受品質評分影響等等),但有以下主要差異:

  • 使用美國電話國碼 (+1)
  • 使用 555 區碼
  • 會自動通過驗證
  • 無法移轉至其他 WhatsApp 商業帳號,或是在 WhatsApp Business 平台以外使用

若您的商家顧客符合 555 號碼的資格,且想要註冊另一個號碼,請指示顧客再次進行內嵌註冊實作。系統要求顧客選擇商家電話號碼時,會自動提供選擇 555 號碼的選項:

應用程式審查

您的應用程式必須獲得每個所需權限的進階存取權限,您才能加入商家顧客。

請參閱應用程式審查,進一步瞭解應用程式審查的相關資訊,以及您必須提供哪些資料才能成功完成此程序。

整合協助工具

內嵌註冊整合協助工具是應用程式主控板中的設定和測試工具。此工具可讓您進行以下操作:

  • 在各種流程配置中啟動內嵌註冊功能
  • 查看商家顧客完成流程後所回傳的資料
  • 產生實作碼和啟用查詢,接著您可以將其複製並貼到您的網站、商家顧客入口網站和伺服器中
  • 傳送 API 查詢到端點,在協助完成流程的顧客啟用時,您需要用到這些端點

前往應用程式主控板 > WhatsApp > ES 整合,即可存取整合協助工具。

Webhooks

在加入程序中,您必須將您的應用程式訂閱至完成內嵌註冊流程之每個商家顧客 WABA 上的 Webhooks。

根據您訂閱的 Webhook 欄位,會觸發 Webhooks 並將其傳送到您應用程式上配置的回呼網址。這表示所有已加入之商家顧客的所有 Webhooks 都會傳送至您應用程式的回呼網址。不過,您可以覆寫個人 WhatsApp Business 帳號或商家電話號碼上的回呼網址。請參閱 Webhooks 覆寫,瞭解如何執行此操作。

本地化

內嵌註冊流程提供 30 種語言。系統會根據商家顧客使用的 Facebook 語言,自動觸發本地化流程。

阿拉伯語、捷克語、丹麥語、希臘語、英語(英國)、西班牙語(西班牙)、西班牙語、芬蘭語、法語(法國)、希伯來語、北印度語、匈牙利語、印尼語、義大利語、日語、韓語、挪威語(巴克摩挪威語)、荷蘭語、波蘭語、葡萄牙語(巴西)、葡萄牙語(葡萄牙)、羅馬尼亞語、俄語、瑞典語、泰語、土耳其語、越南語、簡體中文(中國)、繁體中文(香港)、繁體中文(台灣)。

後續步驟

瞭解如何在您的網站或入口網站中實作內嵌註冊