본인의 Mailgun 계정을 통해 이메일 보내기

Mailgun 계정과 도메인의 DNS 접근 권한이 필요합니다.

Mailgun 공식 설명서: 도메인 추가 및 확인 · API 키 · 회원가입

1. Mailgun에 발송 도메인 추가

Mailgun 대시보드에서 Send → Domains → Add New Domain으로 이동하여 서브도메인(예: mail.yourdomain.com)을 입력하십시오.

⚠️ Mailgun 공식 지침에서도 서브도메인 사용을 권장하며, 이는 다른 일부 제공업체보다 여기서 더욱 중요합니다. Mailgun은 사용자가 입력한 도메인에 자체 SPF 및 DKIM 레코드를 설정하므로, 이를 루트 도메인으로 지정하면 해당 레코드들이 비즈니스 편지함이 의존하는 기존 레코드와 섞이게 됩니다.

데이터가 보관될 위치에 부합하는 리전(US 또는 EU)을 선택하십시오. 4단계에서 필요하며 가장 흔하게 실수하는 항목이므로 반드시 메모해 두십시오.

2. Mailgun에서 제공하는 DNS 레코드 게시

Mailgun에 목록이 표시됩니다. DNS 제공업체에서 해당 목록의 모든 항목을 추가하십시오.

⛔ 발송 서브도메인에 이미 SPF 레코드가 있다면 추가하지 말고 기존 레코드를 수정하십시오. 두 개의 SPF TXT 레코드를 보유한 도메인은 SPF 인증에 완전히 실패하며, 이는 레코드가 아예 없는 것보다 더 나쁩니다.

그런 다음 Mailgun에서 Verify DNS Settings를 누르십시오. 녹색으로 전환되기까지 최대 1시간이 걸릴 수 있습니다.

⭐ 발송 전용으로만 사용하더라도 MX 레코드를 추가하십시오. 이 레코드는 Mailgun이 반송을 수집하는 방식입니다. 이 레코드가 없으면 잘못된 주소로 보낸 메일이 반송될 곳이 없어 Mailgun이 해당 주소를 제외 목록에 추가할 수 없게 되며, 결국 수신되지도 않을 주소로 메일을 발송하면서 요금을 계속 지불하게 됩니다.

3. API 키 받기

Send → Sending → Domain settings → API keys 또는 계정의 API Keys 페이지로 이동하십시오.

이용 중인 요금제에서 지원하는 경우, 계정의 비공개 API 키 대신 이 도메인으로 범위가 한정된 발송 키를 사용하십시오. 발송 키는 발송만 가능하지만 비공개 키는 로그를 읽고 계정을 수정할 수 있습니다. 당사가 후자의 키를 보관해야 할 이유는 없습니다.

4. Zinn®에서 연결

대시보드에서 이메일 발송을 열고 다음 항목을 입력하십시오.

• 제공업체 — Mailgun
• 이 도메인에서 발송 — mail.yourdomain.com (주소가 아닌 도메인)
• Mailgun 발송 도메인 — Mailgun에 추가한 도메인과 동일한 도메인
• 리전 — 1단계와 일치하는 us 또는 eu
• Mailgun API 키 — 3단계의 키

⛔⛔ 리전을 정확하게 설정하십시오. EU 호스팅 Mailgun 계정은 완전히 다른 API 호스트에서 제공됩니다. EU 계정의 키를 US 호스트로 전송하면 잘못된 키를 입력했을 때와 똑같이 "401 Unauthorized"가 반환됩니다. 키가 확실히 맞는데 401 오류가 발생한다면 거의 항상 이것이 원인입니다.

5. 테스트 발송 및 코드 입력

다른 도메인의 편지함(Gmail 주소가 가장 이상적임)을 사용하여 테스트 메시지 발송을 누르십시오. 해당 편지함에서 코드를 확인하여 입력하십시오. 메일이 즉시 전환됩니다.

정상적으로 작동하지 않는 경우

401 Unauthorized — 리전이 잘못되었거나(위 내용 참조) 다른 Mailgun 계정의 키를 붙여넣었습니다. 키를 직접 다시 입력하기보다는 재생성하십시오. 앞부분의 key-를 빠뜨리기 쉽습니다.

테스트 메시지가 도착하지 않음 — Mailgun의 Logs 페이지를 확인하십시오. Mailgun에 기록이 전혀 없다면 자격 증명이나 도메인 이름이 잘못된 것입니다. Mailgun이 수락한 후 실패했다면 명확한 설명과 함께 사유가 표시되며, 이는 거의 항상 DNS 문제입니다.

"Domain not found" — Mailgun 발송 도메인 필드는 서브도메인을 포함하여 Mailgun에 표시된 도메인과 정확히 일치해야 합니다. Mailgun에서 yourdomain.com과 mail.yourdomain.com은 서로 다른 도메인입니다.

작동하다가 중단됨 — 무료 체험이 종료되었는지 확인하십시오. Mailgun 체험 계정은 승인된 수신자에게만 발송할 수 있으므로, 본인 주소로 보내는 테스트 메시지는 계속 작동하지만 고객에게 보내는 모든 메일은 아무런 알림 없이 전송되지 않습니다.