v2.4 이메일 채널에 예약 발송 send_at 추가 · 8월 12일

호출 한 번으로 SMS·이메일·푸시가 사용자에게 도착합니다.

채널마다 다른 SDK, 통신사 규격, 실패 처리를 직접 짜지 마세요. Relay API는 하나의 엔드포인트로 세 채널을 보내고, 실패하면 다음 채널로 넘깁니다.

테스트 키는 신용카드 없이 발급됩니다. 매월 이메일 10,000건·푸시 100,000건은 무료, SMS는 인증 번호로 100건까지 테스트할 수 있습니다.

1import { Relay } from '@relay-api/sdk';
2
3const relay = new Relay(process.env.RELAY_API_KEY);
4
5await relay.messages.send({
6  to: '+82-10-1234-5678',
7  channel: ['sms', 'push', 'email'],   // 순서대로 폴백
8  template: 'order_shipped',
9  data: { orderId: 'A-20481', eta: '내일 오전' }
10});
202 Accepted POST /v2/messages 184 ms
{
  "id": "msg_01J5Y8K3Q2W7",
  "status": "queued",  "channel": "sms",  "eta_ms": 180
}
events · ap-northeast-2 · 최근 4건 (예시 데이터)

    아래 수치는 매월 1일 갱신되며, 원본은 공개 상태 페이지와 월간 운영 리포트에서 확인할 수 있습니다.

    월 발송량
    4.2억 건

    2026년 7월 1일~31일 · SMS·이메일·푸시 합산

    가동률 · 최근 90일
    99.99%

    5월 17일~8월 15일 · 상태 페이지 기록 기준

    API 응답 시간 · p50
    184ms

    서울 리전 · 8월 8일~15일 · p99 412 ms

    직접 짜던 발송 인프라를 API 한 번으로 대체합니다.

    라우팅·템플릿·웹훅·재시도는 어느 팀이든 결국 만들게 되는 코드입니다. Relay가 이미 만들어 두었고, 대시보드에서 바로 확인됩니다.

    멀티채널 라우팅 routing

    채널 배열에 순서만 적으면 SMS 실패 시 푸시, 푸시 미설치 시 이메일로 이어집니다. 시간대·국가·수신 거부 규칙은 대시보드에서 코드 수정 없이 바꿉니다.

    channel: ['sms', 'push', 'email'], routing: 'auto'

    템플릿과 변수 templates

    채널별·언어별 본문을 한 템플릿 ID로 관리합니다. 변수 누락은 발송 전에 400으로 걸러지고, 버전마다 미리보기와 롤백이 남습니다.

    template: 'order_shipped', locale: 'ko', version: 7

    웹훅 이벤트 webhooks

    queued·delivered·opened·failed·bounced 이벤트를 HMAC-SHA256 서명과 함께 보냅니다. 엔드포인트가 5xx를 돌려주면 최대 5회, 지수 백오프로 다시 시도합니다.

    X-Relay-Signature: t=1723701731,v1=9c1a… · events: ['message.*']

    자동 재시도와 폴백 retry

    통신사·SMTP·APNs 오류 코드를 분류해 재시도할 것과 즉시 폴백할 것을 나눕니다. 같은 메시지가 두 번 가지 않도록 멱등 키를 24시간 보관합니다.

    Idempotency-Key: order-A-20481-shipped · retry: { max: 4, backoff: 'exp' }

    요청 하나가 사용자에게 닿기까지, 네 단계입니다.

    좌우로 스크롤하면 전체 흐름이 보입니다

    Relay API 통합 흐름도 고객 앱이 Relay API로 요청을 보내면 인증·검증, 라우터, 큐·재시도를 거쳐 SMS 통신사, 이메일 서버, 푸시 서비스로 전달되고 결과가 웹훅으로 앱에 돌아옵니다. Your App Node · Python · Go … POST /v2/messages Relay API ap-northeast-2 · 서울 인증 · 검증 키 · 스키마 · 템플릿 라우터 채널 순서 · 규칙 큐 · 재시도 멱등 키 · 백오프 이벤트 · 로그 queued · sent · delivered · failed 순으로 기록 · 90일 보관 · 대시보드 · 검색 API SMS · LMS SKT · KT · LGU+ 직연동 Email 전용 IP · DKIM · SPF · DMARC Push APNs · FCM · Web Push webhook · message.delivered / failed · HMAC-SHA256 서명
    발송 경로 웹훅 회신 이벤트 기록
    01

    인증·검증

    API 키 권한, 요청 스키마, 템플릿 변수를 확인합니다. 문제가 있으면 큐에 넣기 전에 4xx로 즉시 반환합니다.

    02

    라우팅

    채널 배열과 규칙(시간대·국가·수신 거부)을 평가해 첫 채널을 고릅니다. 평균 3 ms.

    03

    전달·재시도

    통신사·SMTP·APNs에 전달하고 응답 코드를 분류합니다. 재시도 또는 다음 채널 폴백을 자동 처리합니다.

    04

    웹훅·로그

    상태 변화를 웹훅으로 앱에 돌려주고, 90일간 이벤트를 보관합니다. 대시보드에서 메시지 ID로 검색됩니다.

    공식 SDK 8종. 쓰는 언어 그대로 설치하면 됩니다.

    모두 OpenAPI 스펙에서 생성되고 같은 날 함께 배포됩니다. 타입 정의, 재시도, 멱등 키 헤더가 기본 포함되어 있습니다.

    Node.js / TypeScript
    v2.4.1 · Node 18 이상
    $npm i @relay-api/sdk ESM · CJS · 타입 정의 포함 문서
    Python
    v2.4.0 · 3.9 이상
    $pip install relay-api sync · asyncio · pydantic 모델 문서
    Go
    v2.4.0 · 1.21 이상
    $go get github.com/relay-api/relay-go/v2 context 지원 · 제네릭 응답 타입 문서
    Java / Kotlin
    v2.3.2 · JDK 17 이상
    >implementation("dev.relay:relay-java:2.3.2") Spring Boot 스타터 별도 제공 문서
    Ruby
    v2.3.0 · 3.1 이상
    $gem install relay-api Rails 제너레이터 · ActiveJob 어댑터 문서
    PHP
    v2.2.4 · 8.1 이상
    $composer require relay-api/relay-php Laravel 파사드 · 알림 채널 문서
    .NET
    v2.3.1 · .NET 6 이상
    $dotnet add package Relay.Api async · DI 확장 메서드 문서
    Rust
    v0.9.3 · beta · 1.75 이상
    $cargo add relay-api tokio · reqwest · 정식 릴리스 10월 예정 문서

    쓴 만큼만 냅니다. 최소 약정도, 채널별 기본료도 없습니다.

    무료 할당을 넘긴 발송량에 대해서만 건당 과금합니다. 월 발송량이 늘수록 단가는 자동으로 내려갑니다.

    Free
    ₩0/월

    사이드 프로젝트와 개발 환경. 신용카드 없이 API 키를 바로 발급합니다.

    • 이메일 10,000건 · 푸시 100,000건 / 월
    • SMS 테스트 100건 (인증 번호 3개까지)
    • 템플릿 · 웹훅 · 로그 7일 보관
    • 커뮤니티 포럼 지원
    API 키 발급받기
    Enterprise
    별도 견적· 월 1,000만 건 이상

    전용 인프라, 계약 SLA, 데이터 리전 고정이 필요한 조직.

    • SLA 99.99% · 크레딧 보상 조건 계약서에 명시
    • 전용 발송 IP · 전용 통신사 회선
    • SSO(SAML) · 감사 로그 · DPA
    • 전담 엔지니어 배정 · 야간·주말 온콜 포함
    sales@relay.dev 로 문의

    채널별 단가 (건당 · 부가세 별도)

    월 누적 발송량 구간별 자동 적용 · 2026-08 기준
    채널 무료 할당 / 월 ~100만 건 100만~1,000만 건 1,000만 건+
    SMS국내 · 90바이트 이하100건 (테스트)₩9.9₩8.5₩7.2
    LMS국내 · 2,000바이트 이하₩29.0₩26.0₩23.0
    SMS 해외국가별 상이 · 미국 기준₩68.0₩62.0₩55.0
    이메일첨부 10MB · 전용 IP 별도10,000건₩0.90₩0.70₩0.50
    푸시APNs · FCM · Web Push100,000건₩0.12₩0.09₩0.06
    웹훅 이벤트모든 채널 공통무제한무료무료무료
    로그 보관 연장90일에서 1년으로₩49,000 / 월 (프로젝트당)
    · 발송 실패 건은 과금하지 않습니다. 폴백으로 전환된 경우 최종 전달 채널 1건만 과금됩니다. · 전용 발송 IP는 월 ₩39,000, 통신사 직연동 발신번호 등록은 무료입니다. 결제는 국내 카드·계좌이체·세금계산서를 지원합니다.

    월 예상 비용 계산기

    슬라이더를 움직이면 무료 할당과 구간 단가를 반영해 즉시 계산됩니다.

    월 예상 비용
    ₩0/ 월 · VAT 별도
    SMS₩0
    이메일₩0
    푸시₩0
    무료 할당 차감−₩0
    이 조건으로 시작하기

    가동률은 분 단위로 공개하고, 보안 조치는 문서 그대로 적습니다.

    아래 상태 보드는 공개 상태 페이지와 같은 데이터입니다. 침투 테스트 보고서와 인증서 사본은 NDA 체결 후 영업일 2일 안에 보내드립니다.

    모든 시스템 정상 작동 중 업데이트 2026-08-15 14:02 KST
    최근 90일 · 일 단위공개 상태 페이지 status.relay.dev
    SLA

    월 가동률 99.95% · 99.99%

    월 가동률이 SLA에 미달하면 미달 폭에 따라 해당 월 사용료의 10%·25%·50%를 크레딧으로 돌려드립니다. 계산 기준과 제외 조건은 SLA 문서에 그대로 적혀 있습니다.

    암호화

    전송 TLS 1.3 저장 AES-256-GCM

    키는 KMS에서 90일마다 회전되며, 수신자 번호·이메일은 로그에서 마스킹됩니다. API 키는 발급 시 한 번만 표시되고 이후에는 해시만 보관합니다.

    리전

    5곳 · 프로젝트별 데이터 고정

    기본 리전은 서울이며, 프로젝트 단위로 데이터가 저장·처리될 리전을 고정할 수 있습니다. 리전 간 자동 페일오버는 선택 사항입니다.

    • KRap-northeast-2 서울
    • JPap-northeast-1 도쿄
    • SGap-southeast-1 싱가포르
    • DEeu-central-1 프랑크푸르트
    • USus-east-1 버지니아
    인증

    외부 감사와 침투 테스트

    연 1회 외부 침투 테스트, 분기별 취약점 스캔을 수행합니다. 개인정보 처리 위탁 계약(DPA)은 표준 양식으로 즉시 체결됩니다.

    • ISMS-P2025년 11월 인증 · 2028년 11월 갱신
    • ISO/IEC 270012024년 6월 취득 · 연 1회 사후 심사
    • SOC 2 Type II보고서 매년 발행 · NDA 후 제공

    테스트 키 발급부터 첫 발송까지, 세 단계입니다.

    가입하면 테스트 키가 즉시 발급됩니다. 문서의 모든 예제는 Node·Python·Go·cURL로 제공되고, 대시보드에서 요청과 응답을 그대로 재생할 수 있습니다.

    1
    API 키 발급
    RELAY_API_KEY=rly_test_7Fq2… # 테스트 키 · 발급 시 1회 표시
    2
    SDK 설치
    npm i @relay-api/sdk # 또는 pip install relay-api
    3
    첫 메시지 발송
    await relay.messages.send({ to, channel: ['sms'], text: '안녕하세요' })