如果您是開發應用程式以供其他企業使用,請參閱我們的技術供應商入門指南解決方案合作夥伴入門指南

新手指南

本指南可幫助您使用雲端 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 帳戶。