# Gmail 串接測試
{% hint style="warning" %}
雖然**系統支持 Gmail 串接作為一種測試功能，但仍建議您使用標準的郵件伺服器進行日常服務**。這是因為Gmail 串接主要是為了測試目的，可能不適合所有的生產環境需求。為了確保您的郵件傳輸更加穩定可靠，選擇正規的郵件服務是更佳的選擇。
{% endhint %}
## 1. FIRST LINE 平台設定
如果你已經用自己的 Gmail 帳號進行綁定，但還沒有按照「Google認證專用信箱」的步驟來設定，別擔心。只需依照以下步驟在設立了專用的 Google 認證信箱之後，進入你的 Gmail 帳戶，重新發送認證信到這個新建的專用信箱即可。
1. 為符合 Google 的安全性規範，並確保能順利接收認證信進行串接，需在系統中新增一個**專用郵件帳戶**作為驗證用途。
建議將此信箱明確命名（例如：「Google 認證專用信箱」），以利後續識別與管理。
2. 請於「設定收信電子信箱地址」中的「你的電子信箱位址」欄位，填入下方「設定自動轉寄至 FIRST LINE」所提供的**系統預設 Email 地址**。
此設定代表允許 Google 將驗證信**直接寄送至系統預設信箱**，以完成後續串接流程。
3. SMTP 設定部分實際上**不涉及寄信功能**，僅用於接收驗證信，因此無需設定真實可用的寄送資訊。可填寫任意格式正確的信箱（例如：`xxxx@xxxx.com`）即可完成設定。
## 2. Gmail 服務設定
接下來我們回 **Gmail** 進行設定：
開啟 Gmail 後，點選頁面右上方的**齒輪圖示（設定）**，並點選「查看所有設定」進入相關設定頁面。
在 Gmail 設定頁面中，選擇「**轉寄和 POP/IMAP**」分頁，並點選「**新增轉寄地址**」。
接著輸入在系統中提供的 **FIRST LINE 系統郵件地址**，例如：\
`xxxx@tenant.firstline.cc`
完成後依提示進行驗證與確認。
完成所有步驟後，稍後 FIRST LINE 系統將會收到來自 Google 的驗證信。當設定顯示如圖所示，即代表綁定程序已完成。
## 3. 回到 FIRST LINE 平台收信
完成 Gmail 端設定後，Gmail 會發送一封驗證信至 FIRST LINE 系統。
你可以透過以下方式查看該信件：
* 前往「儀表板」中的「交談佇列」，並透過管道篩選找到該信件
* 或依正常分派流程接起該信件後查看內容
接著依照信件中的指示，點擊驗證連結以完成設定。
{% hint style="success" %}
## ✅ Google 認證串接設定確認表
**1. 建立專用信箱**
* [ ] 在系統中新增一個「專用收信帳號」（建議命名：Google 認證信箱）
**2. 設定收信地址**
* [ ] 到「設定收信電子信箱地址」
* [ ] 將「你的電子信箱位址」填入：**FIRST LINE 提供的 Email**
**3. SMTP 可略過**
* [ ] SMTP 隨便填（格式正確即可，例如 ）
* [ ] 不影響功能（因為不會用來寄信）
**4. 到 Gmail 設定轉寄**
* [ ] 打開 Gmail → 右上角「設定（齒輪）」→「查看所有設定」
* [ ] 進入「轉寄和 POP/IMAP」
* [ ] 點「新增轉寄地址」
* [ ] 輸入：FIRST LINE 系統 Email（例如 ）
**5. 完成 Gmail 轉寄地址**
* [ ] 按照 Gmail 指示完成轉寄地址
**6. 到 FIRST LINE 收驗證信**
* [ ] 前往「儀表板」→「交談佇列」
* [ ] 找到該封 Google 驗證信
* [ ] 打開信件並點擊驗證連結
{% endhint %}
***
## :question:常見問題
### 無法透過 SMTP 發信
您在測試 Gmail SMTP 發信時，若出現錯誤為 **「Failed to authenticate on SMTP server with username “” using 3 possible authenticators. Authenticator LOGIN returned Swift\_TransportException」。**\
\
請詢問該信箱的管理者協助排除下列可能導致的原因：
1. 您這組 google 信箱目前已經超過三個應用程式授權使用上限。
2. 由於您的帳戶使用**兩步驟驗證**，您必須**建立應用程式專用密碼**，才能使用應用程式登入。
### 如何開啟應用程式密碼
若您發現用 Gmail SMTP 寄信失敗，可能原因為至 2022 年 5 月起，Google 已全面改用更為嚴謹的「應用程式密碼」功能，無法再使用您自身 Google 登入密碼寄信。
1. **進入 Google 安全設定頁面**：
* 開啟瀏覽器，進入 [Google 安全設定](https://myaccount.google.com/intro/security) 頁面。
* 在「登入 Google」區域中，點擊「兩步驟驗證」。
2. **啟用兩步驟驗證**：
* 點擊「開始使用」，按照提示驗證您的身份（可能需要輸入 Google 密碼）。
* 輸入您的手機號碼，選擇接收驗證碼的方式（簡訊或語音通話）。
* 輸入收到的驗證碼，完成兩步驟驗證設定。
3. **產生應用程式密碼**：
* 返回 [Google 安全設定](https://myaccount.google.com/intro/security) 頁面，找到「應用程式密碼」選項並點擊。
* 在「選取應用程式」下拉選單中，選擇「其他（自訂名稱）」。
* 輸入「FIRST LINE 系統」，然後點擊「產生」。
* 系統會生成一組應用程式密碼，請妥善記錄。
4. **設定 FIRST LINE 系統的 SMTP**：
* 登入您的 FIRST LINE 系統管理介面，進入電子信箱設定頁面。
* 輸入以下 SMTP 設定資訊：
* **伺服器位置**：smtp.gmail.com
* **通訊埠**：587
* **帳號**：\[您的 Gmail 帳號]
* **密碼**：\[剛剛取得的應用程式密碼]
* **加密方式**：TLS
* 保存設定後，嘗試發送測試郵件，確認設定是否成功。