SMTP로 이메일 보내기

Banger의 SMTP 릴레이는 Supabase Auth, Auth0, WordPress, 프레임워크의 메일러처럼 SMTP로만 보내는 앱도 Banger를 통해 발송하게 해요. 앱은 Banger API 키로 로그인하며 모든 메시지는 자체 도메인에서 나가 로그에 표시돼요.

시작하기 전에

두 가지가 필요해요.

1. 제품 레인. From 주소는 준비된 제품 레인이 있는 도메인이나 하위 도메인이어야 해요. 도메인 › 레인 추가에서 제품을 선택하고 표시된 DNS 레코드를 추가하세요. 도메인 추가를 확인하세요. 팀 메일함용 메일 레인이나 단체 발송 레인은 앱 이메일을 보낼 수 없으므로 앱 메일이 팀 받은편지함의 평판에 영향을 주지 않아요.
2. 발송 가능한 API 키. API 키 › API 키 만들기에서 앱 이름(예: “Supabase Auth”)을 붙이고 mail:send만 선택한 뒤 키 만들기를 선택하세요. 한 번만 표시되므로 바로 복사하세요.

설정 › 개발자 › API 키 관리에서도 API 키로 갈 수 있어요.

SMTP 설정

API 키 페이지의 SMTP 상자에 다음 설정과 호스트 복사 버튼이 있어요.

앱이 “SSL”이나 “TLS”를 요구하면 465를, “STARTTLS”를 요구하면 587을 사용하세요.

Supabase Auth 연결하기

1. Supabase에서 Authentication › Emails › SMTP Settings를 열고 사용자 지정 SMTP를 켜세요.
2. 보낸 사람 이메일: noreply@app.example.com처럼 제품 레인의 주소를 사용하세요.
3. 보낸 사람 이름: 제품 이름을 쓰세요. Banger는 그대로 유지해요.
4. 호스트는 submit.bangermail.com, 포트는 465, 사용자 이름은 banger, 비밀번호는 API 키예요.
5. 저장한 뒤 Authentication › Users에서 본인에게 매직 링크를 보내세요.

다른 앱도 같아요. 위 설정을 앱의 SMTP 또는 메일 설정에 붙여넣으세요. 코드 예시는 SMTP 개발자 문서에 있어요.

작동 확인

로그를 여세요. 앱에서 보낸 각 메시지가 SMTP 출처와 전달 상태로 표시돼요. 거부된 모든 시도도 해결할 항목과 함께 기록돼요.

Banger가 메시지를 접수하면 앱은 250 2.0.0 Queued as …를 받아요.

Banger가 각 메시지를 처리하는 방법

• 앱이 작성한 내용과 From 이름 그대로 보내며 도메인의 DKIM 키로 서명해요.
• Bcc와 Return-Path를 제거하고 Reply-To가 없으면 From 주소로 추가해요.
• 차단된 수신자는 건너뛰고 나머지에게 보내요.
• 같은 메시지의 재시도를 같은 발송으로 처리하므로 시간 초과로 두 번 보내지 않아요.
• 다른 발송과 마찬가지로 요금제 사용량에 포함해요.

메시지당 최대 10 MiB, 수신자는 최대 50명이에요.

메시지가 거부되는 경우

모든 거부 응답에는 이유와 로그 항목에 대응하는 참조 (ref …)가 있어요. 4로 시작하는 코드는 일시적 오류이므로 앱이 나중에 재시도할 수 있어요.

키 안전하게 관리하기

• 앱마다 mail:send만 있는 별도 키를 주세요. SMTP 비밀번호가 유출돼도 워크스페이스를 읽을 수 없어요.
• 교체하려면 새 키를 만들고 앱에 적용한 뒤 이전 키를 폐기하세요. 이전 키를 쓰는 앱은 다음 로그인에서 거부돼요.
• Banger는 각 키의 해시만 저장하며 거부된 로그인을 로그에 기록해요.

AI에게 요청해 보세요

메일 발송만 가능한 API 키를 만들고 제품 레인이 준비됐는지 확인해 줘. Supabase에 붙여넣을 SMTP 설정을 알려 줘.