摘要
本指南說明如何使用 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?