curl -X POST https://mail.helipod.io/api/email/send \
  -H "Authorization: Bearer hel_xxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "from": "내 스토어 <noreply@tokoanda.co.id>",
    "to": ["budi@example.com"],
    "subject": "인증 코드",
    "html": "<p>인증 코드: <b>{{kode}}</b></p>",
    "variables": { "kode": "482913" },
    "idempotencyKey": "verify-8812"
  }'

200 { "success": true, "data": { "id": "…" } }

트랜잭션 이메일

트랜잭션 이메일이란?

트랜잭션 이메일은 사용자의 행동에 따라 애플리케이션이 자동으로 보내는 이메일입니다. 로그인 시 OTP 코드, 가입 시 인증 링크, 비밀번호 재설정, 구매 영수증, 주문 상태 알림 등이 있습니다. 사용자가 기다리는 메일이므로 빠르게 도착해야 하고 스팸함으로 들어가면 안 됩니다.

PHP mail()이나 일반 호스팅 SMTP로 직접 보내면 IP에 평판이 없고 DNS 레코드가 불완전해 스팸함으로 가기 쉽습니다. Helipod는 Amazon SES 자카르타 리전을 통해 도메인의 SPF, DKIM, DMARC와 함께 발송하며, 발송 전에 수신자 주소도 검사합니다.

반송되었거나 스팸으로 신고한 수신자는 자동으로 차단되고, 이메일을 받을 수 없는 도메인의 주소는 처음부터 거부되어 도메인 평판이 유지됩니다.

3단계로 시작하기

01
도메인 인증
발신 도메인을 추가하고 대시보드에 표시된 DNS 레코드를 복사하세요.
02
API 키 만들기
API & webhooks 메뉴에서 키를 만드세요. 키는 한 번만 표시되므로 애플리케이션 환경 변수에 저장하세요.
03
첫 요청 보내기
Authorization: Bearer <api_key> 헤더와 함께 mail.helipod.io/api/email/send에 POST 요청을 보내세요.

기능

개발자를 위해 만들었습니다

프로덕션 애플리케이션에 필요한 기능을 명확한 문서와 오류 메시지와 함께 제공합니다.

간단한 REST API

PHP, Laravel, Node.js, Python, Go 등 어떤 언어에서든 호출할 수 있는 하나의 JSON 엔드포인트.

50통 일괄 발송

한 요청에 서로 다른 이메일을 최대 50통까지, 각각 자체 변수와 함께 보낼 수 있습니다.

상태 웹훅

sent, delivered, bounced, complained, opened, clicked 등의 이벤트를 서명과 함께 서버로 받아보세요.

템플릿과 변수

대시보드에 템플릿을 저장하고 templateId와 데이터(예: {{nama}}, {{kode}})만 보내면 됩니다.

멱등성 키

타임아웃으로 다시 보낸 요청이 이메일을 두 번 발송하지 않습니다.

민감 데이터 모드

OTP나 비밀번호가 담긴 이메일을 표시하면 발송 후 큐에서 내용이 삭제됩니다.

자동 차단 목록

반송되었거나 스팸으로 신고한 주소에는 더 이상 발송하지 않아 도메인 평판을 지킵니다.

자카르타 리전

Amazon SES ap-southeast-3를 통해 발송되어 인도네시아 사용자와 가깝습니다.

프로젝트별 API 키

여러 키를 만들고 이름을 붙이고, 다른 키에 영향 없이 언제든 폐기할 수 있습니다.

요금

이메일 API 요금

테스트용으로 하루 50통 무료로 시작하세요. 유료 플랜은 월 Rp 24.990부터이며, 할당량을 다 쓰면 건당 결제로 이어서 보낼 수 있습니다.

Free

무료

일 50통
연락처 100개
이메일 블라스트 / 브로드캐스트
메일함 없음
도메인 1개 · 템플릿 3개

Starter

Rp 24.990/월

월 2,500통
연락처 1,500개
이메일 블라스트 / 브로드캐스트
받은편지함: 메일함 1개 + 별칭 3개, 3 GB
도메인 2개 · 템플릿 20개

Pro

Rp 74.900/월

월 8,500통
연락처 4,500개
이메일 블라스트 / 브로드캐스트
받은편지함: 메일함 1개 + 별칭 3개, 7 GB
도메인 5개 · 템플릿 100개

Business

Rp 124.900/월

월 15,500통
연락처 8,500개
이메일 블라스트 / 브로드캐스트
받은편지함: 메일함 1개 + 별칭 3개, 15 GB
도메인 20개 · 템플릿 500개

연 결제 시 월 환산 가격입니다. 계약 없이 월 단위로 결제할 수도 있습니다. 갱신 가격은 시작 가격과 같습니다. QRIS 또는 은행 송금으로 결제하며 신용카드가 필요 없습니다.

FAQ

이메일 API 관련 질문

무료 이메일 API가 있나요?

네. Free 플랜은 신용카드 없이 API 또는 SMTP로 하루 50통을 제공하며, 도메인 인증, 템플릿, 웹훅이 모두 포함됩니다. 테스트와 소규모 애플리케이션에 적합합니다. 유료 플랜은 더 큰 월간 할당량을 제공합니다.

트랜잭션 이메일이란 무엇인가요?

트랜잭션 이메일은 사용자의 행동에 따라 애플리케이션이 자동으로 보내는 이메일입니다. 계정 인증, OTP 코드, 비밀번호 재설정, 구매 영수증, 주문 알림 등이 있습니다. 프로모션 메일과 달리 빠르게 도착해야 하고 스팸함으로 들어가면 안 됩니다.

Helipod API로 이메일은 어떻게 보내나요?

대시보드에서 API 키를 만들고 발신 도메인을 인증한 뒤, Authorization: Bearer <api_key> 헤더와 from, to, subject, html 또는 text가 담긴 JSON 본문으로 https://mail.helipod.io/api/email/send에 POST 요청을 보내세요. 응답에는 대시보드나 웹훅으로 추적할 수 있는 발송 id가 포함됩니다.

여러 통을 한 번에 보낼 수 있나요?

네. /send/batch 엔드포인트는 한 요청에 서로 다른 이메일을 최대 50통까지 받으며, 각각 수신자와 변수를 따로 지정할 수 있습니다. 수천 명에게 보내는 뉴스레터는 대시보드의 브로드캐스트(이메일 블래스트) 기능을 사용하세요.

이메일이 도착했는지, 반송되었는지 어떻게 알 수 있나요?

웹훅 URL을 등록하고 받고 싶은 이벤트(sent, delivered, bounced, complained, opened, clicked, rejected, failed, received)를 선택하세요. 모든 웹훅 요청에는 서명이 포함되어 Helipod에서 보낸 것인지 확인할 수 있습니다.

첨부 파일을 보낼 수 있나요?

아직 지원하지 않습니다. 현재 API는 첨부 파일을 명확한 오류 메시지와 함께 거부합니다. 인보이스 같은 문서는 본문에 다운로드 링크를 넣어 보내세요.

SMTP도 제공되나요?

네. SMTP만 지원하는 애플리케이션(WordPress, Laravel, PHPMailer, Nodemailer)은 smtp.helipod.io의 587 또는 465 포트로, API 키를 비밀번호로 사용해 보낼 수 있습니다. SMTP 발송도 API와 같은 검사와 할당량을 거치며 같은 로그에 기록됩니다.

타임아웃으로 요청을 다시 보내면 어떻게 되나요?

요청 본문에 idempotencyKey를 포함하세요. 같은 키로 같은 요청을 다시 보내면 Helipod는 이메일을 두 번 보내지 않고 처음 발송 결과를 반환합니다.

Helipod Email

Helipod의 다른 이메일 서비스

Helipod 이메일

Helipod의 모든 이메일 서비스와 요금을 한눈에 확인하세요.

이메일 호스팅

내 도메인으로 쓰는 이메일: 메일함, 별칭, 모던 웹메일.

이메일 블라스트

세그먼트, 템플릿, 리포트와 함께 연락처 목록에 대량 이메일을 발송하세요.

SMTP 릴레이

WordPress, Laravel 등 모든 앱에서 쓸 수 있는 인도네시아 SMTP 서버.

첫 트랜잭션 이메일을 보내 보세요

무료로 가입하고, 도메인을 인증하고, 몇 분 만에 API로 발송하세요.