# 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
* 保存設定後，嘗試發送測試郵件，確認設定是否成功。
---
# Agent Instructions: Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter:
```
GET https://help.firstline.cc/feature/channels/email/gmail-bang-ding-fan-li.md?ask=
```
The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.