開始使用

本指南將協助您使用雲端 API 傳送和接收第一則訊息。您同時將學習如何設定 Webhooks 以搭配應用程式範例使用。

本指南適用於為自己或組織開發應用程式的人員。如果您要開發供其他企業使用的應用程式,請參閱解決方案供應商

準備工作

必備資料:

步驟 1:將 WhatsApp 產品加到您的應用程式

此時,如果您建立新的應用程式,系統將提示您將產品加到您的應用程式。向下捲動,然後在 WhatsApp 下選擇設定。否則,請從我的應用程式畫面中選擇您的應用程式,您可以再次按照相同的說明將 WhatsApp 產品加到您的應用程式。

如果您有 Meta 商業帳號(MBA),在將 WhatsApp 產品加到您的應用程式時,系統會提示您附加該帳號。如果您沒有 MBA,系統會透過一些提示來幫助您建立一個。當您將 MBA 附加到應用程式後,就可以開始進行測試。

將 WhatsApp 產品加到您的應用程式可為您做一些事情:

  • 如果您沒有 Meta 商業帳號,提示您建立一個。
  • 自動為您建立一個測試版 WhatsApp 商業帳號。由於您不需支付訊息費用,因此該帳號有其限制,且僅用於測試和開發目的。
  • 建立與您的 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 商業帳號。