> ## 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>**Delivery method**required</summary>

  **Resend** 或**自定义 SMTP**。默认为 **Resend**。更改它会替换其下方显示的提供商字段。
</details>

<details>
  <summary>**From email**required</summary>

  收件人看到的发件人地址。必须是您所控制域名上的有效邮箱地址。
</details>

<details>
  <summary>**API key**required</summary>

  *（仅限 Resend）* Resend 控制台“API Keys”下的 API 密钥。作为机密存储。
</details>

<details>
  <summary>**Host**required</summary>

  *（仅限 SMTP）* 邮件服务器的主机名。
</details>

<details>
  <summary>**Port**required`number`</summary>

  *（仅限 SMTP）* 服务器端口，1 到 65535 之间的整数。默认为 `587`。
</details>

<details>
  <summary>**Username**required</summary>

  *（仅限 SMTP）* Alforse 用于登录 SMTP 服务器的账号。
</details>

<details>
  <summary>**Password**required</summary>

  *（仅限 SMTP）* 该账号的密码。作为机密存储。
</details>

<details>
  <summary>**Use 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.