v1

latestOpenAPI 3.0.2서비스 이용약관2026-07-265758331.1 KB

RCS

RCS 메시지 발송

RCS 타입의 메시지 발송합니다. 정보성 템플릿(RcsTSM), 장문형 템플릿(RcsTLM), 이미지형 템플릿(RcsTMM) 메시지를 지원합니다.

post/v2/messages/rcs

Request body

type'RcsTSM' | 'RcsTLM' | 'RcsTMM' required

메시지 종류

RcsTSM: RCS 정보성 템플릿
RcsTLM: RCS LMS 템플릿
RcsTMM: RCS 이미지 템플릿

fromstring required

센드온에 등록된 발신 번호입니다. RBC 대화방 번호가 아닌 센드온에 등록된 발신 번호를 입력해주세요.

useCreditboolean

크레딧 우선사용 여부

useFallbackboolean

RCS 수신이 실패한 수신인에 대해 대체문자를 발송할지 설정합니다. RCS 메시지 발송 실패시 대체문자 발송 여부 (default: false)

Example request

{
  "type": "RcsTSM",
  "from": "01012345678",
  "to": [
    "01012345678",
    "01012345679"
  ],
  "rbc": {
    "chatbotId": "chatbotId",
    "messagebaseId": "IBR.u720xwadx0-test20240620",
    "header": "0",
    "footer": "080-1234-5678",
    "expiryOption": 1,
    "copyAllowed": true,
    "brandId": "BR.t0TUXXXGnH",
    "brandKey": "BK.ilE21Z0C7XXXt2j",
    "agencyId": "aligobiz",
    "agencyKey": "SK.ilE21Z0C7XXXt2j",
    "campaignId": "CP.ilE21Z0C7XXXt2j",
    "osc": "301160021",
    "body": {
      "description1": "10월 15일부터 {{회원}}님만을 위한 이벤트가 시작됩니다.\n\n많은 관심 부탁드립니다."
    },
    "clientId": "nike",
    "clientSecret": "SK.ilE21Z0C7XXXt2j"
  },
  "fallback": {
    "messageType": "SMS",
    "from": "01012345678",
    "images": [
      "img_001",
      "img_002"
    ],
    "title": "title",
    "message": "message",
    "advertiserName": "advertiserName",
    "blockCall": {
      "numberOf080": "080-1234-5678",
      "pinNumber": "1234"
    }
  },
  "blockCall": {
    "numberOf080": "080-1234-5678",
    "pinNumber": "1234"
  }
}

Response

RCS 메시지 발송 요청이 성공적으로 처리되었습니다. 그룹 ID와 발송 상태 정보가 반환됩니다.

codenumber required

HTTP 상태 코드입니다. 200이면 성공, 400대는 클라이언트 오류, 500대는 서버 오류를 나타냅니다.

messagestring required

API 호출 결과에 대한 사람이 읽을 수 있는 메시지입니다. 성공 시 "성공", 실패 시 구체적인 오류 사유가 포함됩니다.

Example response

{
  "code": 200,
  "message": "성공",
  "data": {
    "groupId": "004a6217-f06c-40f6-8f39-bf35b3f76111"
  }
}