使用騰訊雲簡訊服務設定簡訊驗證

Logto 官方的騰訊雲簡訊服務連接器。

提示:

本指南假設你已對 Logto 連接器 (Connectors) 有基本了解。若不熟悉，請參閱 連接器 (Connectors) 指南以開始使用。

開始使用

騰訊雲是亞洲主要的雲端服務供應商，提供多種服務，包括簡訊（SMS, short message service）。

騰訊雲簡訊服務連接器是 Logto 的官方整合，協助終端使用者透過簡訊驗證碼註冊或登入。

在騰訊雲設定簡訊服務

建立騰訊雲帳號

前往 騰訊雲官網 註冊帳號（若尚未註冊）。

啟用並設定騰訊雲簡訊服務

1. 使用你的帳號登入 騰訊雲官網，進入 簡訊服務主控台頁面。
2. 在簡訊服務頁面點擊「免費試用」按鈕，並依指示完成設定。
3. 同意「簡訊開通服務條款」，點擊「開通服務」繼續。
4. 在「簡訊服務控制台概覽」頁面，根據需求從側邊欄選擇「國內消息」或「國際 / 港澳台消息」。
5. 新增簡訊簽名與範本。注意事項：
   • 新增「簽名」時，於「適用場景」欄位選擇「驗證碼」。
   • 新增範本時，選擇「驗證碼」作為範本類型。
   • 範本內容需包含一個 {1} 佔位符，將由系統隨機產生的驗證碼取代。
   • 不支援多個佔位符的範本，請使用或建立僅有一個佔位符的範本。
6. 提交簽名與範本審核。提交後：
   • 等待生效。
   • 可於「簡訊服務控制台概覽」發送測試簡訊。已審核通過的簽名與範本可直接測試，若仍在審核中可使用測試範本。
   • 測試前請確保帳戶餘額充足，並預先登記測試手機號碼以順利接收簡訊。

詳細指引請點擊簡訊控制台概覽中的「新手配置指引」分頁。

編寫連接器 JSON

1. 前往「簡訊服務控制台概覽」，將滑鼠移至右上角頭像，依序進入「存取管理 > 存取金鑰 > API 金鑰」，完成安全驗證後生成 AccessKey ID 與 AccessKey Secret，請妥善保存。
2. 在「國內消息」或「國際 / 港澳台消息」分頁下，取得「簽名名稱」與「範本 CODE」。
   • 測試範本請於「快速開始」分頁下的「測試專用簽名範本」查詢。

• 使用下列欄位設定騰訊雲簡訊連接器：
  • accessKeyId 與 accessKeySecret：使用步驟 1 取得的憑證。
  • signName：步驟 2 取得的簽名名稱，適用於所有範本。
  • 若有多種情境可新增多個範本。單一範本範例：
    • templateCode：於步驟 2 取得的範本 CODE。
    • usageType：針對不同情境指定 Register、SignIn、ForgotPassword 或 Generic（Logto 專屬屬性）。
    • 請確保四種情境皆有對應範本以完成流程。
  • sdkAppId：於「應用管理」查詢。
  • region：於「發送文檔」查詢支援的地區。

測試騰訊雲簡訊連接器

你可以輸入手機號碼並點擊「發送」來測試設定是否正確，確認無誤後再點擊「儲存並完成」。

就是這麼簡單。別忘了 在註冊 / 登入流程啟用連接器。

設定類型

名稱	類型
accessKeyId	string
accessKeySecret	string
signName	string
region	string
sdkAppId	string
templates	Template[]

範本屬性	類型	列舉值
templateCode	string	N/A
usageType	enum string	'Register' / 'SignIn' / 'ForgotPassword' / 'Generic'

參考資料

如何實現簡訊驗證碼功能？