本指南可幫助您使用雲端 API 傳送和接收第一則訊息。您亦會了解如何設定 Webhooks,以便與應用程式範例配合使用。
本指南適合想為自己或自家機構開發應用程式的用戶。如果您開發的應用程式會供其他企業使用,請參閱解決方案供應商。
您將需要:
如果您已建立新應用程式,此時系統將提示您為應用程式新增產品。向下捲動,然後在 WhatsApp 下選擇設定。或者,從我的應用程式畫面中選擇您的應用程式,然後您可以再次按照相同的指示為自家應用程式新增 WhatsApp 產品。
如果您擁有 Meta 商業帳戶(MBA),則在您為自家應用程式新增 WhatsApp 產品時,系統會提示您附加有關帳戶。如果您沒有 Meta 商業帳戶,系統會提供一系列提示,幫助您建立 Meta 商業帳戶。將 Meta 商業帳戶附加至您的應用程式後,便可開始測試。
為自家應用程式新增 WhatsApp 產品可為您帶來以下好處:
新增可傳送測試訊息的有效 WhatsApp 號碼。
在應用程式管理中心的左側選單中,前往 WhatsApp > API 設定。在收傳訊息下方,選擇到欄位並選擇管理電話號碼清單。
您可以新增任何有效的 WhatsApp 號碼作為傳送對象。傳送對象號碼會在 WhatsApp 中收到確認碼,可用於驗證號碼。
驗證傳送對象號碼後,有關號碼現在應該會在到欄位中顯示為已選。如果您想新增其他傳送對象,請重複此流程;您最多可新增 5 個傳送對象。
將預先核准的 hello_world
範本訊息傳送至您選擇的傳送對象號碼。
在 WhatsApp > API 設定面板中:
或者,您可以複製 cURL 指令,然後將其貼到新的終端機視窗來運行。
請注意,有關程式碼代表您正在傳送範本訊息(”type”:”template”
),並標示要使用的特定範本(”name”:”hello_world”
)。
透過 Webhooks,您可以收到有關特定物件變更的即時 HTTP 通知。在 WhatsApp 中,Webhooks 可以在您的應用程式中通知您許多事件,如訊息傳送和已讀通知,甚至是帳戶變更。
新增回呼網址以查看 Webhooks 的內容。請按照我們的 Webhooks 測試回呼網址範例指南來複製我們的應用程式範例,此應用程式接受 Webhooks 通知並會在螢幕上顯示其 JSON 裝載。
設定 Webhook 後,重新傳送範本訊息,然後回覆有關訊息。您應該會看到 4 個單獨的 Webhook 通知:訊息傳送、已送達和已讀通知,以及收到的訊息內容。
設定好測試企業號碼和測試 WhatsApp 商業帳戶後,您便可開始開發應用程式。您在應用程式開發過程中使用這些測試資產時,將無需支付訊息傳送費用。
當您準備好開始向顧客傳送訊息後,可以在 API 設定面板中新增真實的企業電話號碼,並建立真實的 WhatsApp Business 帳戶。