ONE STEP AWAY
[EduTech Letter] 자동 브리핑 메일 발송 본문
EduTech Letter 구축 및 자동 알림 설정 요약
오늘은 edutech_letter 웹사이트를 만들고, 매일 아침 이메일로 자동 브리핑을 받을 수 있도록 전체 흐름을 정리하고 구현했다.
1. EduTech Letter 웹사이트 구축
기존 edutech_job 레포의 구조를 참고해 edutech_letter 프로젝트를 만들었다. 목적은 에듀테크 관련 최신 뉴스와 자료를 모아 보여주는 웹사이트다.
수집 대상은 Google News RSS 외에 다음 지정 사이트를 포함했다.
- KERIS 한국교육학술정보원
- SPRi 소프트웨어정책연구소
- HolonIQ
- 한국벤처캐피탈협회 KVCA
- 교육부 보도자료실
- 대한민국 정책브리핑
- 에듀테크 데일리
- 대한민국교육신문
Ask! EdTech Insight는 현재 공개 수집이 어려워 설정상 보류로 두고, 웹 UI에는 노출하지 않기로 했다.
웹사이트 UI는 Toss와 Karrot 스타일 디자인 문서를 참고해 카드형 대시보드로 구성했다. 각 자료에는 발행기관, 핵심 키워드, 발행일자, 원문 링크 버튼을 표시했다. “기획 활용 포인트”는 자동 생성 내용이 반복적으로 보일 위험이 있어 제거하고, 원문 접근성을 높이는 방향으로 정리했다.
사이트는 Render에 배포했고, 현재 공개 주소는 다음과 같다.
https://edutech-letter.onrender.com/
2. 보안 및 환경변수 정리
GitHub에 API 키가 노출되지 않았는지 확인했다. 실제 민감한 키는 올라가 있지 않았고, 문서에는 <BREVO_API_KEY>, <SENDGRID_API_KEY> 같은 예시값만 있었다. 이후 .env 방식으로 관리하도록 정리했고, .env.example과 README에 환경변수 관리 안내를 추가했다.
3. n8n 이메일 자동화 구성
카카오톡 단체방 봇 발송은 현실적으로 제약이 많고, 알림톡은 과금이 발생하기 때문에 제외했다. 텔레그램과 이메일을 비교한 뒤, 최종적으로 n8n + Gmail을 활용해 매일 아침 이메일을 보내는 방식으로 진행했다.
초기에는 SVG 파일을 첨부하는 방식이었지만, Gmail 본문에서 SVG 미리보기가 되지 않고 첨부파일로만 표시되는 문제가 있었다. 이후 본문에 이미지가 바로 보이도록 PNG 이미지 URL을 삽입하는 방식으로 변경했다.
현재 메일 본문에는 다음 요소가 포함된다.
- 오늘의 EduTech Letter 업데이트 안내
- 웹사이트 링크
- 최근 24시간 기준 주요 헤드라인 카드 이미지
- 이미지를 클릭하면 웹사이트로 이동
4. 이미지 깨짐 문제 해결
처음 PNG 이미지를 메일 본문에 넣었을 때 한글이 깨지는 문제가 있었다. 원인은 Render 서버의 이미지 변환 환경에서 한글 폰트가 제대로 반영되지 않았기 때문이었다.
이를 해결하기 위해 카드 이미지 생성 방식을 수정했다. 기존 SVG 텍스트 렌더링 방식에서 satori를 활용해 한글 텍스트를 벡터 경로로 변환한 뒤 PNG로 생성하도록 변경했다. 이후 공개 이미지 URL에서도 한글이 정상적으로 표시되는 것을 확인했다.
현재 사용 중인 이미지 URL은 다음 형태다.
https://edutech-letter.onrender.com/api/digest-card.png?hours=24&limit=5
메일 캐시 문제를 줄이기 위해 n8n에서는 날짜 기반 캐시 방지 파라미터를 추가했다.
&v=yyyyMMdd
5. 최종 n8n 워크플로 구조
매일 아침 8시에 자동 발송되도록 아래 구조로 정리했다.
- Schedule Trigger
매일 오전 8시 실행 - Wake Render
Render 서버가 잠들어 있을 수 있으므로 /api/health를 먼저 호출 - Wait
서버가 완전히 깨어날 시간을 주기 위해 약 25~30초 대기 - Send Gmail
Gmail로 사이트 링크와 헤드라인 카드 이미지를 본문에 포함해 발송
최종적으로 사용자가 직접 실행 테스트를 했고, 이미지가 깨지지 않고 메일 본문에 정상 표시되는 것을 확인했다.