Resend API로 이메일 자동화 구현하는 방법

Resend API로 이메일 자동화 구현하는 방법

📌 이 글의 핵심 요약

• Resend는 개발자 친화적인 이메일 발송 API 서비스로 설정이 단순하다
• API 키 발급 → 도메인 인증 → 코드 연동까지 30분 내 완료 가능
• Node.js, Python 등 주요 언어 SDK를 공식 지원한다
• 무료 플랜에서 월 3,000건 발송까지 비용 없이 테스트 가능

📋 목차

1. Resend란 무엇인가
2. API 키 발급과 초기 설정
3. Node.js로 이메일 발송하기
4. 도메인 인증과 발신자 설정
5. 실전 자동화 활용 시나리오
6. 정리 및 결론

Resend란 무엇인가

서비스를 만들다 보면 이메일 발송이 필요한 시점이 반드시 온다. 회원가입 인증, 비밀번호 재설정, 주문 알림, 뉴스레터 발송까지 종류도 다양하다. 직접 SMTP 서버를 구축하면 설정이 복잡하고 스팸 처리 이슈가 따라온다. 이 문제를 해결하기 위해 나온 게 이메일 발송 API 서비스다.

Resend는 2023년 등장한 이메일 API 서비스로, 개발자가 최소한의 설정으로 이메일 자동화를 구현할 수 있도록 설계됐다. SendGrid나 Mailgun 같은 기존 서비스 대비 API 구조가 직관적이고, 공식 문서 품질이 높아 처음 사용하는 사람도 빠르게 적용할 수 있다.

📊 Resend 무료 플랜 스펙

• 월 발송 한도: 3,000건
• 일일 발송 한도: 100건
• 커스텀 도메인 연결: 가능
• API 키 수: 무제한
• 이메일 로그 보존: 1일

---

API 키 발급과 초기 설정

resend.com에서 회원가입 후 대시보드에 접속하면 왼쪽 메뉴에 'API Keys' 항목이 있다. 여기서 새 키를 생성하면 즉시 사용 가능한 API 키가 발급된다. 키는 생성 시점에만 전체 값을 확인할 수 있어 바로 복사해 안전한 곳에 저장해야 한다.

⚠️ API 키 보안 주의사항
API 키를 GitHub 코드에 직접 노출하면 보안 사고로 이어진다. 반드시 환경변수(.env 파일)에 저장하고 .gitignore에 추가해야 한다. 키가 유출됐다면 즉시 대시보드에서 삭제하고 재발급해야 한다.

Node.js 프로젝트라면 패키지 설치부터 시작한다. npm을 쓴다면 터미널에 npm install resend를 입력하면 된다. 설치 후 .env 파일에 RESEND_API_KEY=re_xxxxxxxx 형태로 키를 저장한다.

---

Node.js로 이메일 발송하기

Resend SDK를 설치하고 나면 실제 발송 코드는 놀랄 만큼 간단하다. 아래는 기본 발송 코드 구조다.

import { Resend } from 'resend';

const resend = new Resend(process.env.RESEND_API_KEY);

await resend.emails.send({
  from: '알림 <noreply@yourdomain.com>',
  to: ['user@example.com'],
  subject: '가입을 환영합니다',
  html: '<p>안녕하세요. 가입이 완료됐습니다.</p>',
});

from 필드에 표시 이름을 넣으면 수신자 측에서 발신자가 더 명확하게 보인다. html 필드 대신 text 필드를 쓰면 일반 텍스트 이메일도 발송된다. react 필드를 사용하면 React 컴포넌트를 이메일 템플릿으로 쓸 수도 있는데, 이 부분이 Resend가 개발자에게 특히 어필하는 기능이다.

에러 처리 추가하기

실제 서비스에서는 발송 실패를 대비한 예외 처리가 필수다. try-catch로 감싸고 에러 로그를 남기는 게 기본이다. Resend API는 발송 성공 시 id 값을 반환하므로 이 값을 DB에 저장해두면 나중에 발송 이력 추적이 가능하다.

---

도메인 인증과 발신자 설정

테스트 단계에서는 Resend가 제공하는 기본 도메인으로 발송할 수 있지만, 실제 서비스에는 반드시 본인 도메인을 인증해야 한다. 도메인 인증을 거치면 스팸 필터에 걸릴 확률이 낮아지고, 발신자 이름도 자유롭게 설정할 수 있다.

🔧 도메인 인증 순서

1. Resend 대시보드 → Domains → Add Domain
2. 사용할 도메인 입력 (예: yourdomain.com)
3. 안내된 DNS 레코드(SPF, DKIM, DMARC)를 도메인 관리 사이트에 추가
4. Resend 대시보드에서 Verify 클릭 → 상태가 Verified로 변경 확인
5. from 필드에 인증된 도메인의 이메일 주소 사용

DNS 반영에는 수분에서 최대 48시간이 걸릴 수 있다. 대부분은 30분 이내에 완료된다. 인증이 완료되면 해당 도메인의 이메일 주소를 발신자로 자유롭게 쓸 수 있다.

---

실전 자동화 활용 시나리오

Resend API는 단순 발송 외에도 다양한 자동화 흐름에 연결할 수 있다. 웹훅이나 스케줄러와 조합하면 이메일 자동화의 범위가 넓어진다.

⚡ 실전 자동화 시나리오

• 회원가입 인증 메일 — 가입 즉시 이메일 인증 링크 발송
• 결제 완료 알림 — 결제 이벤트 발생 시 영수증 자동 발송
• 비밀번호 재설정 — 요청 즉시 임시 링크 포함 메일 발송
• 정기 뉴스레터 — cron job과 연동해 매주 자동 발송
• 서버 에러 알림 — 에러 감지 시 담당자에게 즉시 경고 메일

💡 Resend + Webhooks 조합 팁

Resend는 이메일 열람, 클릭, 바운스, 스팸 신고 등의 이벤트를 웹훅으로 수신할 수 있다. 이를 활용하면 이메일을 열지 않은 사용자에게만 리마인더를 보내거나 바운스된 주소를 자동으로 수신 거부 처리하는 흐름을 만들 수 있다.

---

정리 및 결론

Resend API 이메일 자동화 핵심 정리

• 회원가입 후 API 키 발급 → SDK 설치 → 코드 3줄로 발송 테스트 가능
• 실서비스 전 도메인 인증(SPF, DKIM, DMARC) 설정 필수
• API 키는 반드시 환경변수로 관리, 코드에 직접 삽입 금지
• 웹훅 연동으로 열람·클릭·바운스 기반 고급 자동화 구현 가능
• 무료 플랜 월 3,000건으로 초기 테스트와 소규모 서비스에 충분

이메일 발송 기능이 필요한 프로젝트를 시작한다면 Resend API는 복잡한 설정 없이 빠르게 붙일 수 있는 선택지다. 특히 React 이메일 템플릿 지원 덕분에 기존 프론트엔드 스킬을 그대로 활용할 수 있어 진입 장벽이 낮다.