> ## Documentation Index
> Fetch the complete documentation index at: https://docs.alforse.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 電子郵件

> 連接 Resend 或你自己的 SMTP 伺服器，讓 Alforse 從你的網域寄送報價單、採購單、發票及其他交易郵件。

電子郵件整合控制 Alforse 如何為貴公司遞送其寄出的交易郵件，例如報價單、採購單與發票。管理員只需設定一次，之後每封寄出的郵件都會從你自己網域上的地址發出。

## 遞送方式

每家公司可在兩種遞送方式中擇一：

| 方式 | 說明 | 適用時機 |
| - | - | - |
| **Resend**（預設） | 具備網域驗證的託管郵件 API，透過你自己的 Resend 帳號使用。 | 你想使用託管的寄送服務，並且已有或可以建立 Resend 帳號。 |
| **自訂 SMTP** | 你自己的郵件伺服器。 | 貴組織已經運行 SMTP 中繼，或政策要求郵件必須經過它。 |

## 設定郵件遞送

### 開啟整合

前往**設定 → 整合 → 電子郵件**。

### 選擇遞送方式

在**遞送方式**下，選取 **Resend** 或**自訂 SMTP**。表單只會顯示屬於你所選方式的欄位。

### 輸入寄件者地址

填寫**寄件者電子郵件**。這是客戶與供應商看到的地址，因此必須是你所掌控網域上的有效電子郵件地址。

### 輸入提供者憑證

使用 **Resend** 時，貼上在 Resend 儀表板的 API Keys 下建立的 **API 金鑰**。使用**自訂 SMTP** 時，輸入**主機**、**連接埠**、**使用者名稱**與**密碼**，並讓**使用 TLS** 與你伺服器的連接埠相符（請參閱[選擇 TLS 設定](#choosing-the-tls-setting)）。

## 欄位參考

FieldType

<details>
  <summary>**遞送方式**required</summary>

  **Resend** 或**自訂 SMTP**。預設為 **Resend**。變更它會替換其下方顯示的提供者欄位。
</details>

<details>
  <summary>**寄件者電子郵件**required</summary>

  收件者看到的寄件者地址。必須是你所掌控網域上的有效電子郵件地址。
</details>

<details>
  <summary>**API 金鑰**required</summary>

  *（僅限 Resend）* 來自 Resend 儀表板 API Keys 下的 API 金鑰。以機密方式儲存。
</details>

<details>
  <summary>**主機**required</summary>

  *（僅限 SMTP）* 你郵件伺服器的主機名稱。
</details>

<details>
  <summary>**連接埠**required`number`</summary>

  *（僅限 SMTP）* 伺服器連接埠，為 1 到 65535 的整數。預設為 `587`。
</details>

<details>
  <summary>**使用者名稱**required</summary>

  *（僅限 SMTP）* Alforse 用來登入 SMTP 伺服器的帳號。
</details>

<details>
  <summary>**密碼**required</summary>

  *（僅限 SMTP）* 該帳號的密碼。以機密方式儲存。
</details>

<details>
  <summary>**使用 TLS**</summary>

  *（僅限 SMTP）* 一個開關，預設為關閉。開啟代表隱式 TLS；關閉代表 STARTTLS。
</details>

### 選擇 TLS 設定

**使用 TLS** 開關必須與你的伺服器期待的連線開始方式相符。無論哪種情況，連線都會在傳送憑證之前先加密。

| 你的伺服器連接埠 | **使用 TLS** | 連線類型 |
| - | - | - |
| 465 或 2465 | 開啟 | 隱式 TLS（SMTPS） |
| 25、587、2525 或 2587 | 關閉 | STARTTLS |

## 機密如何儲存

Resend 的 **API 金鑰**與 SMTP 的**密碼**是以機密方式儲存，而不是一般設定。當你編輯現有設定並將機密欄位留空時，Alforse 會保留它已持有的機密，因此你不必為了變更其他欄位而重新輸入。

## 疑難排解

| 症狀 | 原因 | 修正 |
| - | - | - |
| 「Host is required」（需要主機） | 已選取**自訂 SMTP**，但**主機**空白。 | 輸入你郵件伺服器的主機名稱。 |
| 「Port must be between 1 and 65535」（連接埠必須介於 1 到 65535） | **連接埠**為零、負數或大於 65535。 | 輸入你伺服器監聽的連接埠，例如 `587`。 |
| 「Username is required」（需要使用者名稱） | 已選取**自訂 SMTP**，但**使用者名稱**空白。 | 輸入 SMTP 帳號名稱。 |
| **寄件者電子郵件**被拒絕 | 該值不是有效的電子郵件地址。 | 輸入完整地址，例如 `orders@yourdomain.com`。 |
| 郵件未送達 SMTP 伺服器 | 通常是**使用 TLS** 與連接埠不相符。 | 連接埠 465 與 2465 請開啟**使用 TLS**；25、587、2525 與 2587 請關閉。 |

NOTE

你未選取的遞送方式所對應的欄位會保持隱藏，且不會被使用。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.