RCS 발송은 RCS_TYPE에 따라 발송 방식이 결정되며, 각 타입마다 필요한 파라미터가 다릅니다.
모든 RCS 발송은 아래의 공통 파라미터를 기본적으로 사용합니다.
| 파라미터 | 필수 | 설명 |
|---|---|---|
| BRAND_ID | O | RCS 브랜드 ID |
| RCS_TYPE | O | 발송 타입 |
| RCS_MSGBASE_ID | O | 메시지 폼(Message Base) ID |
| MSG_TYPE | O | I(정보성), A(광고성) |
| FOOTER | 조건부 | 광고성(MSG_TYPE=A)인 경우 무료수신거부 번호 필수 |
| REPLACE_VARS | 옵션 | 치환 변수(JSON) |
| BTN_OBJECT | 옵션 | 버튼 JSON |
| RCS_BTN_CNT | 옵션 | 버튼 개수 |
| RCS_BTN_TYPE | 옵션 | 버튼 저장 방식(F/D/V) |
RCS SMS 형태의 비승인형 텍스트 메시지입니다.
| 파라미터 | 설명 |
|---|---|
| RCS_TYPE | RCS_SMS |
| BRAND_ID | 브랜드 ID |
| RCS_MSGBASE_ID | RPSSAXX001 |
| RCS_TITLE | 제목 |
| RCS_MSG | 메시지 |
umsPotalParamVo.setRCS_TYPE("RCS_SMS"); // [고정값] RCS_SMS
umsPotalParamVo.setBRAND_ID("BR.pi3aH6xPxxx"); //RCS 브랜드 아이디
umsPotalParamVo.setRCS_MSGBASE_ID("RPSSAXX001"); // [고정값] RCS_SMS 메세지 폼 아이디.
umsPotalParamVo.setRCS_TITLE("RCS-SMS");
umsPotalParamVo.setRCS_MSG("통합 RCS-SMS #{PRODUCT} 테스트발송입니다.");
umsPotalParamVo.setREPLACE_VARS("{\"#{PRODUCT}\":\"냉장고\"}");
| ID | 설명 |
|---|---|
| RPSSAXX001 | 통합(삼성 + 아이폰, 정보성 전용) |
긴 텍스트를 발송하는 비승인형 LMS
| 파라미터 | 설명 |
|---|---|
| RCS_TYPE | RCS_LMS |
| BRAND_ID | 브랜드 ID |
| RCS_MSGBASE_ID | SL000000 또는 RPLSAXX001 |
| RCS_TITLE | 제목 |
| RCS_MSG | 내용 |
umsPotalParamVo.setRCS_TYPE("RCS_LMS"); // [고정값] RCS_LMS
umsPotalParamVo.setBRAND_ID("BR.pi3aH6xxxx"); //RCS 브랜드 아이디
umsPotalParamVo.setRCS_MSGBASE_ID("RPLSAXX001"); // [고정값] RCS_LMS 메세지 폼 아이디.
umsPotalParamVo.setRCS_TITLE("RCS-LMS#{고객번호}");
umsPotalParamVo.setRCS_MSG("RCS-LMS기본 템플릿 테스트발송입니다3.MSG#{고객번호}");
umsPotalParamVo.setREPLACE_VARS("{\"#{고객번호}\":\"1234\"}");
| ID | 설명 |
|---|---|
| RPLSAXX001 | 통합(정보성 전용) |
이미지 1장을 포함하는 MMS 발송
| 파라미터 | 설명 |
|---|---|
| RCS_TYPE | RCS_MMS |
| BRAND_ID | 브랜드 ID |
| RCS_MSGBASE_ID | MMS Base ID |
| RCS_TITLE | 제목 |
| RCS_MSG | 내용 |
이미 서버 또는 NAS에 등록된 이미지 사용
umsPotalParamVo.setRCS_TYPE("RCS_MMS"); // [고정값]
umsPotalParamVo.setBRAND_ID("BR.pi3aH6xP9K"); //RCS 브랜드 아이디
umsPotalParamVo.setRCS_MSGBASE_ID("RPMSMTX001"); // [고정값] RCS_MMS 메세지 폼 아이디. 둘 2 중 택 1(RPMSMTX001, RPMSMMX001)
umsPotalParamVo.setRCS_TITLE("RCS-MMS#{고객번호}");
umsPotalParamVo.setRCS_MSG("RCS-MMS기본 템플릿 테스트발송입니다3.MSG#{고객번호}");
// 이미지등록 방법: 서버에 이미 등록된 이미지(NAS 절대경로 or http Url) 사용 하는 방법(추천) : 현재 지원되는 폼은 이미지 한 개만 가능.
// 확인사항 : https는 안됨. 단, RCS 비즈센터 등록이미지 URL은 https => http로 호출하여 사용가능 함.
List<String> registedMmsImgs = new ArrayList<>();
registedMmsImgs.add("https://file-qa.rcsbizcenter.com/brand/BR.pi3aH6xP9K/template/LT-BR.pi3aH6xP9K-B5CPdc_1.png");
// registedMmsImgs.add("/server/snap-2025-09-03.03/nas/rcs/800800.png"); // 해당 위치는 LGU+ 에이전트가 접근 가능한 경로여야한다.
umsPotalParamVo.setRCS_MMS_IMAGES(registedMmsImgs);
HTTPS URL은 직접 사용하지 않습니다.
RCS BizCenter 등록 URL은 https → http 변환하여 사용 가능합니다.
| ID | 설명 |
|---|---|
| RPMSMTX001 | 통합 T형 |
| RPMSMMX001 | 통합 M형 |
브랜드별 자동 생성되는 FREE 템플릿
메시지를 동적으로 생성하여 발송
| 파라미터 | 설명 |
|---|---|
| RCS_TYPE | RCS_FREE |
| BRAND_ID | 브랜드 ID |
| RCS_MSGBASE_ID | FREE Template ID |
| RCS_TITLE | 제목 |
| RCS_MSG | 내용 |
umsPotalParamVo.setRCS_TYPE("RCS_FREE"); // [고정값] 통합 RCS FREE
umsPotalParamVo.setBRAND_ID("BR.B6cU4K6xxx"); // 운영 RCS 비즈센터 유라클 브랜드아이디
umsPotalParamVo.setRCS_MSGBASE_ID("UBR.B6cU4K6xxx-RPTFXXX001"); // 브랜드의 통합 프리 템플릿 messagebase ID는 RBC에 접속하여 템플릿 목록에서 확인
umsPotalParamVo.setRCS_OBJECT("{\"title\":\"FREE 테스트 발송\", \"description\": \"RCS-FREE 테스트발송입니다. 고객번호 : #{고객번호}\"}");
// 치환정보 #{...}로 처리. 해당 치환값은 REPLACE_VARS에 셋팅.
umsPotalParamVo.setREPLACE_VARS("{\"#{고객번호}\":\"NO1023\",\"#{장소}\":\"방배동\"}");
RCS BizCenter에 등록된 정보성 템플릿 발송
| 파라미터 | 설명 |
|---|---|
| RCS_TYPE | RCS_TMPLT |
| BRAND_ID | 브랜드 ID |
| RCS_MSGBASE_ID | Template MessageBase ID |
| RCS_TEMPL_ID | Template ID |
umsPotalParamVo.setRCS_TYPE("RCS_TMPLT"); // [고정값] 통합 정보성 템플릿
umsPotalParamVo.setBRAND_ID("BR.B6cU4K6kfr"); // 운영 RCS 비즈센터 유라클 브랜드아이디
umsPotalParamVo.setRCS_MSGBASE_ID("UBR.B6cU4K6xxx-iEDL7viNQ4Z5xf77CnNVmJcQ1"); // 브랜드의 통합 프리 템플릿 messagebase ID는 RBC에 접속하여 템플릿 목록에서 확인
umsPotalParamVo.setRCS_TEMPL_ID("iEDL7viNQ4Z5xf77CnNVmJcQ1"); // T_UMS_RCS_TEMPL 테이블 TEMPL_ID 컬럼 값 확인.
// 예제 : {"description":"#{이름}님 회원가입이 정상적으로 완료되었습니다.\n이제 UMS에서 SMS, 알림톡, RCS, PUSH 등 다양한 메시지를 발송해보세요.","title1":"회원가입완료"}
// 치환정보 #{...}로 처리. 해당 치환값은 REPLACE_VARS에 셋팅.
umsPotalParamVo.setREPLACE_VARS("{\"#{이름}\":\"홍길동\",\"#{장소}\":\"방배동\"}");
RCS BizCenter에 등록된 이미지 템플릿
| MessageBase | 설명 |
|---|---|
| RPISMTX001 | T형 |
| RPISMMX001 | M형 |
| 파라미터 | 설명 |
|---|---|
| RCS_TYPE | RCS_ITMPL |
| BRAND_ID | 브랜드 ID |
| RCS_MSGBASE_ID | Template MessageBase ID |
| RCS_TEMPL_ID | Template ID |
umsPotalParamVo.setRCS_TYPE("RPISMTX001"); // [고정] RCS_ITMPL
umsPotalParamVo.setBRAND_ID("BR.B6cU4K6kfr"); // 운영 RCS 비즈센터 유라클 브랜드아이디
umsPotalParamVo.setRCS_MSGBASE_ID("IBR.B6cU4K6kfr-QlcSw8nC0rg0HJ84ZB9p11o6j"); // 브랜드의 통합 프리 템플릿 messagebase ID는 RBC에 접속하여 템플릿 목록에서 확인
umsPotalParamVo.setRCS_TEMPL_ID("QlcSw8nC0rg0HJ84ZB9p11o6j"); // T_UMS_RCS_TEMPL 테이블 TEMPL_ID 컬럼 값 확인.
// 치환정보 #{...}로 처리. 해당 치환값은 REPLACE_VARS에 셋팅.
umsPotalParamVo.setREPLACE_VARS("{\"#{할인율}\":\"50%\",\"#{이벤트명}\":\"첫구매\",\"#{장소}\":\"방배동\"}");
umsPotalParamVo.setRCS_TYPE("RPISMTX001"); // [고정] RCS_ITMPL
umsPotalParamVo.setBRAND_ID("BR.B6cU4K6kfr"); // 운영 RCS 비즈센터 유라클 브랜드아이디
umsPotalParamVo.setRCS_MSGBASE_ID("IBR.B6cU4K6kfr-03t7TX4f0qGp3ji57hMp6f810"); // 브랜드의 통합 프리 템플릿 messagebase ID는 RBC에 접속하여 템플릿 목록에서 확인
umsPotalParamVo.setRCS_TEMPL_ID("03t7TX4f0qGp3ji57hMp6f810"); // T_UMS_RCS_TEMPL 테이블 TEMPL_ID 컬럼 값 확인.
// 치환정보 #{...}로 처리. 해당 치환값은 REPLACE_VARS에 셋팅.
// 예제 :{"description":"지금 가입하면\nSMS, LMS, MMS부터 알림톡, RCS, PUSH까지\n한 번에 발송 가능한 Morpheus UMS에서\n첫 구매 50% 할인 혜택을 드립니다.\n지금 바로 시작해보세요.","title":"신규회원 첫구매 이벤트!!","media":"maapfile://LT-BR.B6cU4K6kfr-lAXiE4"}
umsPotalParamVo.setREPLACE_VARS("{\"#{할인율}\":\"50%\",\"#{이벤트명}\":\"첫구매\"}");
최대 3개의 버튼을 지원합니다.
| 파라미터 | 설명 |
|---|---|
| BTN_OBJECT | 버튼 JSON |
| RCS_BTN_CNT | 버튼 개수 |
| RCS_BTN_TYPE | 버튼 저장 방식 |
[
{
"suggestions":[
{
"action":{
"urlAction":{
"openUrl":{
"url":"https://www.google.com"
}
},
"displayText":"버튼1",
"postback":{
"data":"set_by_chatbot_open_url"
}
}
}
]
}
]
| 값 | 설명 |
|---|---|
| F | 기본 버튼 |
| D | DB 저장 버튼 |
| V | 변수형 버튼 |
치환 변수는 모든 승인형 템플릿에서 공통 사용합니다.
JSON 형태입니다.
예제
{
"#{이름}":"홍길동",
"#{인증번호}":"123456",
"#{고객번호}":"A10001"
}
RCS BizCenter의
{{변수}}는 UMS에서는#{변수}형식으로 사용합니다.
광고성(MSG_TYPE=A) 발송 시
setFOOTER("0234794400");
무료 수신거부 번호를 반드시 입력해야 합니다.
| RCS_TYPE | Message Base ID |
|---|---|
| RCS_SMS | RPSSAXX001 |
| RCS_LMS | RPLSAXX001 |
| RCS_MMS | SRPMSMTX001 / RPMSMMX001 |
| RCS_FREE | UBR.브랜드아이디-RPTFXXX001 |
| RCS_TMPLT | RPTDXXX001 |
| RCS_ITMPL | RPISMTX001 / RPISMMX001 |
REPLACE_VARS를 사용하며 #{변수} 형식을 사용합니다.