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

# Mailgun 설정

> 이메일 메시지를 보내기 위해 OneSignal과 Mailgun을 설정하는 단계별 가이드입니다. DNS 확인, SMTP 자격 증명 설정, API 키 생성 및 OneSignal 통합 지침이 포함되어 있습니다.

<Warning>
  이 설정 가이드는 이미 Mailgun이 있고 OneSignal과 통합하려는 경우를 위한 것입니다. Mailgun 계정이 없는 경우 [OneSignal Email](./email-setup)을 대신 사용할 수 있습니다.
</Warning>

## 요구사항

* [Mailgun 계정](https://www.mailgun.com)
* Mailgun **US** API (EU 리전은 지원되지 않음)
* [OneSignal 계정](https://onesignal.com)
* 소유한 도메인 및 DNS 제공업체에 대한 액세스

***

## 설정

### 1. Mailgun에 새 도메인 추가

도메인이 이미 US 리전에 설정되어 있는 경우 이 단계를 건너뛰세요.

1. Mailgun 대시보드에서 **도메인** 페이지로 이동합니다.

<Frame caption="도메인 페이지로 이동">
  <img src="https://mintcdn.com/onesignal/MUgio66t0sYhGEvj/images/docs/6e14df8-01_-_Navigate_to_sending_domains.png?fit=max&auto=format&n=MUgio66t0sYhGEvj&q=85&s=542d06f8870b8e98cdb276d475cb2d99" width="1328" height="1124" data-path="images/docs/6e14df8-01_-_Navigate_to_sending_domains.png" />
</Frame>

2. **새 도메인 추가**를 클릭합니다.

<Frame caption="새 도메인 추가 양식 열기">
  <img src="https://mintcdn.com/onesignal/_KaXe4GQkxsEfa17/images/docs/403bd98-01.2_-_Click_Add_new_domain_button.png?fit=max&auto=format&n=_KaXe4GQkxsEfa17&q=85&s=d0d94e8e010730d7f80fb782f0bf3557" width="1328" height="1124" data-path="images/docs/403bd98-01.2_-_Click_Add_new_domain_button.png" />
</Frame>

3. 하위 도메인(예: `mail.yourdomain.com`)을 입력하고 리전이 **US**인지 확인합니다.

<Frame caption="하위 도메인 지정 및 US 리전 선택">
  <img src="https://mintcdn.com/onesignal/RWtLFPeffHrC81wI/images/docs/ad8dca5-01.3_-_Add_new_domain.png?fit=max&auto=format&n=RWtLFPeffHrC81wI&q=85&s=fa477b2191c6b916fb4e16a9bf457161" width="1328" height="1124" data-path="images/docs/ad8dca5-01.3_-_Add_new_domain.png" />
</Frame>

### 2. DNS 설정 확인

Mailgun은 다음 DNS 레코드를 제공합니다:

* 2개의 **TXT** (SPF 및 DKIM)
* 2개의 **MX**
* 1개의 **CNAME**

DNS 제공업체에서 이를 업데이트하세요. 전파에는 최대 48시간이 걸릴 수 있습니다. 확인되면 Mailgun이 이메일로 알려줍니다.

확인하려면:

* **Mailgun > 전송 > 도메인 설정 > 귀하의 도메인 > DNS 레코드**로 이동
* 각 레코드 옆의 녹색 체크 마크를 찾으세요

<Frame caption="DNS 설정 확인">
  <img src="https://mintcdn.com/onesignal/Z6xkXGfmy814If53/images/docs/ddbf617-01.5_-_Verified_DNS_settings.png?fit=max&auto=format&n=Z6xkXGfmy814If53&q=85&s=26bd8596b9ac4b96089b8225c00fa94d" width="1328" height="1124" data-path="images/docs/ddbf617-01.5_-_Verified_DNS_settings.png" />
</Frame>

<Info>
  CNAME이 올바르게 설정되지 않으면 이메일 클릭, 열람 및 구독 취소 추적이 작동하지 않습니다.
</Info>

***

### 3. SMTP 자격 증명 설정

1. Mailgun에서 **전송 > 도메인 설정 > SMTP 자격 증명**으로 이동합니다.

<Frame caption="SMTP 자격 증명으로 이동">
  <img src="https://mintcdn.com/onesignal/tc0EvmtSSX56SX0c/images/docs/963d676-02_-_Add_SMTP_creds.png?fit=max&auto=format&n=tc0EvmtSSX56SX0c&q=85&s=2cb892039a5cfee55aa25da01ae438e1" width="1328" height="1124" data-path="images/docs/963d676-02_-_Add_SMTP_creds.png" />
</Frame>

2. **새 SMTP 사용자 추가**를 클릭합니다.

<Frame caption="새 SMTP 자격 증명 추가">
  <img src="https://mintcdn.com/onesignal/56ctKxZSV4m5VEkn/images/docs/b2108d4-02.1_-_Click_Add_new_SMTP_user.png?fit=max&auto=format&n=56ctKxZSV4m5VEkn&q=85&s=79537c0dae456ed4320ad09647db4d87" width="1328" height="1124" data-path="images/docs/b2108d4-02.1_-_Click_Add_new_SMTP_user.png" />
</Frame>

3. 로그인 이름을 설정하고 자격 증명을 저장합니다.

<Frame caption="SMTP 사용자 생성">
  <img src="https://mintcdn.com/onesignal/9_Q1FZLh6C0BFLq-/images/docs/be7540c-03_-_New_SMTP_creds.png?fit=max&auto=format&n=9_Q1FZLh6C0BFLq-&q=85&s=53a10a727d7dbb9a8234332e50e3308e" width="1328" height="1124" data-path="images/docs/be7540c-03_-_New_SMTP_creds.png" />
</Frame>

4. **복사** 아이콘을 클릭하여 비밀번호를 안전하게 저장합니다.

<Frame caption="SMTP 비밀번호 복사">
  <img src="https://mintcdn.com/onesignal/RWtLFPeffHrC81wI/images/docs/ab32f9b-03.1_-_Copy_SMTP_user_pass.png?fit=max&auto=format&n=RWtLFPeffHrC81wI&q=85&s=51aeb4db620490e077f63465619e2711" width="1328" height="1124" data-path="images/docs/ab32f9b-03.1_-_Copy_SMTP_user_pass.png" />
</Frame>

### 4. Mailgun API 키 받기

1. Mailgun 대시보드에서 아래로 스크롤하여 **API 키**를 클릭합니다.

<Frame caption="API 키로 이동">
  <img src="https://mintcdn.com/onesignal/YOTSrtBSoqdrJ37A/images/docs/430314e-42fc46d-step-1-50.png?fit=max&auto=format&n=YOTSrtBSoqdrJ37A&q=85&s=f80af7cfcfe4be2d94418b6f15448097" width="1616" height="1365" data-path="images/docs/430314e-42fc46d-step-1-50.png" />
</Frame>

2. **새 키 추가**를 클릭합니다.

<Frame caption="새 키 추가">
  <img src="https://mintcdn.com/onesignal/MUgio66t0sYhGEvj/images/docs/6390d56-93a49a5-step-2-50.png?fit=max&auto=format&n=MUgio66t0sYhGEvj&q=85&s=45c91e47914b90b577388c8c26fc9538" width="1616" height="1365" data-path="images/docs/6390d56-93a49a5-step-2-50.png" />
</Frame>

3. 키 이름을 지정하고 **키 생성**을 클릭합니다.

<Frame caption="키 생성">
  <img src="https://mintcdn.com/onesignal/6v_cVPknFpo5qSVB/images/docs/09dd33b-6faf199-step-3-50.png?fit=max&auto=format&n=6v_cVPknFpo5qSVB&q=85&s=87af7bad8fc8363e916e5673779a65ea" width="1616" height="1365" data-path="images/docs/09dd33b-6faf199-step-3-50.png" />
</Frame>

4. 생성된 API 키를 복사하여 안전하게 저장합니다.

<Frame caption="API 키 복사">
  <img src="https://mintcdn.com/onesignal/tNi1OgLc_p9hiq7_/images/docs/1350337-cb5aeba-step-4-50.png?fit=max&auto=format&n=tNi1OgLc_p9hiq7_&q=85&s=d4f1a03d0287b8c3169bda289b839cfa" width="1616" height="1365" data-path="images/docs/1350337-cb5aeba-step-4-50.png" />
</Frame>

***

### 5. OneSignal에서 Mailgun 구성

1. OneSignal에서 **설정 > 플랫폼 > 이메일**로 이동하고 **Mailgun**을 선택합니다.

<Frame caption="앱 설정 이메일">
  <img src="https://mintcdn.com/onesignal/tc0EvmtSSX56SX0c/images/docs/9341a6c-01_-_App_setup_email.png?fit=max&auto=format&n=tc0EvmtSSX56SX0c&q=85&s=2c645ab6c1107ed5bb1122aacff78d17" width="1328" height="1124" data-path="images/docs/9341a6c-01_-_App_setup_email.png" />
</Frame>

2. 제공업체로 **Mailgun**을 선택합니다.

<Frame caption="앱 설정 이메일">
  <img src="https://mintcdn.com/onesignal/YOTSrtBSoqdrJ37A/images/docs/4a2a57c-02_-_App_Setup_Email_Mailgun.png?fit=max&auto=format&n=YOTSrtBSoqdrJ37A&q=85&s=d7bcb86f6bc0d15df9b49a147d132959" width="1328" height="1124" data-path="images/docs/4a2a57c-02_-_App_Setup_Email_Mailgun.png" />
</Frame>

3. 다음을 입력합니다:

* [1단계](#1-add-a-new-domain-in-mailgun)의 도메인
* [3단계](#3-set-up-smtp-credentials)의 SMTP 자격 증명
* [4단계](#4-get-a-mailgun-api-key)의 API 키

<Frame caption="제공업체 구성">
  <img src="https://mintcdn.com/onesignal/6v_cVPknFpo5qSVB/images/docs/07c6b2f-03_-_Configure_provider.png?fit=max&auto=format&n=6v_cVPknFpo5qSVB&q=85&s=a3cb35435c5496d52c08135bed6c99d0" width="1328" height="1124" data-path="images/docs/07c6b2f-03_-_Configure_provider.png" />
</Frame>

4. 기본 발신자 이름과 `from` 이메일 주소를 설정합니다.

<Frame caption="추가 설정 구성">
  <img src="https://mintcdn.com/onesignal/6tscVAtiSqz353kV/images/docs/9e6af63-04_-_Configure_additional_settings.png?fit=max&auto=format&n=6tscVAtiSqz353kV&q=85&s=7c34b6e400662d67808226872626e1de" width="1328" height="1124" data-path="images/docs/9e6af63-04_-_Configure_additional_settings.png" />
</Frame>

### 6. Mailgun에 OneSignal 웹훅 추가

**Mailgun > 전송 > 웹훅 > 귀하의 도메인 > 웹훅**으로 이동하여 다음을 추가합니다:

```
https://onesignal.com/email/hooks/mailgun
```

<Frame caption="웹훅 추가">
  <img src="https://mintcdn.com/onesignal/Z6xkXGfmy814If53/images/docs/d81f4cc-Screenshot_2023-01-25_at_3.48.04_PM.png?fit=max&auto=format&n=Z6xkXGfmy814If53&q=85&s=30721d7d06a88cae8fc244577f767a89" width="1534" height="1212" data-path="images/docs/d81f4cc-Screenshot_2023-01-25_at_3.48.04_PM.png" />
</Frame>

### 7. 추적 프로토콜을 HTTPS로 변경

수신자가 안전한 URL로 연결되도록 합니다.

1. Mailgun에서 도메인 설정으로 이동합니다.
2. **추적 > 추적 프로토콜**에서 **HTTP**를 **HTTPS**로 변경합니다.

<Frame caption="추적 프로토콜 변경">
  <img src="https://mintcdn.com/onesignal/Xl2NHJvxakrK4JbL/images/docs/e79e542-Screenshot_2023-01-25_at_3.52.26_PM.png?fit=max&auto=format&n=Xl2NHJvxakrK4JbL&q=85&s=bfb73b54c1f4a81ae480cdfda0413966" width="2228" height="632" data-path="images/docs/e79e542-Screenshot_2023-01-25_at_3.52.26_PM.png" />
</Frame>

### 8. 테스트 이메일 보내기

1. **OneSignal > 메시지 > 이메일**로 이동하여 **새 이메일**을 클릭합니다.
2. 제목을 추가하고 **테스트 이메일 보내기**를 클릭한 다음 이메일을 입력하고 **테스트 메시지 보내기**를 클릭합니다.

<Frame caption="테스트 이메일 보내기">
  <img src="https://mintcdn.com/onesignal/YOTSrtBSoqdrJ37A/images/docs/46aaab5-Screen_Shot_2021-11-18_at_6.00.46_PM.png?fit=max&auto=format&n=YOTSrtBSoqdrJ37A&q=85&s=5d3969be38e8e9caea691fdb094a54c7" width="1806" height="598" data-path="images/docs/46aaab5-Screen_Shot_2021-11-18_at_6.00.46_PM.png" />
</Frame>

곧 테스트 이메일을 받게 됩니다.

***

## 문제 해결

[이메일 FAQ](./email-troubleshooting)를 참조하세요.

<Info>
  도움이 필요하신가요?

  지원 팀과 채팅하거나 `support@onesignal.com`으로 이메일을 보내주세요.

  다음을 포함해 주세요:

  * 발생한 문제의 세부 정보 및 재현 단계(가능한 경우)
  * OneSignal 앱 ID
  * External ID 또는 Subscription ID(해당하는 경우)
  * OneSignal 대시보드에서 테스트한 메시지의 URL(해당하는 경우)
  * 관련 [로그 또는 오류 메시지](/docs/ko/capturing-a-debug-log)

  기꺼이 도와드리겠습니다!
</Info>

***

<Check>
  이메일 설정 완료!
  **다음 단계:**

  * [이메일 설정 가이드](./email-setup)로 돌아가서 OneSignal 이메일 기능을 살펴보세요.
</Check>

***