寄信服務(SMTP)
郵件管道透過你自己的 SMTP 伺服器寄信 —— RooQuiz 不代發。所以通知是從你自己的位址發出的,也沒有平台層面的傳送量限制。
在設定 → 組織 → 寄信服務裡配一次,團隊裡所有郵件連接器共用這一份。
沒有已驗證的寄信服務時,郵件連接器仍然能儲存,但一封都投不出去。它的卡片上會顯示紅色的「未設定寄信服務」標記。
填什麼
| 欄位 | 說明 |
|---|---|
| SMTP 伺服器 | 服務供應商給的主機名稱,如 smtp.gmail.com |
| 通訊埠 | 587(STARTTLS)、465(SSL/TLS)或 2525 |
| 使用者名稱 | 通常是完整電子郵件位址;部分服務供應商用固定字面值 |
| 密碼 | SMTP 密碼或 API key。以後修改其他欄位時留空,就沿用已儲存的那個 |
| 寄件者位址 | 必須是這台 SMTP 伺服器允許代發的位址 |
| 寄件者名稱 | 收件人看到的顯示名 |
| 回覆位址 | 選填,希望回覆走別處時才用 |
25 通訊埠不能用。 我們的託管平台封禁了該通訊埠的對外連線,請用 587 或 465。
各服務供應商怎麼填
| 欄位 | 值 |
|---|---|
| SMTP 伺服器 | smtp.gmail.com |
| 通訊埠 | 587 (STARTTLS) |
| 使用者名稱 | 完整的 Gmail 位址 |
| 密碼 | 16 位應用專用密碼 |
| 寄件者位址 | 同一個 Gmail 位址,或該帳號裡已驗證的「以此身分傳送」別名 |
去 myaccount.google.com/apppasswords 生成應用專用密碼。它只顯示一次,格式是四組四位 —— 貼上前把空格去掉。
帳號密碼是不行的。Google 已經關閉了郵件客戶端的密碼登入,只能用應用專用密碼 —— 而應用專用密碼只有在兩步驗證已開啟時才存在。
如果那個頁面顯示「你要找的設定不適用於你的帳號」,原因是三者之一:兩步驗證沒開;這是 Google Workspace 帳號且管理員停用了應用專用密碼;或者帳號加入了進階保護計畫(會直接停用這個功能)。
另外 Gmail 有傳送上限:個人帳號約每天 500 個收件人,Workspace 約 2000。對團隊通知完全夠用,但不適合群發。
儲存並驗證
填好欄位,點「儲存並驗證」
儲存和驗證是同一個動作,所以不會出現「存下來了但沒測過」的中間狀態。
去收件匣找那封測試郵件
測試郵件發往你自己的 RooQuiz 帳號電子郵件 —— 也就是你目前登入用的那個,不是你剛填的寄件者位址。如果沒收到,先查那個電子郵件和它的垃圾郵件資料夾,別急著改設定。
確認狀態顯示「已驗證」
「已驗證」的含義是:你的 SMTP 伺服器接收了這封信並回傳了成功碼。這不等於送達 —— SMTP 伺服器是先收下、再往外轉投,所以信件之後仍可能被判垃圾或被退回。如果驗證通過卻沒收到,問題在收件一側:先看垃圾郵件資料夾,再去寄件信箱裡找退信。
驗證失敗時
頁面上會原樣顯示你的 SMTP 伺服器回傳的錯誤,刻意不做轉述,方便你直接照著處理。常見的幾種:
| 錯誤 | 含義 |
|---|---|
535 Username and Password not accepted | 憑據不對。Gmail 的情況通常是用了帳號密碼,或者應用專用密碼裡的空格沒去掉 |
553 Sender address rejected: not owned by user | 寄件者位址不在這台伺服器允許代發的範圍裡。改成該帳號真正擁有的電子郵件或別名 |
550 relay not permitted | 伺服器完全不為你轉投 —— 一般是使用者名稱填錯,或該電子郵件沒開 SMTP 權限 |
| 逾時 / 連線失敗 | 主機名稱或通訊埠不對,或者伺服器不接受來自外部網路的連線 |
一些細節
- 密碼儲存後不再回顯。修改其他欄位時把它留空,已儲存的密碼不會被動。
- 改動伺服器、通訊埠、使用者名稱、密碼或寄件者位址,狀態會退回未驗證,直到下一次驗證成功。
- 儲存與驗證有頻率限制,每個團隊每小時只能試幾次 —— 每一次都會真的連線到你的伺服器、真的發出一封信。
- 移除寄信服務會刪掉已儲存的密碼。改設定不需要先移除,直接覆蓋儲存即可。只要還有啟用中的郵件連接器,移除會被拒絕 —— 免得你把自己的投遞靜默弄壞。
- 如果之後某次投遞永久失敗(憑據失效、寄件者位址被拒),狀態會變成驗證失敗,郵件連接器會停止投遞直到你修好。單個收件人位址失效不會導致這種情況,那只會讓那一封信失敗。
五個管道
連接支援五個管道:郵件(走你自己的 SMTP 伺服器)、Webhook、Slack、Zapier 與 Kit。每個管道每個團隊只能設定一條連接,要換掉已有的得先刪除。這一頁說明每個管道分別投遞什麼、收件人與訊息格式怎麼設定、各自需要哪些前置設定。郵件管道每條最多十個收件人,也可以把「答題者電子郵件」作為動態收件人直接通知本人。
觸發事件與範圍
每條連接自己決定什麼時候觸發(事件)和哪些測評能觸發它(範圍),兩者是「與」的關係:事件命中、且來原始測評在範圍內,才會投遞。這一頁列出全部觸發事件的含義、如何把範圍收斂到指定測評、範圍留空代表全部,以及常見的事件與範圍組合建議。常見組合例如:只讓主推的那份測評在產生新線索時推 Slack,其餘測評保持安靜。