使用 Twilio SMS 設定簡訊驗證

Logto 的官方 Twilio 短訊服務連接器。

提示:

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

開始使用

Twilio 提供可編程的通信工具，用於撥打和接聽電話、發送和接收簡訊及其他通信功能。我們可以透過其網路服務 API 發送「驗證碼」簡訊。

註冊 Twilio 帳戶

在 Twilio 上創建一個新帳戶。（如果你已經有帳戶，請跳到下一步。）

設定發送者的電話號碼

前往 Twilio 控制台頁面並使用你的 Twilio 帳戶登入。

在「Phone Numbers」->「Manage」->「Buy a number」下購買一個電話號碼。

提示:

有時你可能會遇到特定國家或地區不支援簡訊服務的情況。選擇其他地區的號碼以繞過此限制。

當我們擁有一個有效的號碼後，導航到「Messaging」->「Services」。點擊按鈕創建一個新的 Message Service。

給予一個友好的服務名稱，並選擇 Notify my users 作為我們的服務目的。 在下一步中，選擇 Phone Number 作為 Sender Type，並將我們剛剛申請的電話號碼添加到此服務作為發送者。

備註:

每個電話號碼只能與一個訊息服務連結。

獲取帳戶憑證

我們需要 API 憑證來使連接器正常運作。從 Twilio 控制台頁面開始。

點擊右上角的「Account」菜單，然後前往「API keys & tokens」頁面以獲取你的 Account SID 和 Auth token。

返回側邊欄的「Messaging」->「Services」設定頁面，找到你的服務的 Sid。

編寫連接器 JSON

用對應訊息服務的 Account SID、Auth token 和 Sid 填寫 accountSID、authToken 和 fromMessagingServiceSID 欄位。

你可以為不同情況添加多個 SMS 連接器範本。以下是一個添加單一範本的例子：

• 用任意字串類型內容填寫 content 欄位。不要忘記保留 {{code}} 佔位符以用於隨機驗證碼。
• 用 Register、SignIn、ForgotPassword 或 Generic 填寫 usageType 欄位以適應不同使用情境。為了啟用完整的使用者流程，Register、SignIn、ForgotPassword 和 Generic 的範本是必需的。

測試 Twilio SMS 連接器

你可以輸入一個電話號碼並點擊「Send」來檢查設定是否在「Save and Done」之前有效。

就是這樣。別忘了 在登入體驗中啟用連接器。

配置類型

名稱	類型
accountSID	string
authToken	string
fromMessagingServiceSID	string
templates	Templates[]

範本屬性	類型	枚舉值
content	string	N/A
usageType	enum string	'Register' | 'SignIn' | 'ForgotPassword' | 'Generic'

參考資料

Twilio - 錯誤和警告字典