> For the complete documentation index, see [llms.txt](https://docs.maiagent.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.maiagent.ai/start/system-emails.md).

# 系統通知與 Email

MaiAgent 什麼時候會寄 Email：每一種系統信的觸發條件、收件人、能不能關閉與在哪裡設定，對照通知中心的站內通知，並說明幾個容易誤會的寄信規則。

MaiAgent 會在帳號、成員、客服、連接器、方案與額度等事件發生時，主動寄 Email 給相關的人。本頁一次列出**所有**系統信：什麼時候寄、寄給誰、能不能關、在哪裡設定。很多事件也會同時在後台右上角的 [通知中心](/start/notifications.md) 發出站內通知，對照見 [站內通知與 Email 對照](#in-app-vs-email)。

{% hint style="info" %}

* 系統信由 MaiAgent 平台寄出（私有雲與地端則由貴公司設定的寄件信箱寄出），信件語言不會依收件人的介面語言切換。
* 客服在 [串接對話平台：Email](/build/choose-channel/email.md) 用 Email 回覆客戶的信，是透過該對話平台自己設定的郵件帳號寄出，不屬於系統信，不在本頁範圍。
  {% endhint %}

## 使用情境：分辨站內通知與 Email <a href="#notification-email-scenario" id="notification-email-scenario"></a>

組織管理員想確認收到的通知是否也會寄 Email。她先開啟後台右上角的 [通知中心](/start/notifications.md)，查看通知類型，再對照本頁的 [站內通知與 Email 對照](#in-app-vs-email)。例如「<mark style="color:blue;">連接器已啟用</mark>」只發站內通知，不會再寄 Email；知道這個規則後，她就不必繼續等待一封不會寄出的信。

<figure><img src="https://1593648278-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fmzb5NG9GDzFP2YDKeYVl%2Fuploads%2Fgit-blob-45a2cbe1369d8ea105f0fd43426c60ac0e02febe%2Fsystem-emails-notification-center.png?alt=media" alt="通知中心面板，含系統公告與組織公告分類"><figcaption><p>通知中心依系統公告與組織公告分類；是否另寄 Email，請對照本頁的通知表</p></figcaption></figure>

## 帳號與成員 <a href="#account-and-member-emails" id="account-and-member-emails"></a>

| 信件            | 什麼時候寄                                                                                                        | 寄給誰        | 能不能關閉、在哪裡設定                                                                                                                                         |
| ------------- | ------------------------------------------------------------------------------------------------------------ | ---------- | --------------------------------------------------------------------------------------------------------------------------------------------------- |
| 重設密碼信         | 在登入頁按 <mark style="color:blue;">忘記密碼</mark> 並送出 Email，見 [忘記密碼](/start/forget-password.md)                    | 該帳號本人      | 不能關閉                                                                                                                                                |
| 邀請信           | 管理員用 Email 邀請**還沒有 MaiAgent 帳號**的人加入組織，見 [成員管理](/org/overview/member.md)                                     | 被邀請的 Email | 不能關閉。沒收到時可在 <mark style="color:blue;">邀請狀態</mark> 按 <mark style="color:blue;">重新發送</mark>，連同第一次最多 3 次、間隔至少 5 分鐘，見 [收到邀請：加入組織](/start/invitation.md) |
| 設定密碼信（批次匯入成員） | 管理員用 Excel 批次新增成員時，名單中**這次新建立的帳號**，見 [批次成員與權限管理](/org/overview/member.md#batch-member-permission-management) | 新帳號本人      | 不能關閉                                                                                                                                                |
| 組織審核通過／未通過    | 自助註冊並申請試用的組織審核完成時，見 [申請帳號](/start/apply.md)                                                                  | 組織擁有者      | 不能關閉                                                                                                                                                |

## 客服轉真人 <a href="#handoff-emails" id="handoff-emails"></a>

| 信件     | 什麼時候寄                         | 寄給誰                | 能不能關閉、在哪裡設定                                                                                                                                                                                                         |
| ------ | ----------------------------- | ------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| 轉真人通知信 | 轉真人的對話**指派給客服專員**時（含轉接給另一位專員） | 被指派的專員，副本給設定的成員與群組 | 可以。對話平台的 <mark style="color:blue;">客服轉真人設定</mark> → <mark style="color:blue;">通知</mark> → <mark style="color:blue;">Email 通知</mark>，見 [轉真人客服通知](/build/conversation-settings/human-handoff/handoff-notification.md) |

轉真人通知信要**三個條件同時成立**才會寄，詳見 [容易誤會的寄信規則](#common-misunderstandings)。

## MaiGPT 連接器與工具 <a href="#connector-and-tool-emails" id="connector-and-tool-emails"></a>

| 信件           | 什麼時候寄                                                                                     | 寄給誰                             | 能不能關閉、在哪裡設定                                                          |
| ------------ | ----------------------------------------------------------------------------------------- | ------------------------------- | -------------------------------------------------------------------- |
| 連接器申請信       | 成員在 MaiGPT 對組織未啟用的連接器按 <mark style="color:blue;">申請啟用</mark>，或申請把已啟用的連接器加到自己的角色。同一筆申請只寄一次 | 組織擁有者，以及有連接器管理權限的成員             | 不能關閉。處理方式見 [管理連接器（管理員）](/work/maigpt/connectors/connectors-admin.md) |
| MCP 工具需要重新授權 | 組織共用的 MCP 工具授權失效、執行時被外部服務拒絕。同一次失效只通知一次，恢復後再失效才會再寄                                         | 能管理該工具、而且看得到該工具的成員              | 組織後台不能關閉。重新授權見 [建立 MCP 工具](/build/tools/mcp-setup.md)                |
| 排程略過了授權失效的工具 | [代理排程](/build/agent/schedule.md) 執行時，因為工具授權失效而略過了該工具。同一個排程的同一個工具 7 天內只寄一次                 | 排程的建立者；建立者已不在組織時，改寄給能重新授權該工具的成員 | 不能關閉。重新授權工具，或停用排程、從 Agent 移除該工具後就不會再寄                                |

## 方案、Credits 與額度 <a href="#billing-and-credit-emails" id="billing-and-credit-emails"></a>

| 信件             | 什麼時候寄                                                   | 寄給誰                  | 能不能關閉、在哪裡設定                                                                                                                                                                                                   |
| -------------- | ------------------------------------------------------- | -------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| 點數餘額不足提醒       | 組織的 Credits 餘額低於提醒門檻。24 小時內不重複寄                         | 組織擁有者，以及餘額提醒設定的通知收件人 | 可以。<mark style="color:blue;">餘額提醒</mark> 的 <mark style="color:blue;">啟用餘額提醒</mark>（預設開啟），見 [餘額不足提醒](/others/credits.md#low-balance-alert)。**只有付費方案的組織會收到 Email**，見下方說明                                        |
| 個人額度即將用罄       | 成員的個人額度用到提醒門檻（預設 80%）。每一期額度只寄一次                         | 該成員本人                | 可以，**預設關閉**。<mark style="color:blue;">成員額度</mark> 的 <mark style="color:blue;">提醒設定</mark> → <mark style="color:blue;">啟用個人額度提醒</mark>，見 [個人額度提醒設定](/others/credits/member-credit-quota.md#member-quota-alert) |
| 個人額度即將到期       | 每天上午 9 點檢查，個人額度在設定的天數內（預設 7 天）到期                        | 該成員本人                | 同上，與「即將用罄」共用同一個開關                                                                                                                                                                                             |
| 方案已排定          | MaiAgent 為組織排定一個未來才生效的方案                                | 組織擁有者                | 組織後台沒有開關，是否寄送由 MaiAgent 平台統一設定                                                                                                                                                                                |
| 方案已生效          | 方案開始生效，例如排定的方案到了生效日、試用轉為正式方案、續約。同時發放 Credits 時，信中附上入帳金額 | 組織擁有者                | 同上                                                                                                                                                                                                            |
| 本月 Credits 已發放 | 方案的每月 Credits 在發放日入帳                                    | 組織擁有者                | 同上                                                                                                                                                                                                            |
| Credits 已加值入帳  | Credits 加值入帳，包括 MaiAgent 為組織補發的 Credits                 | 組織擁有者                | 同上                                                                                                                                                                                                            |

## 資料保留 <a href="#data-retention-emails" id="data-retention-emails"></a>

| 信件       | 什麼時候寄                                                  | 寄給誰   | 能不能關閉、在哪裡設定                                                                     |
| -------- | ------------------------------------------------------ | ----- | ------------------------------------------------------------------------------- |
| 資料即將永久清除 | 組織沒有有效的付費方案、進入資料保留期後，在距離清除剩 **89、60、30、14、7、1 天**時各寄一次 | 組織擁有者 | 不能關閉。保留期與如何避免資料被清除，見 [資料保留政策](/others/trial-and-plans.md#data-retention-policy) |

## 容易誤會的寄信規則 <a href="#common-misunderstandings" id="common-misunderstandings"></a>

### 點數餘額不足提醒，只有付費方案會收到 Email <a href="#low-balance-paid-only" id="low-balance-paid-only"></a>

餘額低於門檻時，所有組織都會在 [通知中心](/start/notifications.md) 收到 <mark style="color:blue;">點數餘額不足提醒</mark>，但 **Email 只寄給有付費方案的組織**。免費方案或還沒有方案的組織，即使開啟了 <mark style="color:blue;">啟用餘額提醒</mark>、填了通知收件人，也只會看到站內通知。透過 AWS Marketplace 訂閱的組織由 Marketplace 計費，不會收到這項提醒。

### 已有帳號的人被加入組織時，不會收到信 <a href="#existing-account-no-email" id="existing-account-no-email"></a>

對方的 Email 已經註冊過 MaiAgent 時，以下方式都會**直接把他加入組織，不寄任何信**，也不會發站內通知：

* 用 Email 邀請成員
* 用 Excel 批次新增成員（只有名單中新建立的帳號會收到設定密碼信）
* 透過 LDAP 或 SCIM 同步成員

對方登入後可在左上角切換到新組織。需要通知對方時，請另外告知。

### 轉真人通知信要三個條件同時成立 <a href="#handoff-email-conditions" id="handoff-email-conditions"></a>

| 條件                                                   | 預設 | 在哪裡設定                                                                          |
| ---------------------------------------------------- | -- | ------------------------------------------------------------------------------ |
| 對話平台已開啟 <mark style="color:blue;">啟用真人客服轉接</mark>    | 關閉 | 對話平台的 <mark style="color:blue;">客服轉真人設定</mark>                                 |
| 該對話平台的 <mark style="color:blue;">Email 通知</mark> 已開啟 | 開啟 | <mark style="color:blue;">客服轉真人設定</mark> → <mark style="color:blue;">通知</mark> |
| 組織可使用轉真人通知                                           | 開啟 | 由 MaiAgent 平台設定，組織後台沒有開關                                                       |

而且只有對話**指派給客服專員**時才寄；AI 判定轉真人但還沒有人接手、對話轉回 AI、排隊逾時時都不寄 Email（這些事件可以用 [Webhook 通知](/build/conversation-settings/human-handoff/handoff-notification.md) 送到外部系統）。前兩項都開啟、對話也已指派，仍然沒有收到信時，請聯絡 MaiAgent。

### 這些事件不會寄信 <a href="#events-without-email" id="events-without-email"></a>

以下事件只在 [通知中心](/start/notifications.md) 出現，不寄 Email：Credits 即將到期、付款失敗、自動加值失敗、連接器已啟用（通知當初申請的成員）、成員被移出組織。

## 站內通知與 Email 對照 <a href="#in-app-vs-email" id="in-app-vs-email"></a>

| 通知中心的通知                                                                                                                                                             | 同時寄 Email？                                                                                         |
| ------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------- |
| <mark style="color:blue;">轉真人通知</mark>                                                                                                                              | 依 <mark style="color:blue;">Email 通知</mark> 開關；站內通知另由 <mark style="color:blue;">通知中心公告</mark> 開關控制 |
| <mark style="color:blue;">個人額度即將用罄</mark>、<mark style="color:blue;">個人額度即將到期</mark>                                                                                 | 會                                                                                                  |
| <mark style="color:blue;">點數餘額不足提醒</mark>                                                                                                                           | 只有付費方案的組織會                                                                                         |
| <mark style="color:blue;">資料保留警告</mark>                                                                                                                             | 只在剩 89、60、30、14、7、1 天時寄；其他天只有站內通知                                                                  |
| MCP 工具需要重新授權                                                                                                                                                        | 會                                                                                                  |
| <mark style="color:blue;">Credits 即將到期</mark>、<mark style="color:blue;">付款失敗</mark>、<mark style="color:blue;">自動加值失敗</mark>、<mark style="color:blue;">連接器已啟用</mark> | 不會                                                                                                 |

## 常見問題 <a href="#faq" id="faq"></a>

### 應該收到信卻沒收到？ <a href="#faq-not-received" id="faq-not-received"></a>

依序確認：先查垃圾郵件匣；對照本頁該信件的開關與條件是否都成立；邀請信可在 <mark style="color:blue;">邀請狀態</mark> 看是否顯示 <mark style="color:blue;">信件寄送失敗</mark>。私有雲與地端部署要先由系統管理員設定寄信，見技術人員手冊的 [邀請信與通知信的寄送設定](https://docs.maiagent.ai/tech/platform-development/onprem-operations#email-and-register-url)。

### 可以讓某位成員不要收到信嗎？ <a href="#faq-opt-out" id="faq-opt-out"></a>

目前沒有個人層級的退訂設定。能關閉的信件都是以組織或對話平台為單位，見上方各表的「能不能關閉」欄；轉真人通知的副本對象、餘額提醒的通知收件人可以在各自的設定中調整。

## 延伸閱讀 <a href="#further-reading" id="further-reading"></a>

* [通知中心](/start/notifications.md)
* [轉真人客服通知](/build/conversation-settings/human-handoff/handoff-notification.md)
* [Credits 計費制度](/others/credits.md)
* [成員 Credits 額度管理](/others/credits/member-credit-quota.md)
* [管理連接器（管理員）](/work/maigpt/connectors/connectors-admin.md)


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.maiagent.ai/start/system-emails.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
