> ## Documentation Index
> Fetch the complete documentation index at: https://docs.agencyhandy.com/llms.txt
> Use this file to discover all available pages before exploring further.
# 발신 이메일, SMTP 및 이메일 템플릿 설정
> AgencyHandy에서 사용자 지정 발신자 이메일 주소 설정, SMTP 서버 연결, 전달 가능성을 위한 DKIM/SPF 레코드 추가, 이메일 템플릿 맞춤화하는 방법을 안내합니다.
AgencyHandy의 이메일 설정을 통해 기본 `noreply@agencyhandy.com` 발신자를 귀사의 브랜드 이메일 주소로 교체하고, 안정적인 전송을 위한 전용 SMTP 서버를 설정하며, 클라이언트 알림, 청구서, 제안서 등에 사용되는 템플릿을 맞춤화할 수 있습니다. 이 설정을 올바르게 구성하면 이메일이 스팸 폴더가 아닌 클라이언트의 받은 편지함에 도달하고, 모든 메시지가 귀사의 에이전시 정체성을 반영하도록 보장됩니다.
**최고 관리자(Super Admin)** 및 **관리자(Admin)** 만 이메일 설정을 구성할 수 있습니다. **워크스페이스 설정 → 이메일 설정**으로 이동하여 이 옵션에 접근하세요.
***
## 이메일 설정 구성 요소 개요
클라이언트가 워크스페이스에서 메시지를 받을 때 표시되는 발신자 이름과 이메일 주소를 설정하세요.
이메일이 합법적임을 증명하고 스팸으로 표시되는 것을 방지하기 위해 DNS 인증 레코드를 추가하세요.
AgencyHandy에서 발송되는 모든 이메일을 귀사의 메일 서버(예: Gmail, Outlook 또는 사용자 지정 도메인 서버)를 통해 전송하도록 연결하세요.
AgencyHandy가 클라이언트에게 발송하는 모든 자동화 이메일의 내용, 제목줄 및 브랜딩을 맞춤화하세요.
***
## 1부: 사용자 지정 이메일 주소 설정
발신자 이메일을 설정하기 전에 이메일 호스팅이 포함된 등록 도메인이 필요합니다. 인기 있는 제공업체로는 Google Workspace, Microsoft 365, Zoho Mail, Cloudflare Email Routing 등이 있습니다.
아직 완료하지 않은 경우, 도메인 등록 기관(예: GoDaddy, Namecheap, Cloudflare)에서 도메인을 등록하고 이메일 호스팅 제공업체에 가입하세요. 해당 도메인에서 이메일 주소를 생성하고 관리할 수 있는지 확인하세요(예: `hello@youragency.com`).
AgencyHandy에 로그인하세요. 왼쪽 탐색 메뉴에서 **워크스페이스 설정**으로 이동한 후 **이메일 설정**을 클릭하세요.
**발신자 이름** 필드에 클라이언트가 발신자로 볼 이름(예: `AgencyHandy Support` 또는 에이전시 이름)을 입력하세요. **발신자 이메일** 필드에 사용자 지정 이메일 주소(예: `hello@youragency.com`)를 입력하세요. **저장**을 클릭하세요.
AgencyHandy가 입력한 이메일 주소로 인증 링크를 발송합니다. 이메일 받은 편지함을 열어 인증 메시지를 찾고 링크를 클릭하여 소유권을 확인하세요.
발신자 이메일을 저장한 후 AgencyHandy에서 추가해야 할 DNS 레코드를 제공합니다:
* **SPF 레코드** (TXT 유형) — AgencyHandy가 귀사 도메인을 대신하여 이메일을 발송할 수 있도록 승인합니다.
* **DKIM 레코드** (CNAME 레코드 3개) — 수신 서버가 진위성을 검증할 수 있도록 발신 이메일에 암호화 서명을 추가합니다.
* **DMARC 레코드** — 인증 검사에 실패한 이메일을 수신 서버가 처리하는 방식을 정의합니다.
이 모든 레코드를 도메인 등록 기관의 DNS 설정에 추가하세요. DKIM CNAME 레코드의 경우, Cloudflare를 사용한다면 **프록시 상태를 비활성화**해야 합니다.
AgencyHandy의 이메일 설정 페이지로 돌아오세요. 모든 DNS 레코드가 전파되면(2분에서 최대 2시간 소요), 이메일 상태가 **대기 중**에서 녹색 체크마크 ✅로 업데이트됩니다. 이제 사용자 지정 이메일이 활성화되었습니다.
[MXToolbox](https://mxtoolbox.com/DKIM.aspx) 또는 [dmarcian의 DKIM 검사기](https://dmarcian.com/dkim-validator/)를 사용하여 DKIM 레코드가 올바르게 구성되었는지 확인하세요. 전파를 기다리는 동안 주기적으로 이메일 설정 페이지를 새로 고침하세요.
***
## 2부: DKIM 및 SPF 설정 (독립 설정)
DKIM 및 SPF 레코드를 독립적으로 생성하거나 재생성해야 하는 경우 다음 경로를 따르세요:
**워크스페이스 설정 → 이메일 → DKIM 및 SPF 설정 → DKIM 및 SPF 레코드 생성.**
그런 다음 DNS에 레코드를 추가하세요:
| 레코드 유형 | DNS 유형 | 설정 내용 |
| --------- | ------ | -------------------------------------------------------- |
| SPF | TXT | AgencyHandy에서 **이름** 및 **값**을 복사하여 DNS에 새 TXT 레코드를 추가하세요 |
| DKIM (×3) | CNAME | 각 **이름** 및 **값** 쌍을 복사하고 프록시를 비활성화하여 CNAME 레코드 3개를 추가하세요 |
DKIM 및 SPF 레코드 전파는 **2분에서 최대 2시간**이 소요될 수 있습니다. 2시간 후에도 상태가 대기 중으로 표시되면, 레코드가 오타 없이 입력되었는지와 충돌하는 레코드가 없는지 확인하세요.
***
## 3부: SMTP 설정
SMTP(Simple Mail Transfer Protocol)를 사용하면 AgencyHandy에서 발송되는 모든 이메일을 귀사의 인증된 메일 서버를 통해 라우팅하여 전달 가능성과 브랜딩에 대한 더 많은 제어권을 가질 수 있습니다.
**사용자 지정 도메인 이메일** 또는 **SMTP 이메일 제공업체** 중 하나만 사용할 수 있으며 동시에 사용할 수 없습니다. 언제든지 전환이 가능하지만, 사용자 지정 이메일로 다시 전환할 때는 이메일 설정을 재입력해야 합니다.
**워크스페이스 설정 → 이메일 설정**으로 이동한 후 **SMTP 서버**를 클릭하세요.
이미 사용자 지정 이메일이 설정된 경우, 전환 여부를 묻는 확인 팝업이 표시됩니다. **SMTP로 전환**을 클릭하여 계속 진행하세요. 이렇게 하면 기존 사용자 지정 이메일 설정이 비활성화됩니다.
필수 필드를 채우세요:
| 필드 | 예시 값 | 비고 |
| ------ | -------------------- | ------------------------ |
| 호스트 이름 | `smtp.gmail.com` | 이메일 제공업체의 SMTP 서버 주소 |
| 사용자 이름 | `you@yourdomain.com` | 전체 이메일 주소 |
| 비밀번호 | 앱 비밀번호 | 앱별 비밀번호 사용 (아래 참조) |
| 포트 | `465` 또는 `587` | SSL은 465, TLS는 587 |
| 자동 TLS | 켜기/끄기 | 선택 사항 — 자동 TLS 업그레이드 활성화 |
완료되면 **저장**을 클릭하세요.
2단계 인증이 활성화된 Gmail을 사용하는 경우(앱 비밀번호 필수):
1. [myaccount.google.com/security](https://myaccount.google.com/security)로 이동하여 2단계 인증이 활성화되어 있는지 확인하세요.
2. [myaccount.google.com/apppasswords](https://myaccount.google.com/apppasswords)를 방문하세요.
3. **앱 선택**을 클릭하고 **메일**을 선택하거나 사용자 지정 이름을 입력한 후, **기기 선택**을 클릭하여 설정을 선택하세요.
4. **생성**을 클릭하면 Google에서 16자 앱 비밀번호를 생성합니다.
5. 비밀번호를 복사하여 AgencyHandy의 SMTP 설정에서 **비밀번호** 필드에 붙여넣으세요.
일반 Google 계정 비밀번호가 아닌 **앱 비밀번호**를 사용하세요. 2단계 인증이 활성화된 경우 일반 비밀번호를 사용하면 실패하고 보안 경고가 발생할 수 있습니다.
저장 후, AgencyHandy가 *"SMTP가 성공적으로 생성되었습니다."* 라는 성공 메시지를 표시합니다. 저장된 호스트, 사용자 이름 및 포트 세부 정보가 SMTP 설정 페이지에 표시됩니다.
**테스트** 버튼을 클릭하고 수신자 이메일 주소를 입력하세요. AgencyHandy가 해당 주소로 테스트 이메일을 발송합니다. 받은 편지함에서 확인 메시지를 확인하세요: *"이것은 Agency Handy에서의 이메일 설정이 올바르게 작동하고 있음을 확인하는 메시지입니다."*
워크스페이스당 하나의 SMTP 설정만 활성화할 수 있습니다. SMTP가 구성되면 AgencyHandy에서 발송되는 모든 이메일(청구서, 제안서, 작업 알림)이 귀사의 SMTP 서버를 통해 전송됩니다.
***
## 4부: 이메일 템플릿 맞춤화
AgencyHandy에는 발송하는 모든 자동화 이메일에 대한 사전 제작된 템플릿이 포함되어 있습니다. 각 템플릿을 브랜드 톤에 맞게 맞춤화하고 관련 동적 콘텐츠를 포함할 수 있습니다.
**사용 가능한 템플릿:**
* 클라이언트 회원가입
* 제안서 발송
* 작업 검토
* 청구서 발송
* 청구서 및 구독 알림
* 티켓 생성 알림
**워크스페이스 설정 → 이메일**로 이동한 후, 하위 메뉴에서 **이메일 템플릿**을 선택하세요.
사용 가능한 모든 템플릿 목록이 표시됩니다. 아무 템플릿이나 클릭하여 설정 페이지를 여세요.
필요에 따라 다음을 업데이트하세요:
* **발신자 이메일:** 이 템플릿을 발송할 설정된 이메일 주소를 선택하세요.
* **제목:** 명확하고 간결한 제목줄을 작성하세요.
* **본문:** 에이전시의 톤과 메시지에 맞게 메시지 내용을 편집하세요.
* **동적 변수:** `{{client_name}}`, `{{company_name}}`, `{{invoice_id}}` 등의 자리 표시자를 삽입하여 클라이언트별 데이터를 자동으로 채우세요.
* **소셜 미디어 링크:** 에이전시의 소셜 프로필 링크를 추가하여 참여를 유도하세요.
**테스트 발송**을 클릭하여 템플릿 미리보기를 받은 편지함으로 보내세요. 형식, 내용, 그리고 모든 동적 변수가 올바르게 처리되는지 확인하세요.
**변경 사항 저장**을 클릭하여 업데이트된 템플릿을 적용하세요. 새 버전은 해당 템플릿 유형과 일치하는 향후 모든 자동화 이메일에 사용됩니다.
***
## 중요 참고 사항
* **SMTP와 사용자 지정 이메일은 상호 배타적입니다.** 워크스페이스당 한 번에 하나의 방법만 활성화할 수 있습니다.
* **전환 시 이메일 재입력이 필요합니다.** SMTP에서 사용자 지정 이메일 설정으로 다시 전환하는 경우, 사용자 지정 이메일 자격 증명을 재입력해야 합니다.
* **잘못된 SMTP 자격 증명은 모든 발신 이메일을 차단합니다.** SMTP 변경 후 이메일 발송이 중단된 경우 호스트 이름, 포트, 사용자 이름 및 비밀번호를 다시 확인하세요.
* **DKIM/SPF 전파에는 시간이 소요됩니다.** 오류가 있다고 결론 내리기 전에 최대 2시간을 기다리고 이메일 설정 페이지를 새로 고침하세요.
* **동적 변수는 대소문자를 구분합니다.** 올바르게 채워지도록 템플릿 편집기에 표시된 대로 정확하게 사용하세요.