API

RCS

작성일 2026.03.01 | 수정일 2026.03.01

엔드포인트, 요청 본문, 응답 구조 등 자세한 정보는 메시지 발송 공통 문서에서 확인해주세요

RCS(Rich Communication Services)는 브랜드 로고, 고해상도 이미지, 버튼 링크 등으로 높은 참여를 유도하는 차세대 메시징 서비스입니다.

chat

RCS 발송 전 RCS Biz Center에서 브랜드 개설 및 대화방 등록이 필요합니다.
해당 브랜드 대화방에 등록된 발신번호와 동일한 번호로 발송해야 합니다.

RCS 메시지 타입

타입대체발송설명
RCS SMS지원RCS 단문 메시지
RCS LMS지원RCS 장문 메시지
RCS MMS지원RCS 이미지 첨부 메시지
RCS 템플릿미지원사전 등록 RCS 템플릿 기반 (정보성만 가능)
RCS 이미지 템플릿미지원이미지 포함 RCS 템플릿

공통 파라미터

NameTypeRequiredDescription
messages[].rcsOptions.brandIdStringtrueRCS 브랜드 ID
messages[].rcsOptions.templateIdStringRCS 템플릿 ID (템플릿 발송 시 필수)
messages[].rcsOptions.disableSmsBoolean대체발송 비활성화(기본값: false)
messages[].rcsOptions.buttonsArray바로가기 버튼 목록

예시

{
  "messages": [
    {
      "to": "01012345678",
      "from": "029302266",
      "text": "RCS 단문 메시지입니다.",
      "type": "RCS_SMS",
      "rcsOptions": {
        "brandId": "BRxxxxxxxxxxxxxxxx"
      }
    }
  ]
}
{
  "messages": [
    {
      "to": "01012345678",
      "from": "029302266",
      "text": "RCS 장문 메시지입니다...",
      "type": "RCS_LMS",
      "rcsOptions": {
        "brandId": "BRxxxxxxxxxxxxxxxx"
      }
    }
  ]
}
{
  "messages": [
    {
      "to": "01012345678",
      "from": "029302266",
      "text": "RCS MMS 메시지입니다.",
      "type": "RCS_MMS",
      "imageId": "FILEID000000000000",
      "rcsOptions": {
        "brandId": "BRxxxxxxxxxxxxxxxx"
      }
    }
  ]
}
{
  "messages": [
    {
      "to": "01012345678",
      "from": "029302266",
      "text": "RCS MMS 메시지입니다.",
      "type": "RCS_MMS",
      "imageId": "FILEID000000000000",
      "rcsOptions": {
        "brandId": "BRxxxxxxxxxxxxxxxx"
      }
    }
  ]
}
{
  "messages": [
    {
      "to": "01012345678",
      "from": "029302266",
      "type": "RCS_TPL",
      "rcsOptions": {
        "brandId": "BRxxxxxxxxxxxxxxxx",
        "templateId": "RCSTxxxxxxxxxxxxxxxx"
      }
    }
  ]
}

대체발송

RCS 발송에 실패하면 자동으로 문자(SMS/LMS)로 대체 발송됩니다.

  • rcsOptions.disableSms: false (기본값)

  • from: 사전 등록된 발신번호 명시

from 필드가 비어있거나 등록되지 않은 번호이면, 알림톡 실패 시 대체발송 없이 그대로 실패합니다.

자세한 내용은 TODO 대체발송 문서를 확인해주세요.