콘텐츠로 이동

캐스케이드 API

Cascade API를 사용하면 단일 요청으로 여러 플랫폼에 걸쳐 메시지를 보낼 수 있으며 자동으로 Telegram Bot, Viber Bot, Viber Business Messages, RCS 및 SMS로 라우팅됩니다.

기본 URL

https://restapi.smsbat.com

인증

Cascade API는 세 가지 인증 헤더가 있는 헤더 기반 인증을 사용합니다.

방법 1: SMSBAT API 키

curl -X POST https://restapi.smsbat.com/api/CascadeMessage/send_message/async \
  -H "X-Authorization-Key: your-smsbat-api-key" \
  -H "Content-Type: application/json" \
  -d @request.json

방법 2: Viber Bot 토큰

curl -X POST https://restapi.smsbat.com/api/CascadeMessage/send_message/async \
  -H "X-Viber-Auth-Token: your-viber-bot-token" \
  -H "Content-Type: application/json" \
  -d @request.json

방법 3: 텔레그램 봇 키

curl -X POST https://restapi.smsbat.com/api/CascadeMessage/send_message/async \
  -H "X-Tg-Bot-Key: your-telegram-bot-key" \
  -H "Content-Type: application/json" \
  -d @request.json

사용 가능한 엔드포인트

방법 엔드포인트 설명
포스트 /api/CascadeMessage/send_message/async 일반 캐스케이드 메시지 전송
포스트 /api/CascadeMessage/send_message/tg-viber/async 텔레그램 우선 캐스케이드

작동 방식

단일 API 요청으로 Cascade는 자동으로 여러 채널에 메시지를 전달합니다.

Telegram Bot → Viber Bot → Viber Business → RCS → SMS

메시지는 사용 가능한 첫 번째 채널을 통해 전달되며, 전달이 실패하면 자동으로 다음 채널로 대체됩니다.

주요 기능

다중 채널 전송

하나의 메시지를 보내고 모든 플랫폼의 사용자에게 다가가세요.

  • 텔레그램 봇
  • 바이버봇
  • Viber 비즈니스 메시지
  • RCS(리치 커뮤니케이션 서비스)
  • SMS

변수 대체

변수 자리 표시자와 함께 동적 콘텐츠를 사용합니다.

  • %name=id% - 텍스트 변수
  • %url=id% - URL 변수
  • %short_url=id% - 단축 URL 변수

메시지 예약

향후 전달을 위한 메시지 예약:

{
  "scheduledTime": "2025-01-24T12:00:00Z"
}

TTL(수명)

메시지 만료 시간 설정:

{
  "ttl": 3600
}

메시지 유형

캐스케이드 API는 다음을 지원합니다.

  • 거래 - 주문 확인, 알림
  • 프로모션 - 마케팅 및 프로모션 메시지
  • Viber 설문조사 - 대화형 설문조사
  • 플래시 통화 - 전화 확인

응답 형식

성공적인 응답은 다음을 반환합니다.

[
  {
    "messageId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
    "trackinId": "tracking-string-id"
  }
]
  • messageId - 메시지 식별을 위한 GUID
  • trackinId - 배송 상태 추적을 위한 문자열

빠른 시작

  1. 메시지 보내기 - 연속 메시지 보내기 시작
  2. 메시지 변수 - 동적 콘텐츠 사용
  3. 메시지 유형 - 메시지 유형 살펴보기

요청 예시

{
  "messages": [
    {
      "recipient": "+380XXXXXXXXX",
      "text": "Hello %name=1%, your order #%url=2% is ready!",
      "variables": [
        {
          "id": 1,
          "value": "John"
        },
        {
          "id": 2,
          "value": "12345"
        }
      ]
    }
  ]
}

오류 처리

HTTP 상태 코드:

  • 200 OK - 요청 성공
  • 400 잘못된 요청 - 잘못된 요청 형식
  • 401 Unauthorized - 인증 실패
  • 429 요청이 너무 많습니다 - 속도 제한이 초과되었습니다.
  • 500 내부 서버 오류 - 서버 오류

혜택

단일 통합

모든 메시징 채널을 위한 하나의 API 통합 - 각 플랫폼을 별도로 통합할 필요가 없습니다.

자동 라우팅

스마트 라우팅은 각 수신자에게 가장 적합한 채널을 통해 메시지 전달을 보장합니다.

비용 최적화

Cascade는 저렴한 채널을 먼저 시도하고 필요한 경우에만 자동으로 더 비싼 옵션으로 돌아갑니다.

더 높은 배송율

다중 대체 채널을 사용하면 기본 채널에 장애가 발생하더라도 메시지가 수신자에게 전달됩니다.

다음 단계