고유의 SendGrid 계정을 통해 이메일 발송

SendGrid (Twilio SendGrid) 계정과 도메인의 DNS에 대한 액세스 권한이 필요합니다.

1. 도메인 인증하기

설정(Settings) → 보낸 사람 인증(Sender Authentication) → 도메인 인증(Authenticate Your Domain).

목록에서 DNS 호스트를 선택하고 "이 도메인의 링크도 브랜딩하시겠습니까?"(Would you like to also brand the links for this domain?) 질문에 예(Yes)로 답하세요. 링크 브랜딩은 추적되는 링크를 sendgrid.net 대신 본인의 도메인으로 재작성하므로, 송장의 링크에 마우스를 올리는 고객은 귀하의 이름을 보게 됩니다.

발신 도메인을 묻는 메시지가 나타나면 mail.yourdomain.com과 같은 하위 도메인을 입력하세요.

2. CNAME 레코드 게시하기

SendGrid에서는 세 개 또는 다섯 개의 CNAME 레코드를 제공합니다. 모두 추가하세요.

| 유형 | 호스트 | 용도 | | --- | --- | --- | | CNAME | em1234.yourdomain.com | 반송(Return-path) 도메인 | | CNAME | s1._domainkey.yourdomain.com | DKIM 키 1 | | CNAME | s2._domainkey.yourdomain.com | DKIM 키 2 |

⭐ SendGrid는 TXT 레코드 대신 CNAME을 의도적으로 사용하며, 이는 실제로 더 유리합니다. 실제 키 값이 SendGrid에 있으므로, 사용자가 DNS를 다시 수정할 필요 없이 SendGrid에서 서명 키를 교체할 수 있습니다.

⚠️ DNS 제공업체가 Cloudflare인 경우, 이 레코드들을 프록시가 아닌 DNS 전용(회색 구름)으로 설정하세요. 프록시가 설정된 CNAME은 Cloudflare의 주소로 확인되어 SendGrid의 확인 작업이 실패합니다.

SendGrid에서 확인(Verify)을 누르세요. 최대 1시간 정도 소요될 수 있습니다.

3. API 키 만들기

설정(Settings) → API 키(API Keys) → API 키 만들기(Create API Key).

제한된 액세스(Restricted Access)를 선택하고 메일 전송(Mail Send) → 전체 액세스(Full Access) 권한만 부여하세요. 다른 권한은 선택하지 마세요.

⛔ 전체 액세스 키를 사용하지 마세요. 전체 액세스 키는 연락처를 읽고, 계정 설정을 변경하며, 추가 키를 생성할 수 있습니다. 당사에서 필요한 작업은 오직 메시지 전송뿐입니다. 고객님의 키 사본이 유출될 경우, 두 키의 차이는 원치 않는 이메일 몇 통과 침해된 계정의 차이만큼 큽니다.

⚠️ 키는 한 번만 표시됩니다. 페이지를 떠나기 전에 복사해 두세요. SendGrid는 키를 다시 표시할 수 없으며 대체만 가능합니다.

4. Zinn®에서 연결하기

대시보드에서 이메일 보내기(Email sending)를 엽니다:

제공업체(Provider) — SendGrid
이 도메인에서 보내기(Send from this domain) — mail.yourdomain.com (주소가 아닌 도메인)
SendGrid API 키(SendGrid API key) — 3단계의 키

SendGrid에는 이 외에 다른 설정이 필요하지 않습니다.

5. 테스트 전송 후 코드 입력하기

다른 도메인의 받은 편지함으로 테스트 메시지 보내기(Send test message)를 누르고, 수신된 메시지에서 코드를 확인하여 입력하세요.

작동하지 않을 때

403 금지됨(403 Forbidden) — API 키에 메일 전송(Mail Send) 권한이 없습니다. 이는 단연코 가장 흔한 실패 원인입니다. 어떤 범위도 선택하지 않은 채 생성된 제한된 액세스 키는 완벽하게 인증되지만 아무 작업도 수행할 수 없습니다.

"보낸 사람 주소가 확인된 보낸 사람 신원과 일치하지 않습니다"("The from address does not match a verified Sender Identity") — 도메인 인증이 아직 완료되지 않았거나 이 도메인에서 보내기(Send from this domain)에 입력한 도메인이 인증된 도메인이 아닙니다. SendGrid는 정확한 도메인을 확인합니다. mail.yourdomain.com을 인증했다고 해서 yourdomain.com에서의 전송이 허용되지는 않습니다.

수락되었으나 전달되지 않음(Accepted but never delivered) — SendGrid의 활동(Activity)을 확인하세요. 새로 만든 계정의 경우 첫 하루 정도는 검토를 위해 보류되는 경우가 있으며, 메시지가 반송되지 않고 대기 상태로 유지됩니다.

몇 번 전송한 후 계정이 정지됨(Your account was suspended after a few sends) — SendGrid는 반송되는 주소로 새 계정이 전송하는 행위에 대해 엄격합니다. 전환하기 전에 고객 목록이 깨끗한지 확인하세요.