---
title: "RCS 메시지 발송"
method: POST
path: "/v2/messages/rcs"
tags: ["RCS"]
---

# RCS 메시지 발송

`POST /v2/messages/rcs`

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

## Request body

- SendRcsMessageRequestDto
  - `type` 'RcsTSM' | 'RcsTLM' | 'RcsTMM', required — 메시지 종류 - RcsTSM: RCS 정보성 템플릿 - RcsTLM: RCS LMS 템플릿 - RcsTMM: RCS 이미지 템플릿
  - `from` string, required — 센드온에 등록된 발신 번호입니다. RBC 대화방 번호가 아닌 센드온에 등록된 발신 번호를 입력해주세요.
  - `to` union[], required — 수신받는 수신자의 전화 번호를 입력해주세요.
    - union
      - string
      - CsvInfo
        - `bucket` string, required — S3 Bucket Name
        - `key` string, required — S3 Object Key
  - `useCredit` boolean — 크레딧 우선사용 여부
  - `rbc` RbcConfig, required
    - `chatbotId` string, required — RBC 할당된 대화방 ID 입니다. (발신자 번호, RBC에 사전 등록된 ID만 허용, Max 40 Byte) - [RBC API](https://apidocs.rcsbizcenter.com/rbc-api/chatbot/get_chatbot_list) 를 통해 조회 가능
    - `messagebaseId` string, required — RBC 템플릿 목록 조회에서 얻은 템플릿 ID 입니다. (RBC에서 사전 정의된 값 또는 템플릿 ID, Max 40 Bytes) - [템플릿 목록 조회](https://apidocs.rcsbizcenter.com/rbc-api/template/get_template_list) - [템플릿 상세 조회](https://apidocs.rcsbizcenter.com/rbc-api/template/get_template_detail)
    - `header` '0' | '1', required — RBC 메시지를 정보성 또는 광고성이냐를 선택해야 합니다. (0: 정보성/템플릿, 1: 광고성) - 광고성 메시지일 경우 footer 입력 필수
    - `footer` string — 무료수신거부 전화번호를 입력합니다. 광고성 메시지일 경우 필수 입력합니다. - header 값이 1(광고성)이면 필수 입력
    - `expiryOption` 1 | 2 | 3 | 4 — 발송 종료 옵션을 선택합니다. 정해진 옵션 시간 동안 발송 시도하고 최종적으로 종료하게 됩니다. - 1: 1일간 시도 (default) - 2: 40초간 시도 - 3: 3분간 시도 - 4: 1시간 시도
    - `copyAllowed` boolean — 수신 단말의 메시지 복사 기능 허용여부를 선택합니다. - true: 허용 (default) - false: 허용 안함
    - `brandId` string, required — 대화방 ID(chatbotId)가 속한 브랜드 ID를 입력합니다. 브랜드 목록 조회 또는 브랜드 상세 조회를 통해 획득 후 입력해주세요. - [브랜드 목록 조회](https://apidocs.rcsbizcenter.com/rbc-api/brand/get_brand_list) - [브랜드 상세 조회](https://apidocs.rcsbizcenter.com/rbc-api/brand/get_brand_detail)
    - `brandKey` string, required — 대화방 ID(chatbotId)가 속한 브랜드 Key를 입력합니다. 기업 관리자 계정일 경우 브랜드 목록 조회 또는 브랜드 상세 조회를 통해 획득 후 입력해주세요. - 기업 관리자 계정일 경우 - 기업 계정일 경우 브랜드 목록 조회 또는 브랜드 상세 조회를 통해 brandKey 획득 후 입력 - [브랜드 목록 조회](https://apidocs.rcsbizcenter.com/rbc-api/brand/get_brand_list) - [브랜드 상세 조회](https://apidocs.rcsbizcenter.com/rbc-api/brand/get_brand_detail) - 대행사 계정일 경우 - 대행사 브랜드 목록 조회 확인 후 대행사 상세 조회안에 있는 brandKey 획득 후 입력 - [대행사 브랜드 목록 조회](https://apidocs.rcsbizcenter.com/rbc-api/agency/get_contract_list) - [대행사 브랜드 상세 조회](https://apidocs.rcsbizcenter.com/rbc-api/agency/get_brand_detail)
    - `agencyId` string, required — RBC에 등록된 메시지 발송 대행사 ID를 입력합니다. (RBC에서 브랜드-대행사간 권한 부여한 대행사 ID) - 센드온이 대행사일 경우: aligobiz 입력 - 다른 대행사일 경우: 해당 대행사 RBC ID 입력
    - `agencyKey` string, required — RBC에 등록된 메시지 발송 대행사 Key를 입력합니다. (RBC에서 브랜드-대행사간 권한 부여한 대행사 Key) - 기업 관리자 계정일 경우 - 대행사 브랜드 상세 조회 그리고 대행사 키 조회를 통해 agencyKey 획득 후 입력 - 대행사 계정일 경우 - RBC 대행사 계정 관리 > AgencyKey 입력 또는 대행사 키 조회를 통해 agencyKey 획득 후 입력 - [대행사 브랜드 상세 조회](https://apidocs.rcsbizcenter.com/rbc-api/agency/get_brand_detail) - [대행사 키 조회](https://apidocs.rcsbizcenter.com/rbc-api/agency/get_agency_key)
    - `campaignId` string — RBC에서 통계 조회시 활용할 발송 캠페인 단위 구분위해 사용하는 캠패인 ID를 입력합니다. 입력하지 않으면 임의 값으로 설정됩니다. - 입력한 campaignId 별로 RBC에서 통계 확인 가능 - [고객반응 통계](https://apidocs.rcsbizcenter.com/rbc-api/stat)
    - `osc` string — 최초 발신자 식별 코드를 입력합니다. (Max 9 Bytes) - 특수부가 사업자일 경우 입력 필수
    - `body` object, required — RBC에 등록된 템플릿에 따르는 발송 메시지의 내용을 입력합니다. - 템플릿 상세 조회 후 params 배열을 보고 body 객체를 채워주세요. - isMandatory 가 true 인 배열 아이템은 반드시 다음과 같은 규칙으로 body 객체에 입력해주세요. 입력하지 않으면 형식 에러가 발생합니다. - 배열 아이템의 param 키의 값이 body 객체 안에 키로 있어야 합니다. - 배열 아이템의 inputText 키의 값을 방금 추가한 키의 값으로 입력해주세요. - inputText 키의 값이 null 일 경우, "{{param 키의 값}}" 으로 입력해주세요. - isMandatory 가 false 인 배열 아이템은 입력하지 않아도 됩니다. - [템플릿 상세 조회](https://apidocs.rcsbizcenter.com/rbc-api/template/get_template_detail)
    - `clientId` string, required — RBC에 등록된 기업 관리자 계정 또는 대행사 계정의 ID를 입력합니다. - RBC에서 발급받은 클라이언트 ID
    - `clientSecret` string, required — RBC에 등록된 기업 관리자 계정 또는 대행사 계정의 API Key를 입력합니다. - RBC에서 발급받은 클라이언트 API Key
  - `useFallback` boolean — RCS 수신이 실패한 수신인에 대해 대체문자를 발송할지 설정합니다. RCS 메시지 발송 실패시 대체문자 발송 여부 (default: false)
  - `fallback` Fallback
    - `messageType` 'SMS' | 'LMS' | 'MMS', required — 대체문자 메시지 타입을 선택합니다. SMS, LMS, MMS 중 하나를 선택할 수 있습니다.
    - `from` string, required — 센드온에 등록된 발신 번호를 입력합니다.
    - `images` string[] — MMS 이미지 ID 리스트를 입력합니다.
    - `isAd` boolean — 광고성 메시지 여부를 선택합니다. 값이 true 이더라도 자동으로 광고표시, 수신거부번호를 자동으로 입력해주시 않습니다. true일 경우 반드시 광고표시, 수신거부 번호를 message 에 포함시켜서 발송해주세요.
    - `title` string — LMS, MMS 대체문자일 경우 제목을 입력합니다.
    - `message` string, required — 메시지 본문을 입력합니다.
    - `advertiserName` string — 대체 발신자 이름을 입력합니다.
    - `blockCall` BlockCall
      - `numberOf080` string — 080 수신거부번호를 입력합니다.
      - `pinNumber` string — 080 수신거부번호 인증번호를 입력합니다.
  - `blockCall` BlockCall
    - `numberOf080` string — 080 수신거부번호를 입력합니다.
    - `pinNumber` string — 080 수신거부번호 인증번호를 입력합니다.

## Response `200`

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

- SendMessageResponseDto
  - `code` number, required — HTTP 상태 코드입니다. 200이면 성공, 400대는 클라이언트 오류, 500대는 서버 오류를 나타냅니다.
  - `message` string, required — API 호출 결과에 대한 사람이 읽을 수 있는 메시지입니다. 성공 시 "성공", 실패 시 구체적인 오류 사유가 포함됩니다.
  - `data` SendMessage, required
    - `groupId` string, required — 메시지 발송 요청이 성공적으로 처리되어 생성된 그룹 ID입니다.

## Other responses

- `404` — 메시지 발송을 위해 등록된 발신번호가 없을 때 에러가 반환됩니다.

---

[API](https://skmtc.net/sendon/apis/sendon-api.md) · [All operations](https://skmtc.net/sendon/apis/sendon-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/sendon/sendon-api/revisions/525dedc81a05/schema)