摘要

本指南說明如何使用 Wati 的 API 透過 WhatsApp 發送一次性密碼 (OTP)。您將了解如何建立驗證範本、取得核准,以及使用 /sendTemplateMessage API 觸發 OTP 訊息。

可用性

  • 驗證範本適用於訂閱 Wati Growth、Pro 和 Business 方案的客戶。

  • 如果您使用的是 Wati 的舊版方案 (legacy plan),驗證範本適用於 Standard 和 Professional 方案。

操作說明

請參閱此影片逐步解說,了解如何透過 Wati 在 WhatsApp 上發送 OTP:

步驟 1:建立驗證範本

在發送 OTP 之前,您需要建立一個驗證範本訊息並獲得 WhatsApp 的核准。此範本可確保驗證訊息的格式一致。

驗證範本中的必要元素:

帶有 OTP 按鈕的驗證範本必須包含:

  • 驗證訊息:包含 OTP 預留位置的預設文字。

  • <VERIFICATION_CODE> 是您的驗證碼。

  • 安全免責聲明(選填):為了您的安全,請勿分享此代碼。

  • 過期警告(選填):此代碼將於 <NUM_MINUTES> 分鐘後過期。

  • 按鈕:複製代碼 (Copy Code) 或一鍵自動填入 (One-Tap Autofill) 按鈕。

重要注意事項

  • 驗證範本不支援 URL、媒體和表情符號。

  • 這些範本由預設文字和按鈕組成,可降低被暫停服務的風險。

提交範本後,請等待 WhatsApp 核准,然後再進行下一步。

步驟 2:使用 API 發送 OTP

獲得核准後,您可以使用 Wati 的 /sendTemplateMessage API 觸發 OTP。此 API 允許您的系統向使用者發送預先核准的驗證訊息。

API 端點:

https://{WATI_API_ENDPOINT}/api/v1/sendTemplateMessage

注意:對於使用 Wati API 發送驗證 OTP 訊息的商家,您可以啟用簡訊 (SMS) 備援功能,即使 WhatsApp 訊息發送失敗,也能協助確保 OTP 送達並維持業務順利運作。

使用 Send Template Message V3 API

您可以透過 POST /api/ext/v3/messageTemplates/send 端點發送驗證 (AUTHENTICATION) 範本(複製代碼)嗎?

可以。透過此端點發送驗證範本(OTP 代碼)時需注意以下幾點:

  • 參數名稱:使用 #{{1}} 作為 OTP/代碼值。

  • 代碼過期:90 分鐘是 Meta 允許的最長過期時間。

  • 範本設定:驗證範本必須使用 Meta 的預設驗證範本格式建立,或從範本庫中選擇——它們無法建立為自由格式範本。

有關發送訊息範本(包括驗證範本)的完整請求參數、回應格式和錯誤代碼,請參閱 Send Message Template API V3 參考文件。

設定簡訊備援功能以防 WhatsApp OTP 失敗

如果 WhatsApp OTP 訊息失敗,請依照下列步驟設定簡訊作為備援:

步驟 1:升級至 Wati Business 方案

簡訊備援功能僅適用於 Business 方案。

步驟 2:將 Wati 與 Twilio 連接

在 Wati 中,前往更多 (More) → 整合 (Integrations)。
新增您的 Twilio 帳號並開啟為失敗的行銷活動發送自動簡訊 (Send automated SMS for failed campaign)。

步驟 3:建立 WhatsApp OTP 範本

在 Wati 中,建立將用於 WhatsApp 驗證 OTP 的訊息範本。

步驟 4:建立簡訊 OTP 範本

建立一個對應的簡訊範本,並將其連結至您在步驟 3 中建立的 WhatsApp OTP 範本。

步驟 5:使用 Wati API 發送 WhatsApp OTP

當您的系統呼叫 Wati API 發送 WhatsApp OTP 範本時,如果 WhatsApp 傳送失敗,Wati 將自動透過 Twilio 發送簡訊備援。

提示:若要進一步了解驗證範本,請參閱 Meta 的官方指南。

常見問題 (FAQs)

驗證範本與 OTP

1. 什麼是 OTP 的驗證範本?

這是 WhatsApp 要求的一種預先核准訊息格式,用於透過 Wati 發送 OTP。它包含一個 OTP 預留位置、預設驗證文字,以及一個按鈕(例如「複製代碼」或「一鍵自動填入」)。

2. 驗證範本必須包含哪些元素?

它必須包含帶有 OTP 預留位置的驗證訊息。選填欄位包括安全免責聲明和過期警告。它還必須包含一個按鈕,例如「複製代碼」或「一鍵自動填入」。

3. 驗證範本可以包含 URL、媒體或表情符號嗎?

不行。驗證範本不支援 URL、媒體和表情符號。

4. 驗證範本需要取得 WhatsApp 的核准嗎?

是的。您必須提交範本並等待 WhatsApp 核准後,才能發送 OTP 訊息。

透過 Wati API 發送 OTP

5. 如何使用 Wati 發送 OTP 訊息?

驗證範本核准後,您可以使用 Wati 的 /sendTemplateMessage API 發送 OTP。

6. 發送 OTP 訊息的 API 端點是什麼?

端點為:https://{WATI_API_ENDPOINT}/api/v1/sendTemplateMessage

7. 我可以使用 POST /api/ext/v3/messageTemplates/send 端點發送驗證範本嗎?

可以。您可以使用 /api/ext/v3/messageTemplates/send 端點發送包含 OTP 代碼的驗證範本。請使用 #{{1}} 作為 OTP 或代碼值的參數。Meta 允許的最長代碼過期時間為 90 分鐘。驗證範本必須使用 Meta 的預設驗證範本格式,或從範本庫中選擇;它們無法建立為自由格式範本。

有關完整的請求參數、回應格式和錯誤代碼,請參閱 Send Message Template API V3 參考文件。

可用性與備援設定

8. 哪些 Wati 方案支援驗證範本?

Growth、Pro 和 Business 方案均支援。在舊版方案中,Standard 和 Professional 方案也支援。

9. 什麼是簡訊備援,誰可以使用它?

簡訊備援透過在 WhatsApp OTP 失敗時發送簡訊來確保送達。它僅適用於 Wati Business 方案。

10. 如何在 Wati 中啟用簡訊備援?

在 Wati 的「更多 → 整合」中連接您的 Twilio 帳號,並啟用失敗行銷活動的自動簡訊。您還必須同時建立 WhatsApp 和簡訊 OTP 範本,並將它們連結起來,以便備援功能自動運作。

Did this answer your question?