> ## 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**(Custom SMTP) | 자체 메일 서버입니다. | 조직에서 이미 SMTP 릴레이를 운영하고 있거나 정책상 메일이 해당 릴레이를 거쳐야 하는 경우 |

## 이메일 전달 설정

### 연동 열기

**설정 → 연동 → 이메일**로 이동합니다.

### 전달 방식 선택

**전달 방식**(Delivery method)에서 **Resend** 또는 **사용자 지정 SMTP**를 선택합니다. 양식에는 선택한 방식에 해당하는 필드만 표시됩니다.

### 발신자 주소 입력

**발신 이메일**(From email)을 입력합니다. 고객과 공급업체에 표시되는 주소이므로 사용자가 관리하는 도메인의 유효한 이메일 주소여야 합니다.

### 제공업체 자격 증명 입력

**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 사이여야 합니다) | **포트**가 0, 음수 또는 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.