콘텐츠로 이동

SMSBAT API

SMSBAT는 Viber 캐러셀, Viber 의견 대화 상자, Viber 프로모션(사진, 비디오), Viber 비즈니스 채팅, OTP 알림(Viber OTP, 플래시 통화) 및 대체 변형을 포함한 다양한 유형의 메시지를 보내기 위한 RESTful API 플랫폼입니다.

기본 URL

SMSBAT API에 대한 요청은 현지화를 통해 엔드포인트로 전송됩니다. 관리자에게 미리 주소를 요청하세요.

예: https://restapi.smsbat.com(실제 URL은 지역에 따라 다를 수 있음)

인증

SMSBAT API는 세 가지 인증 방법을 지원합니다.

방법 1: HTTP 기본 인증

사용자 이름과 비밀번호 자격 증명을 사용하세요.

curl -X POST https://restapi.smsbat.com/bat/messagelist \
  -u "username:password" \
  -H "Content-Type: application/json" \
  -d @request.json

방법 2: API 키 헤더

'X-Authorization-Key' 헤더를 사용하세요.

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

방법 3: API 키를 비밀번호로 사용

사용자 이름으로 @를 사용하고 비밀번호로 API 키를 사용하세요.

curl -X POST https://restapi.smsbat.com/bat/messagelist \
  -u "@:your-api-key" \
  -H "Content-Type: application/json" \
  -d @request.json

사용 가능한 엔드포인트

방법 엔드포인트 설명
포스트 /bat/messagelist 메시지 보내기
받기 /bat/message/{messageId} 메시지 상태 확인

메시지 유형

SMSBAT API는 다음 메시지 유형을 지원합니다.

  • SMS - 표준 문자 메시지
  • Viber 프로모션 - 리치 미디어를 포함한 프로모션 메시지
  • Viber 거래 - 거래 알림
  • Viber 캐러셀 - 대화형 캐러셀 메시지
  • Viber 설문조사 - 의견 대화 메시지
  • Viber OTP - 일회용 비밀번호 알림
  • RCS - 리치 커뮤니케이션 서비스 메시지
  • 플래시 통화 - 무음 통화 확인

주요 기능

대체 메시징

기본 전송이 실패하면 SMSBAT는 자동으로 대체 채널로 대체됩니다.

Viber → SMS → Email

리치 미디어 지원

다음을 사용하여 메시지 보내기:

  • 이미지(JPG, PNG)
  • 동영상(MP4)
  • PDF
  • 버튼 및 작업 링크

메시지 상태 추적

실시간 배송 상태 추적:

  • 보냄
  • 배달됨
  • 읽기
  • 실패
  • 만료됨

콜백

양방향 통신을 위해 들어오는 Viber 메시지 콜백을 받습니다.

빠른 시작

  1. 메시지 보내기 - 첫 번째 메시지를 보내는 방법 알아보기
  2. 상태 확인 - 메시지 전달 상태 추적
  3. 메시지 유형 - 다양한 메시지 유형 살펴보기

요청 형식

모든 요청은 다음 구조의 JSON 형식을 사용합니다.

{
  "messages": [
    {
      "recipient": "+380XXXXXXXXX",
      "type": "viber",
      "text": "Your message here",
      // ... additional parameters
    }
  ]
}

응답 형식

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

{
  "messages": [
    {
      "messageId": "unique-message-id",
      "recipient": "+380XXXXXXXXX",
      "status": "sent"
    }
  ]
}

오류 처리

HTTP 상태 코드:

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

다음 단계