新手指南

本指南可幫助您使用雲端 API 傳送和接收第一則訊息。您亦會了解如何設定 Webhooks,以便與應用程式範例配合使用。

本指南適合想為自己或自家機構開發應用程式的用戶。如果您開發的應用程式會供其他企業使用,請參閱解決方案供應商

準備工作

您將需要:

步驟 1:為自家應用程式新增 WhatsApp 產品

如果您已建立新應用程式,此時系統將提示您為應用程式新增產品。向下捲動,然後在 WhatsApp 下選擇設定。或者,從我的應用程式畫面中選擇您的應用程式,然後您可以再次按照相同的指示為自家應用程式新增 WhatsApp 產品。

如果您擁有 Meta 商業帳戶(MBA),則在您為自家應用程式新增 WhatsApp 產品時,系統會提示您附加有關帳戶。如果您沒有 Meta 商業帳戶,系統會提供一系列提示,幫助您建立 Meta 商業帳戶。將 Meta 商業帳戶附加至您的應用程式後,便可開始測試。

為自家應用程式新增 WhatsApp 產品可為您帶來以下好處:

  • 若您沒有 Meta 商業帳戶,系統會提示您建立有關帳戶。
  • 自動為您建立測試 WhatsApp Business 帳戶。此帳戶設有限制,讓您免費收發訊息,因此僅用於測試和開發目的。
  • 建立與您 WhatsApp Business 帳戶關聯的測試企業電話號碼。您可以使用此號碼,向最多 5 個傳送對象手機號碼傳送免費訊息。
  • 建立經預先批准的訊息範本組合。

步驟 2:新增傳送對象號碼

新增可傳送測試訊息的有效 WhatsApp 號碼。

在應用程式管理中心的左側選單中,前往 WhatsApp > API 設定。在收傳訊息下方,選擇欄位並選擇管理電話號碼清單

您可以新增任何有效的 WhatsApp 號碼作為傳送對象。傳送對象號碼會在 WhatsApp 中收到確認碼,可用於驗證號碼。

驗證傳送對象號碼後,有關號碼現在應該會在欄位中顯示為已選。如果您想新增其他傳送對象,請重複此流程;您最多可新增 5 個傳送對象。

步驟 3:傳送測試訊息

將預先核准的 hello_world 範本訊息傳送至您選擇的傳送對象號碼。

WhatsApp > API 設定面板中:

  1. 確保已在欄位中選擇測試商家電話號碼。
  2. 確保已在欄位中選擇要向哪個傳送對象手機號碼傳送訊息。如果您新增了多個號碼,可以一次過傳送多則訊息。
  3. 透過 API 傳送訊息面板中,點擊傳送訊息按鈕。

或者,您可以複製 cURL 指令,然後將其貼到新的終端機視窗來運行。

請注意,有關程式碼代表您正在傳送範本訊息(”type”:”template”),並標示要使用的特定範本(”name”:”hello_world”)。

步驟 4:複製我們的應用程式範例並配置 Webhooks

透過 Webhooks,您可以收到有關特定物件變更的即時 HTTP 通知。在 WhatsApp 中,Webhooks 可以在您的應用程式中通知您許多事件,如訊息傳送和已讀通知,甚至是帳戶變更。

新增回呼網址以查看 Webhooks 的內容。請按照我們的 Webhooks 測試回呼網址範例指南來複製我們的應用程式範例,此應用程式接受 Webhooks 通知並會在螢幕上顯示其 JSON 裝載。

設定 Webhook 後,重新傳送範本訊息,然後回覆有關訊息。您應該會看到 4 個單獨的 Webhook 通知:訊息傳送、已送達和已讀通知,以及收到的訊息內容。

步驟 5:(選用)新增真實的企業號碼

設定好測試企業號碼和測試 WhatsApp 商業帳戶後,您便可開始開發應用程式。您在應用程式開發過程中使用這些測試資產時,將無需支付訊息傳送費用。

當您準備好開始向顧客傳送訊息後,可以在 API 設定面板中新增真實的企業電話號碼,並建立真實的 WhatsApp Business 帳戶。