> ## 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.
# 이메일 문제 해결
> 일반적인 OneSignal 이메일 문제를 진단하고 해결하는 방법.
이 가이드를 사용하여 설정 문제, 전달 가능성 문제 및 디자인 오류를 포함한 가장 일반적인 OneSignal 이메일 문제를 식별하고 해결하세요.
문제 해결을 시작하기 전에 [이메일 설정](./email-setup) 및 [이메일 전달 가능성](./email-deliverability) 가이드를 검토하세요. 이 가이드는 이메일 문제의 가장 일반적인 원인을 다룹니다.
## 설정 문제
대부분의 설정 문제는 잘못된 DNS 레코드 또는 이메일 서비스 제공업체(ESP)의 제한에서 발생합니다.
### DNS 레코드 확인
1. DNS 제공업체를 여세요.
2. SPF, DKIM 및 MX 레코드가 [이메일 DNS 구성](./email-dns-configuration) 가이드와 일치하는지 확인하세요.
3. DNS 변경 사항이 전파되는 데 최대 24시간을 허용하세요.
DNS 레코드가 잘못 구성되면 이메일이 전송되지 않거나 반송되거나 스팸으로 표시될 수 있습니다.
### 월별 전송 제한(OneSignal이 아닌 ESP)
SendGrid, Mailchimp 또는 Mailgun을 직접 사용하는 경우(OneSignal 이메일을 통하지 않음) 전송 볼륨은 ESP 플랜에 의해 제한됩니다.
제공업체의 로그를 확인하세요:
* [SendGrid Activity Feed](https://www.twilio.com/docs/sendgrid/ui/analytics-and-reporting/email-activity-feed)
* [Mailchimp Activity & Reports](https://mailchimp.com/developer/transactional/docs/activity-reports/)
* [Mailgun Logs](https://www.mailgun.com/products/send/email-analytics/logs/)
### DNS 조회 너무 많음
[URI test](https://www.uriports.com/tools?method=spf\&domain=mail.daystrom-institute.com)와 같은 도구로 SPF 레코드를 테스트할 때 다음과 같이 표시될 수 있습니다:
다음 SPF 레코드를 사용하는 경우 예상됩니다:
```
v=spf1 include:spf.onesignal.email include:mailgun.org ~all
```
OneSignal은 이메일 서비스 제공업체로 Mailgun을 "후드 아래에서" 사용합니다. 이는 SPF 조회가 동일한 IP 범위를 가리키며 실제로 추가 조회를 추가하지 않음을 의미합니다. 경고를 제거하려면 다음과 같이 단순화할 수 있습니다:
```
v=spf1 include:mailgun.org ~all
```
이렇게 하면 오류가 방지되고 OneSignal 이메일 전송에 영향을 미치지 않습니다.
### 발신자 도메인에 대한 여러 TXT 레코드
전송 도메인에 대해 **하나의** SPF 레코드만 가질 수 있습니다.
[WhatsMyDNS TXT lookup](https://www.whatsmydns.net/#TXT)으로 확인하여 여러 항목이 없는지 확인하세요.
***
## 전달 가능성 문제
전달 가능성 문제에는 느린 전송, 스팸 폴더 배치 및 이메일 반송이 포함됩니다.
### 지연된 이메일
전송 도메인이 새롭거나 평판이 낮은 경우 ISP(Gmail, Outlook, Yahoo)가 전달을 지연시킬 수 있습니다. 이를 **속도 제한** 또는 **그레이리스팅**이라고 합니다. [이메일 메시지 보고서](./email-message-reports)를 볼 때 메시지를 보내는 데 걸린 시간의 세부 정보를 확인할 수 있습니다.
이 예에서는 이메일이 3초 이내에 OneSignal에서 전송되었음을 알 수 있습니다. 이메일 서비스 제공업체로 보낸 다음 수신자의 ISP로 이동합니다. 이러한 이메일 서버는 수신자에게 전달되기 전에 최대 몇 시간 동안 이메일을 지연시킬 수 있습니다.
전달 속도를 높이려면 [이메일 평판 모범 사례](./email-reputation-best-practices)를 따르세요.
### 스팸으로 도착하는 이메일
가장 일반적인 원인은 발신자 평판이 좋지 않기 때문입니다. [이메일 전달 가능성](./email-deliverability) 가이드를 따르세요.
타사 ESP를 사용하는 경우 다음을 참조하세요:
* [SendGrid: Deny lists](https://docs.sendgrid.com/ui/sending-email/deny-lists)
* [Mailgun: Blacklist info](https://help.mailgun.com/hc/en-us/articles/115005365027-What-Is-a-Blacklist-)
* [Mailchimp: Reputation & rejections](https://mailchimp.com/developer/transactional/docs/reputation-rejections/#rejected-emails)
### 동일한 도메인에서 보내기 및 받기
단일 도메인은 메일을 동시에 보내고 받기 위해 동일한 MX 레코드를 사용할 수 없습니다. `@yourdomain.com`에서 **보내고** 동일한 도메인에서도 **받으려면**:
* OneSignal로 전송 DNS를 유지하세요.
* 인바운드 이메일 제공업체로 MX 레코드를 가리키세요(예: [Google Workspace MX records](https://support.google.com/a/topic/2683820?hl=en\&ref_topic=9202)).
### 억제 목록
주소가 구독을 취소하거나 스팸으로 표시한 경우 ESP는 해당 주소로의 전송을 억제합니다.
재구독하려면:
1. OneSignal에서 **Audience > Subscriptions**로 이동하세요.
2. 이메일 주소를 검색하세요.
3. **Unsubscribe from Email**을 클릭한 다음(구독된 경우) **Resubscribe to Email**을 클릭하세요.
4. 테스트 이메일을 보내 확인하세요.
### Apple 비공개 릴레이
`@privaterelay.appleid.com` 주소로 보내는 경우 [Apple 개발자 계정](https://developer.apple.com/help/account/configure-app-capabilities/configure-private-email-relay-service/)에서 전송 도메인을 확인해야 합니다.
확인되지 않은 도메인은 삭제된 이메일로 이어집니다.
### API 키가 너무 제한적임
SendGrid 또는 Mailchimp를 사용하는 경우 API 키에 [최소 필수 권한](./sendgrid-setup#what-are-the-minimum-api-restrictions-i-can-allow)이 있는지 확인하세요.
***
## 이메일 디자인
이메일 콘텐츠 자체의 문제입니다.
### 링크가 작동하지 않음
일반적으로 CNAME 구성이 누락되거나 잘못되어 발생합니다.
타사 ESP를 사용하는 경우 추적 도메인 설정을 따르세요.
### 버튼을 클릭할 수 없음
* URL이 올바르고 `https://`로 시작하는지 확인하세요.
* 스팸 폴더에서 테스트하지 마세요. 일부 이메일 클라이언트는 거기에서 링크를 차단합니다.
### 프리헤더에 이미지 추가
Gmail은 프리헤더의 프로모션 이미지(거래 주석, 제품 캐러셀)를 지원합니다.
설정은 [Gmail Developer Portal](https://developers.google.com/gmail/promotab/overview)을 참조하세요.
***
## 이메일 서비스 제공업체(ESP)
SendGrid, Mailchimp 또는 Mailgun과의 통합 사용과 관련된 일반적인 질문 또는 문제입니다.
### 이메일을 위해 다른 제공업체에 비용을 지불해야 하나요?
[OneSignal 이메일 설정](./email-setup)을 사용하면 이메일 계정을 관리하므로 다른 이메일 제공업체를 사용할 필요가 없습니다. Sendgrid, Mailchimp 또는 Mailgun을 사용하려는 경우 이메일 서비스 제공업체에 직접 계속 비용을 지불해야 합니다.
## OneSignal의 이메일 처리량은 얼마나 되나요?
OneSignal은 일반적으로 이메일 서비스 제공업체에 초당 1,000\~5,000개의 메시지를 전송합니다. 사용자에게 이메일을 전달하는 것은 ESP에 달려 있습니다.
OneSignal은 OneSignal 이메일에 Mailgun을 사용하며 Mailgun은 [시간당 최대 1,500만 개의 이메일](https://www.mailgun.com/blog/product/how-quickly-can-mailgun-process-my-messages-introducing-the-rapid-fire-throughput-sla/)을 지원할 수 있다고 광고합니다.
***