이메일 인프라 가이드
수신 이메일 웹훅: 설계 패턴과 안전성
폴링 방식의 메일함 워크플로를 만들지 않고도 웹훅으로 수신 메시지를 처리합니다.
수신 이메일 웹훅은 메시지가 도착하면 구조화된 이벤트를 애플리케이션으로 전달합니다. 설계상의 과제는 안전한 파싱, 인증, 멱등성, 그리고 메시지를 잃지 않으면서 재시도를 처리하는 것입니다.
실무에서의 의미
- 서명되었거나 인증된 웹훅 전달
- 멱등 처리를 위한 메시지 ID
- 복구를 위한 원본 메시지 보관
- 첨부 파일과 후속 작업의 비동기 처리
구현 체크리스트
- 내용을 파싱하기 전에 웹훅 출처를 검증하세요.
- 부수 효과가 발생하기 전에 제공업체 메시지 ID를 저장하세요.
- 오래 걸리는 첨부 파일 또는 AI 처리는 큐에 넣으세요.
- 성공 응답을 빠르게 반환하고, 일시적 실패는 안전하게 재시도하세요.
팀에서 자주 묻는 질문
웹훅 요청 안에서 첨부 파일을 처리해야 하나요?
보통은 아니요. 메시지를 저장하고 첨부 파일 작업을 큐에 넣어 확인 응답이 빠르고 재시도에 안전하도록 하세요.
중복 웹훅은 어떻게 처리하나요?
제공업체 메시지 ID를 고유한 값으로 취급하고 후속 작업을 멱등하게 만드세요.