SendGrid 이메일 테스트

Single Sends에서 만든 뉴스레터와 /v3/mail/send를 통해 보낸 비밀번호 재설정 이메일은 같은 SendGrid 계정에서 발송해도 상당히 다른 이메일로 도착할 수 있으며, 이는 스팸 테스트에 영향을 줍니다. Marketing Campaigns는 항상 수신 거부 헤더를 추가하려고 하지만 API는 요청한 경우에만 추가하므로, 이메일을 보내기 전에 둘 중 무엇을 테스트할지 결정하세요.

수신 방식은 둘 다 같습니다. Email Spam Tester는 계정 없이 사용할 수 있는 임시 주소를 제공합니다. 한 시간 이내에 도착한 첫 번째 메시지만 테스트되며, 인증, SpamAssassin 및 Rspamd 판정, 콘텐츠, Gmail과 Yahoo의 대량 발신자 규칙, 발신 IP를 조회한 21개 차단 목록을 포함하는 보고서가 생성됩니다.

Single Sends: 테스트 버튼과 제목 접두사

기본 제공 테스트는 Marketing > Single Sends에 있습니다. Single Send를 열고 Test Your Email을 찾은 다음, 테스트 주소를 입력하고 Send Test Message를 클릭하세요. SendGrid에서 테스트하려면 먼저 발신자와 제목을 입력해야 합니다. 제목에 Handlebars가 있으면 Test Data도 입력해야 합니다. SendGrid는 발송할 때 제목 앞에 Test - 를 붙입니다.

실제 발송과 동일하게 테스트하려면 Single Send를 목록으로 보내세요. Single Sends는 목록이나 세그먼트로 발송되므로, 테스트 주소만 연락처로 포함된 목록을 만들고 Recipients에서 선택하세요. 그러면 헤더, 수신 거부 링크, 추적 링크가 구독자에게 전송되는 것과 동일하게 적용됩니다. 수신함 테스트도 진행했다면 해당 제공업체의 수신함 주소를 이 목록에 추가할 수 있습니다.

API와 SMTP: curl 명령 하나

SendGrid의 시작 예제에서 테스트 주소를 수신자로 지정하고 불필요한 부분을 뺐습니다.

curl --request POST \
  --url https://api.sendgrid.com/v3/mail/send \
  --header 'Authorization: Bearer <<YOUR_API_KEY>>' \
  --header 'Content-Type: application/json' \
  --data '{"personalizations":[{"to":[{"email":"test-xxxxxxxxxxxxxxxxxxxx@t.email-spam-tester.com"}],"subject":"Hello, World!"}],"content":[{"type":"text/plain","value":"Heya!"}],"from":{"email":"you@yourdomain.com","name":"Your Name"}}'

수신함 배치 테스트를 켜면 제공업체별 수신함 주소가 동일한 to 배열에 들어가고 마커는 subject에 들어갑니다. 따라서 요청 한 번으로 Gmail, Outlook, Yahoo 및 기타 제공업체에서 이메일이 어느 폴더에 도착하는지도 확인할 수 있습니다.

자신의 테스트 주소와 SendGrid가 단일 발신자 확인 또는 도메인 인증을 통해 확인한 From 주소를 입력하세요. 가능하면 애플리케이션에서 실제로 보내는 메시지를 실제 HTML과 함께 보내세요. 콘텐츠 검사는 본문에 있는 내용을 평가합니다.

애플리케이션이 SMTP를 사용한다면 전송 방식 외에는 달라지는 것이 없습니다. 호스트는 smtp.sendgrid.net이고, 사용자 이름은 키가 아니라 문자 그대로 apikey이며, SSL은 포트 465를 사용합니다.

테스트 전송 엔드포인트 POST /v3/marketing/test/send_email도 있습니다. 주소를 최대 10개까지 받을 수 있지만 Dynamic Transactional Templates에서만 작동하므로, 대부분의 API 메일에는 위의 일반 Mail Send 호출이 실제 전송을 가장 정확하게 테스트하는 방법입니다.

수신 거부 헤더는 선택한 전송 방식에 따라 달라집니다

Marketing Campaigns는 항상 List-Unsubscribe 헤더를 추가하려고 합니다. API 또는 SMTP를 통해 보낸 메일에는 Settings > Tracking에서 Subscription Tracking을 켠 경우에만 이 헤더가 추가됩니다. 이 경우 SendGrid는 HTTPS 링크가 포함된 List-Unsubscribe와 List-Unsubscribe-Post: List-Unsubscribe=One-Click을 삽입합니다.

Subscription Tracking을 사용하지 않으면 요청에 헤더를 직접 추가해야 합니다.

"headers": {
  "List-Unsubscribe-Post": "List-Unsubscribe=One-Click",
  "List-Unsubscribe": "<mailto:unsubscribe@yourdomain.com>, <https://yourdomain.com/unsubscribe>"
}

SendGrid는 mailto와 https 부분을 모두 요구하며, 해당 링크에 대한 일반 GET 요청만으로 수신자를 구독 취소 처리하지 말라고 경고합니다. 이 헤더에 관한 SendGrid 지원 문서의 내용을 복사할 때는 주의하세요. 두 번째 예시에서는 List-Unsubscribe-Post를 URL로 설정하지만 이는 잘못된 방식입니다. 값은 항상 List-Unsubscribe=One-Click입니다. 나머지 내용은 List-Unsubscribe 수정 페이지에서 확인하세요.

메시지가 비밀번호 재설정 또는 영수증 메일이고 목록 헤더가 없으면 보고서에서 대량 발신자 규칙 그룹을 실패가 아닌 건너뜀으로 표시합니다. API를 통해 보낸 뉴스레터에는 이 예외가 적용되지 않습니다.

인증 결과 읽기

도메인 인증이 설정되지 않은 계정에서는 수신자가 보낸 사람 주소 뒤에 "via sendgrid.net"을 보게 되며, SendGrid 문서에 따르면 도메인 인증을 설정하면 이 표시가 사라집니다. 보고서에서는 이 표시보다 더 자세한 정보를 확인할 수 있습니다. DKIM 및 SPF 정렬 항목을 확인하세요. 서명이나 Return-Path가 사용자의 도메인이 아닌 SendGrid 도메인에 속하면 보낸 사람 주소에 대해 DMARC를 통과할 수 없으며, 해결 계획에서 도메인 인증을 안내해야 합니다. gmail.com 또는 yahoo.com 주소를 보낸 사람 주소로 사용하면 상황이 더 나빠집니다. SendGrid의 DMARC 페이지에 따르면 두 주소 모두 SPF와 DKIM이 실패하며, 콘솔에서도 이러한 메시지가 DMARC 검사에 실패할 수 있다고 경고합니다.

도메인 인증은 Settings > Sender Authentication에 있습니다. 기본값인 자동 보안을 사용하면 SendGrid에서 다음 네 개의 레코드를 제공합니다.

• em[0000]의 CNAME, SPF를 처리하고 Return-Path가 됩니다.
• DKIM용 s1._domainkey 및 s2._domainkey의 CNAME
• 값이 v=DMARC1; p=none;인 _dmarc의 TXT

자동 보안을 사용하지 않으면 em[0000]에 MX와 SPF TXT(v=spf1 include:sendgrid.net ~all)가 제공되고, m1._domainkey에 DKIM TXT가 제공됩니다. 이 경우 SPF 레코드는 직접 관리해야 합니다. DNS 제공업체가 _가 포함된 CNAME 이름을 거부한다면 이 방법만 사용할 수 있습니다. 다른 서비스에서 이미 s 선택자를 사용 중인 경우 SendGrid에서 사용자 지정 선택자를 지정할 수 있습니다. DKIM 검사기(선택자 s1)와 SPF 검사기로 결과를 확인하세요. SPF 레코드가 복잡해지는 경우 SPF 검사기에서 DNS 조회 횟수도 계산할 수 있습니다.

링크, IP 및 보고서의 나머지 항목

클릭 추적은 모든 링크를 다시 작성합니다. 링크 텍스트 자체가 URL이면 표시되는 주소와 실제 대상이 일치하지 않게 되며, 보고서의 링크 불일치 검사에서 문제가 표시됩니다. SendGrid의 전송 가능성 페이지에서도 같은 문제를 설명합니다. 링크 텍스트에는 단어를 사용하거나, 추적 링크가 자체 도메인을 통하도록 링크 브랜딩을 설정하세요. 이 도메인은 From 도메인과 일치해야 합니다.

Trial 및 Essentials 요금제는 공유 IP 풀에서 이메일을 보냅니다. SendGrid에 따르면 평판이 바뀌면 이 IP가 예고 없이 변경될 수 있으므로, IP 하나가 차단 목록에 등록되면 해당 풀의 모든 사용자에게 영향을 줍니다. 차단 목록 검사기에서 나중에 해당 IP를 다시 조회할 수 있습니다. Reverse DNS는 전용 IP에서만 설정할 수 있으며, 전용 IP는 Pro Email API 및 Advanced Marketing Campaigns에서 제공됩니다.