Infobank OMNI API
  • Infobank OMNI API
  • 시작하기
  • API Reference
    • 개요
    • 인증
    • 관리
      • 메시지 폼
      • 이미지 파일
    • 전송(Simple)
      • 문자
      • 국제메시지
      • RCS
      • 카카오 비즈메시지
    • 전송(통합메시지)
    • 리포트
      • Polling
      • Webhook
      • 조회
    • 코드표
  • SUPPORT
    • SDKs
    • Tools
    • FAQ
    • 기술 문의
  • 개정 이력
Powered by GitBook

Copyright Infobank Corp. ALL right reserverd

On this page
  • RCS메시지 전송
  • Request
  • Response
  • Schema
  • Reference
  • Example
  1. API Reference
  2. 전송(Simple)

RCS

RCS 메시지 발송 규격입니다.

Last updated 15 days ago

  • RCS 옵션필드를 간편하게 발송 할 수 있는 심플 방식이 있습니다.

  • RCS 옵션필드를 이통사 규격을 사용할 수 있는 전문가 방식이 있습니다.

  • 미디어메시지 종류에 따라 3가지(standalone, carousel, template)로 전송 요청 할 수 있습니다.

  • 요청할 메시지 종류에 맞는 입력이 필요합니다.

  • 상세 Response 내용은 를 참조해주시기 바랍니다.

  • 요청전문 샘플은 를 참조해주시기 바랍니다.

RCS메시지 전송

POST /v1/send/rcs

Request

Header

Name
Type
Description

Authorization

String

발급받은 schema + “ “ + 발급받은 accessToken

Content-Type

String

application/json

Accept

String

application/json

Body

Name
Type
Required
Description

Object

NO

Object

NO

Object Array

NO

RCS 버튼-이통사 규격 (body 필드 사용 시 사용 가능)

from

String

YES

발신번호 (형식, 01012345678)

to

String

YES

수신번호 (형식, 01012345678)

String

YES

RCS 메시지 formatID

brandKey

String

YES

RCS 브랜드 키

brandId

String

NO

RCS 브랜드 ID

expiryOption

String(1)

NO

전송 time out설정 (Default: 1) (1: 24시간, 2: 40초, 3: 3분 10초, 4: 1시간)

header

String(1)

NO

메시지 상단 ‘광고’ 표출 여부 (Default: 0)

(0:미표출, 1:표출) 1인경우 footer 입력 필요

footer

String(100)

NO

메시지 하단 수신거부 번호

ref

String(200)

NO

Object

NO

실패 시 전송될 Fallback 메시지 정보

curl -X POST https://omni.ibapi.kr/v1/send/rcs \
-H "content-type: application/json" \
-H "Accept: application/json" \
-H "Authorization:Bearer 발급받은 토큰" \
-d '{"from": "발신번호", "to": "수신번호", "content": {"standalone": {"text": "메시지 내용"}},"formatId": "RCS 포맷ID", "ref": "참조필드", "brandKey":"RCS브랜드키"}' 
import java.io.*;
import okhttp3.*;
public class Main {
  public static void main(String []args) throws IOException{
    OkHttpClient client = new OkHttpClient().newBuilder()
      .build();
    MediaType mediaType = MediaType.parse("application/json");
    RequestBody body = RequestBody.create(mediaType, "{\"from\": \"발신번호\", \"to\": \"수신번호\", \"content\": {\"standalone\": {\"text\": \"메시지 내용\"}},\"formatId\": \"RCS 포맷ID\", \"ref\": \"참조필드\", \"brandKey\":\"RCS브랜드키\"}");
    Request request = new Request.Builder()
      .url("https://omni.ibapi.kr/v1/send/rcs")
      .method("POST", body)
      .addHeader("Content-Type", "application/json")
      .addHeader("Accept", "application/json")
      .addHeader("Authorization", "Bearer 발급받은 토큰")
      .build();
    Response response = client.newCall(request).execute();
    System.out.println(response.body().string());
  }
}
package main

import (
  "fmt"
  "strings"
  "net/http"
  "io/ioutil"
)

func main() {

  url := "https://omni.ibapi.kr/v1/send/rcs"
  method := "POST"

  payload := strings.NewReader(`{"from": "발신번호", "to": "수신번호", "content": {"standalone": {"text": "메시지 내용"}},"formatId": "RCS 포맷ID", "ref": "참조필드", "brandKey":"RCS브랜드키"}`)

  client := &http.Client {
  }
  req, err := http.NewRequest(method, url, payload)

  if err != nil {
    fmt.Println(err)
    return
  }
  req.Header.Add("Content-Type", "application/json")
  req.Header.Add("Accept", "application/json")
  req.Header.Add("Authorization", "Bearer 발급받은 토큰")

  res, err := client.Do(req)
  if err != nil {
    fmt.Println(err)
    return
  }
  defer res.Body.Close()

  body, err := ioutil.ReadAll(res.Body)
  if err != nil {
    fmt.Println(err)
    return
  }
  fmt.Println(string(body))
}
<?php

$curl = curl_init();

curl_setopt_array($curl, array(
  CURLOPT_URL => 'https://omni.ibapi.kr/v1/send/rcs',
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => '',
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 0,
  CURLOPT_FOLLOWLOCATION => true,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => 'POST',
  CURLOPT_POSTFIELDS =>'{"from": "발신번호", "to": "수신번호", "content": {"standalone": {"text": "메시지 내용"}},"formatId": "RCS 포맷ID", "ref": "참조필드", "brandKey":"RCS브랜드키"}',
  CURLOPT_HTTPHEADER => array(
    'Content-Type: application/json',
    'Accept: application/json',
    'Authorization: Bearer 발급받은 토큰'
  ),
));

$response = curl_exec($curl);

curl_close($curl);
echo $response;
var request = require('request');
var options = {
  'method': 'POST',
  'url': 'https://omni.ibapi.kr/v1/send/rcs',
  'headers': {
    'Content-Type': 'application/json',
    'Accept': 'application/json',
    'Authorization': 'Bearer 발급받은 토큰'
  },
  body: JSON.stringify({
    "from": "발신번호",
    "to": "수신번호",
    "content": {
      "standalone": {
        "text": "메시지 내용"
      }
    },
    "formatId": "RCS 포맷ID",
    "ref": "참조필드",
    "brandKey":"RCS브랜드키"
  })

};
request(options, function (error, response) {
  if (error) throw new Error(error);
  console.log(response.body);
});
var client = new HttpClient();
var request = new HttpRequestMessage(HttpMethod.Post, "https://omni.ibapi.kr/v1/send/rcs");
request.Headers.Add("Accept", "application/json");
request.Headers.Add("Authorization", "Bearer 발급받은 토큰");
var content = new StringContent("{\"from\": \"발신번호\", \"to\": \"수신번호\", \"content\": {\"standalone\": {\"text\": \"메시지 내용\"}},\"formatId\": \"RCS 포맷ID\", \"ref\": \"참조필드\", \"brandKey\":\"RCS브랜드키\"}", null, "application/json");
request.Content = content;
var response = await client.SendAsync(request);
response.EnsureSuccessStatusCode();
Console.WriteLine(await response.Content.ReadAsStringAsync());
var myHeaders = new Headers();
myHeaders.append("Content-Type", "application/json");
myHeaders.append("Accept", "application/json");
myHeaders.append("Authorization", "Bearer 발급받은 토큰");

var raw = JSON.stringify({
  "from": "발신번호",
  "to": "수신번호",
  "content": {
    "standalone": {
      "text": "메시지 내용"
    }
  },
  "formatId": "RCS 포맷ID",
  "ref": "참조필드",
  "brandKey":"RCS브랜드키"
});

var requestOptions = {
  method: 'POST',
  headers: myHeaders,
  body: raw,
  redirect: 'follow'
};

fetch("https://omni.ibapi.kr/v1/send/rcs", requestOptions)
  .then(response => response.text())
  .then(result => console.log(result))
  .catch(error => console.log('error', error));
import http.client
import json

conn = http.client.HTTPSConnection("omni.ibapi.kr")
payload = json.dumps({
  "from": "발신번호",
  "to": "수신번호",
  "content": {
    "standalone": {
      "text": "메시지 내용"
    }
  },
  "formatId": "RCS 포맷ID",
  "ref": "참조필드",
  "brandKey":"RCS브랜드키"
})
headers = {
  'Content-Type': 'application/json',
  'Accept': 'application/json',
  'Authorization': 'Bearer 발급받은 토큰'
}
conn.request("POST", "/v1/send/rcs", payload, headers)
res = conn.getresponse()
data = res.read()
print(data.decode("utf-8"))py
require "uri"
require "json"
require "net/http"

url = URI("https://omni.ibapi.kr/v1/send/rcs")

https = Net::HTTP.new(url.host, url.port)
https.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Content-Type"] = "application/json"
request["Accept"] = "application/json"
request["Authorization"] = "Bearer 발급받은 토큰"
request.body = JSON.dump({
  "from": "발신번호",
  "to": "수신번호",
  "content": {
    "standalone": {
      "text": "메시지 내용"
    }
  },
  "formatId": "RCS 포맷ID",
  "ref": "참조필드",
  "brandKey":"RCS브랜드키"
})

response = https.request(request)
puts response.read_body

Response

Header

Name
Type
Description

Content-Type

String

application/json

Body

Name
Type
Description

code

String(4)

API 호출 결과 코드

result

String

API 호출 결과 설명

msgKey

String

메시지 키

ref

String(200)

참조필드(요청 시 입력한 데이터)

{
    "code": "A000",
    "result": "Success",
    "msgKey": "발급된 메시지 키",
    "ref": "요청시 입력한 데이터"      
}
{
    "code": "A010",
    "result": "Cannot parse JSON"
} 
{
    "code": "A001",
    "result": "Expired token"
}
{
    "code": "A020",
    "result": "Rate limit exceeded"
}
{
    "code": "A999",
    "result": "Unknown error"
}

Schema

content

3개 필드 중 1개 필수(standalone, carousel, template)입니다.

Name
Type

standalone

Object

carousel

Object Array

template

Object

subContent

Name
Type
Description

subTitle

String

서브 소제목

subDesc

String

서브 소본문

subMedia

String

서브 이미지

subMediaUrl

String

서브 이미지 URL

body

Name
Type
Description

{key}

String/Object

RCS 표준 규격 전송 필드 ex) descrption, media 등

buttons

Name
Type
Description

suggestions

Object

RCS 표준 규격 버튼 필드

RCS formatId(messagebaseId)

Service
Code
Type
Specifications

RCS SMS

SS000000

Standalone

Image: none Title: none Text: 최대 100자 Card: 1장 Button: 1개

RCS LMS

SL000000

Standalone

Image: none Title: 최대 30자 Text: 최대 1,300자 Card: 1장 Button: 3개(최대 17자)Image: Tall(568*528) Title: 최대 30자 Text: 최대 1,300자 Card: 1장 Button: 3개(최대 17자)

RCS MMS

SMwThT00

Standalone Media Top

Image: Tall(568*528) Title: 최대 30자 Text: 최대 1,300자 Card: 1장 Button: 2개(최대 17자)

RCS MMS

SMwThM00

Standalone Media Top

Image: Medium(568*336) Title: 최대 30자 Text: 최대 1,300자 Card: 1장 Button: 2개(최대 17자)

RCS MMS CAROUSEL

CMwMhM0200

Carousel Medium

Image: Medium(696*504) 총합 1MB Title: 카드 별 최대 30자 Text: 총합 1,300자 Card: 2장 Button: 카드 별 2개(최대 13자)

RCS MMS CAROUSEL

CMwMhM0300

Carousel Medium

Image: Medium(696*504) 총합 1MB Title: 카드 별 최대 30자 Text: 총합 1,300자 Card: 3장 Button: 카드 별 2개(최대 13자)

RCS MMS CAROUSEL

CMwMhM0400

Carousel Medium

Image: Medium(696*504) 총합 1MB Title: 카드 별 최대 30자 Text: 총합 1,300자 Card: 4장 Button: 카드 별 2개(최대 13자)

RCS MMS CAROUSEL

CMwMhM0500

Carousel Medium

Image: Medium(696*504) 총합 1MB Title: 카드 별 최대 30자 Text: 총합 1,300자 Card: 5장 Button: 카드 별 2개(최대 13자)

RCS MMS CAROUSEL

CMwMhM0600

Carousel Medium

Image: Medium(696*504) 총합 1MB Title: 카드 별 최대 30자 Text: 총합 1,300자 Card: 6장 Button: 카드 별 2개(최대 13자)

RCS MMS CAROUSEL

CMwShS0200

Carousel Small

Image: Small(360*336) 총합 1MB Title: 카드 별 최대 30자 Text: 총합 1,300자 Card: 2장 Button: 카드 별 2개(최대 5자)

RCS MMS CAROUSEL

CMwShS0300

Carousel Small

Image: Small(360*336) 총합 1MB Title: 카드 별 최대 30자 Text: 총합 1,300자 Card: 3장 Button: 카드 별 2개(최대 5자)

RCS MMS CAROUSEL

CMwShS0400

Carousel Small

Image: Small(360*336) 총합 1MB Title: 카드 별 최대 30자 Text: 총합 1,300자 Card: 4장 Button: 카드 별 2개(최대 5자)

RCS MMS CAROUSEL

CMwShS0500

Carousel Small

Image: Small(360*336) 총합 1MB Title: 카드 별 최대 30자 Text: 총합 1,300자 Card: 5장 Button: 카드 별 2개(최대 5자)

RCS MMS CAROUSEL

CMwShS0600

Carousel Small

Image: Small(360*336) 총합 1MB Title: 카드 별 최대 30자 Text: 총합 1,300자 Card: 6장 Button: 카드 별 2개(최대 5자)

RCS MMS 이미지&타이틀 강조형

OMHITV0001

이미지&타이틀 강조형 3:4 Long

Image: 900*1200 Title: 최대 30자 Text: N/A Card: 1장 Button: 카드 별 2개(최대 16자) sub정보: 최대 1개

RCS MMS 이미지&타이틀 강조형

OMHITS0001

이미지&타이틀 강조형 1:1 Square

Image: 900*900 Title: 최대 30자 Text: N/A Card: 1장 Button: 카드 별 2개(최대 16자) sub정보: 최대 1개

RCS MMS 이미지 강조형

OMHIMV0001

이미지 강조형 3:4 Long

Image: 900*1200 Title: 최대 30자 Text: N/A Card: 1장 Button: 카드 별 2개(최대 16자) sub정보: N/A

RCS MMS 이미지 강조형

OMHIMS0001

이미지강조형 1:1 Square

Image: 900*900 Title: 최대 30자 Text: N/A Card: 1장 Button: 카드 별 2개(최대 16자) sub정보: N/A

RCS MMS 썸네일형

OMTBNV0001

썸네일형 세로

Image: 900*560 Title: 최대 30자 Text: 150자 Card: 1장 Button: 카드 별 2개(최대 16자) sub정보: 최대 2개

RCS MMS 썸네일형

OMTBNH0001

썸네일형 가로

Image: 900*560 Title: 최대 30자 Text: 150자 Card: 1장 Button: 카드 별 2개(최대 16자) sub정보: 최대 3개

RCS MMS SNS형

OMSNSS0001

SNS형

Image: 900*900 Title: 최대 30자 Text: 150자 Card: 1장 Button: 카드 별 2개(최대 16자) sub정보: N/A

RCS MMS SNS형

OMSNSH0001

SNS형 중간버튼

Image: 900*900 Title: 최대 30자 Text: 150자 Card: 1장 Button: 카드 별 2개(최대 16자) sub정보: N/A

FREE TEMPLATE (타이틀 자유형/선택형)

발급 된 Template ID

Free

Image: none Title: none Text: 최대 90자 Card: 1장 Button: 1개

DESCRIPTION TEMPLATE (타이틀 자유형/선택형)

발급 된 Template ID

Description

Image: none Title: 최대 8자 Text: 최대 90자 Card: 1장 Button: 2개

CELL TEMPLATE (타이틀 자유형/선택형)

발급 된 Template ID

Cell

Image: none Title: 최대 8자 Text: 최대 90자 Card: 1장 Button: 0~2개

IMAGE TEMPLATE (이미지&타이틀 강조형, 이미지 강조형, 썸네일형, SNS형)

발급 된 Template ID

Image

Image: 900*1200 또는900*900 또는 900*560, 상세Image: 300*300 Title: 최대 30자 Text: 최대 150자 상세Text: 최대 33자 Card: 1장 Button: 2개

RCS button

9가지 형태의 버튼을 제공하며 각 버튼에 맞는 옵션 값 입력이 필요합니다.

Button
Type
Description

URL 연결

Web page 또는 App으로 이동할 수 있습니다.

지도 보여주기

지정된 좌표로

설정된 지도 App을 실행합니다.

지도 검색

검색어를 통해

조회된 지도 App을 실행합니다.

위치 전송

휴대폰의 현재

위치 정보를 전송합니다.

일정 등록

정해진 일자와

내용으로 일정을 등록합니다.

복사하기

지정된 내용을

클립보드로 복사합니다.

대화방 열기 (문자)

메시지 App을

실행합니다.

대화방 열기 (음성, 영상)

메시지 App을

실행합니다.

전화 연결

특정 전화번호로 전화를 걸 수 있습니다.

fallback

Name
Type
Required
Description

type

String(3)

YES

Fallback 종류(SMS, MMS)

text

String(2000)

YES

Fallback 메시지 내용(최대 2,000byte)

title

String(40)

NO

Fallback 메시지 제목(최대 40byte)

fileKey

String Array

NO

Fallback 파일키(최대 3개)

originCID

String(9)

NO


Reference

최초 발신자 식별코드

최초 발신자 식별코드(originCID)

인터넷 문자 전송 시 최초 발신사업자를 특정하기 위해 삽입하는 식별코드이며, 특수한 유형의 부가통신사업자 등록번호(9자리 숫자)를 사용합니다.

최초 발신사업자가 재판매사업자이면 최초 재판매사업자 등록번호가 수록되고, 재판매사업자를 통하지 않고 문자중계사로 발송할 경우 문자중계사의 등록번호가 수록됩니다.

예1)기업 → 재판매사업자1 → 재판매사업자 2 → 문자중계사 → 이동통신사 재판매사업자1의 등록번호가 삽입

예2)기업 → 문자중계사 → 이동통신사 문자중계사의 등록번호가 삽입


Example

content

RCS content standalone Sample#1

요청전문(HTTP Body)

{
  "brandKey": "{{RCS_BRAND_KEY}}",
  "content": {
    "standalone": {
        "title":"제목없음",
        "text":"[인포뱅크]\n안녕하세요 RCS MMS 테스트 입니다.",
        "media":"{{RCS_FILE_KEY}}",
        "button":[
            {
                "name": "url버튼",
                "type": "URL",
                "url": "http://www.ibizplus.co.kr/consult/consult/request"
            }
        ]
    }
  },
  "fallback": {
    "title":"제목없음",
    "text": "fallback 메시지 입니다.",
    "fileKey":[
        "{{MMS_FILE_KEY}}"
    ],
    "type": "MMS"
  },
  "expiryOption": "2",
  "header": "1",
  "footer": "080-0000-0000",
  "formatId": "{{FORMAT_ID}}",
  "from": "031000000",
  "ref": "ref",
  "to": "{{PHONE_NUMBER}}"
}

전송화면

RCS content template Sample#2

요청전문(HTTP Body)

{
  "brandKey": "{{RCS_BRAND_KEY}}",
  "content": {
    "template": {
      "product":"냉장고",
      "value":"100"
    }
  },
  "fallback": {
    "text": "fallback",
    "type": "SMS"
  },
  "formatId": "{{FORMAT_ID}}",
  "from": "031000000",
  "ref": "ref",
  "to": "{{PHONE_NUMBER}}"
}

전송화면

RCS content template Sample#3

요청전문(HTTP Body)

{
  "brandKey": "{{RCS_BRAND_KEY}}",
  "content": {
    "template": {
      "description": "홍길동 고객님,\n계좌로 10,000 금액이 출금 되었습니다."
    }
  },
  "fallback": {
    "text": "fallback",
    "type": "SMS"
  },
  "formatId": "{{FORMAT_ID}}",
  "from": "0310000000",
  "ref": "ref",
  "to": "{{PHONE_NUMBER}}"
}

전송화면

RCS content carousel Sample#4

요청전문(HTTP Body)

{
    "brandKey": "{{BRAND_KEY}}",
    "content": {
        "carousel": [
            {
                "media": "{{MAPPFILE}}",
                "title": "더 길어지고 풍부해진 문자메시지, Biz RCS",
                "text": "딱딱한 문자 메시지에 \n카드 뷰, 버튼삽입, 프로필 사진까지 \n업그레이드된 Biz RCS로\n차별화된 메시지를 전송해 보세요.\n\n동일한 가격으로\nSMS, LMS, MMS, 카드형(Carousel) 메시지 포멧\n모두 활용 가능하고\n템플릿 등록하면,\n저렴한 가격으로 기본 메시지 포멧 외에도\n더 다양한 메시지 사용 가능합니다.",
                "button": [
                    {
                        "name": "url버튼",
                        "type": "URL",
                        "url": "http://www.ibizplus.co.kr/consult/consult/request"
                    }
                ]
            },
            {
                "media": "{{MAPPFILE}}",
                "text": "선택이 아닌 필수 문자 메시지 서비스 \n\"Biz RCS 메시지\"\n고객님께 적합한 서비스가 무엇인지 직접 확인해보세요."
            },
            {
                "media": "{{MAPPFILE}}",
                "title": "기업 브랜딩 신뢰할 수 있는 채널로 기업 홍보!",
                "text": "검증 프로세스를 통해서 인증 받은 메시지만\n전송 가능하기 때문에,\n기업 사칭 스팸 메시지 발송 불가",
                "button": [
                    {
                        "name": "전화연결",
                        "type": "DIAL",
                        "phoneNumber": "0310000000"
                    }
                ]
            }
        ]
    },
    "expiryOption": "2",
    "header": "1",
    "footer": "080-0000-0000",
    "formatId": "{{FORMAT_ID}}",
    "from": "0310000000",
    "ref": "ref",
    "to": "01000000000"
}
```

전송화면

body

RCS body carousel Sample#1

요청전문(HTTP Body)

{
    "brandKey": "{{RCS_BRAND_KEY}}",
    "body": {
        "title1": "캐로셀 제목 테스트 1",
        "description1": "케로셀 이통사규격 테스트 입니다.",
        "media1": "{{MAAPFILE1}}",
        "mediaUrl1": "{{MEDIAURL1}}",
        "title2": "캐로셀 제목 테스트 2",
        "description2": "케로셀 이통사규격 테스트 입니다.",
        "media2": "{{MAAPFILE2}}",
        "mediaUrl2": "{{MEDIAURL2}}"
    },
    "fallback": {
        "text": "fallback",
        "type": "SMS"
    },
     "expiryOption": "2",
    "header": "1",
    "formatId": "CMwMhM0200",
    "from": "0310000000",
    "ref": "ref",
    "to": "{{PHONE_NUMBER}}"
}

전송화면

RCS body carousel Sample#2

요청전문(HTTP Body)

{
    "brandKey": "{{RCS_BRAND_KEY}}",
    "body": {
        "title1": "캐로셀 제목 테스트 1",
        "description1": "케로셀 이통사규격 테스트 입니다.",
        "media1": "{{MAAPFILE1}}",
        "mediaUrl1": "{{MEDIAURL1}}",
        "title2": "캐로셀 제목 테스트 2",
        "description2": "케로셀 이통사규격 테스트 입니다.",
        "media2": "{{MAAPFILE2}}",
        "mediaUrl2": "{{MEDIAURL2}}",
        "title3": "캐로셀 제목 테스트 3",
        "description3": "케로셀 이통사규격 테스트 입니다.",
        "media3": "{{MAAPFILE3}}",
        "mediaUrl3": "{{MEDIAURL3}}"
    },
    "buttons": [
        {
            "suggestions": [
                {
                    "action": {
                        "urlAction": {
                            "openUrl": {
                                "url": "{{URL}}"
                            }
                        },
                        "displayText": "Open website or deep link",
                        "postback": {
                            "data": "set_by_chatbot_open_url"
                        }
                    }
                },
                {
                    "action": {
                        "urlAction": {
                            "openUrl": {
                                "url": "{{URL}}"
                            }
                        },
                        "displayText": "URL 버튼",
                        "postback": {
                            "data": "{{CHATBOT_OPEN_URL1}}"
                        }
                    }
                }
            ]
        },
        {
            "suggestions": [
                {
                    "action": {
                        "urlAction": {
                            "openUrl": {
                                "url": "{{URL}}"
                            }
                        },
                        "displayText": "URL 버튼",
                        "postback": {
                            "data": "{{CHATBOT_OPEN_URL2}}"
                        }
                    }
                }
            ]
        },
        {
            "suggestions": [
                {
                    "action": {
                        "urlAction": {
                            "openUrl": {
                                "url": "{{URL}}"
                            }
                        },
                        "displayText": "URL 버튼"
                    }
                }
            ]
        }
    ],
    "fallback": {
        "text": "fallback",
        "type": "SMS"
    },
    "expiryOption": "2",
    "header": "1",
    "footer": "080-0000-0000",
    "formatId": "CMwShS0300",
    "from": "0316281688",
    "ref": "ref",
    "to": "{{PHONE_NUMBER}}"
}

전송화면

RCS body LMS Sample#3

요청전문(HTTP Body)

{
    "brandKey": "{{RCS_BRAND_KEY}}",
    "body": {
        "mTitle": "RCS 사전예약 완료",
        "title": "홍길동 고객님,",
        "description": "📢 사전 예약 완료! 🎉\n\n고객님께 감사드립니다.\n사전 예약이 성공적으로 완료되었습니다.\n윙고를 기다려주셔서 진심으로 감사드립니다.\n\n사전 예약 혜택을 다시 확인해보세요:\n🔹 10% 할인가로 이용 가능\n🔹 1000포인트 추가 증정\n\n더 길고, 더 풍부해진 메시지로 한발 앞선 브랜드 홍보를 시작해 보세요.\n\n문자메시지와 동일한 가격에 더 많은 텍스트 수는\n기본, 버튼, 이미지, 동영상, 캐로셀까지 활용하여\n최적화된 메시지를 전달할 수 있습니다.\n\n빠른 시일 내에 서비스를 이용하실 수 있도록 최선을 다하겠습니다.\n\n더 많은 정보나 궁금한 점이 있으시면 언제든지 연락 주세요.\n다시 한 번 감사드립니다!"
    },
    "formatId": "{{FORMAT_ID}}",
    "from": "0310000000",
    "ref": "ref",
    "to": "01000000000"
}
```

전송화면

RCS body Sample#4

요청전문(HTTP Body)

{
    "brandKey": "{{RCS_BRAND_KEY}}",
    "body": {
        "mTitle": "11월 명세서",
        "title": "📢윙고에서 알려드립니다!",
        "cellLeft1": "자동납부",
        "cellLeft11": "결제금액",
        "cellLeft12": "결제일",
        "cellLeft13": "상세 내역은 아래 홈페이지 버튼을 눌러 로그인 후 명세서 확인 버튼을 눌러주세요.",
        "cellRight1": "스마일카드",
        "cellTitle1": "납부정보",
        "cellTitle2": "결제안내",
        "cellRight11": "10,000",
        "cellRight12": "25일",
        "description": "홍길동고객님,\n윙고를 사용해 주셔서 대단히 감사합니다.\n이번 달에는 얼마나 이용해주셨는지 확인해볼까요?"
    },
    "formatId": "{{FORMAT_ID}}",
    "from": "0310000000",
    "ref": "ref",
    "to": "01000000000"
}

전송화면

(content/body 중 하나는 필수 입력)

(content/body 중 하나는 필수 입력)

Name
Type
Description
Name
Type
Description
Name
Type
Description
Name
Type
Description
Name
Type
Description
Name
Type
Description
Name
Type
Description
Name
Type
Description
Name
Type
Description
Name
Type
Description
Name
Type
Description
Name
Type
Description

type

String

버튼 종류(URL)

name

String

버튼 명

url

String

웹브라우저로 연결할 URL주소

type

String

버튼 종류(MAP_LOC)

name

String

버튼 명

label

String

지도 App에 표시될 라벨명

latitude

String

위도 값(예)37.4001971

longitude

String

경도 값

(예)127.1071718

fallbackUrl

String

지도 App동작이 안 될 경우 대처할 URL

type

String

버튼 종류(MAP_QRY)

name

String

버튼 명

query

String

지도 App에서 검색할 구문

fallbackUrl

String

지도 App동작이 안 될 경우 대처할 URL

type

String

버튼 종류(MAP_SEND)

name

String

버튼 명

type

String

버튼 종류(CALENDAR)

name

String

버튼 명

startTime

String

시작 일정(yyyy-MM-dd’T’HH:mm:ssXXX)

endTime

String

종료 일정(yyyy-MM-dd’T’HH:mm:ssXXX)

title

String

일정 제목

description

String

일정 내용

type

String

버튼 종류(COPY)

name

String

버튼 명

text

String

클립보드로 복사될 내용

type

String

버튼 종류(COM_T)

name

String

버튼 명

phoneNumber

String

대화방의 수신자 번호

text

String

내용

type

String

버튼 종류(COM_V)

name

String

버튼 명

phoneNumber

String

대화방의 수신자 번호

type

String

버튼 종류(DIAL)

name

String

버튼 명

phoneNumber

String

전화 연결 할 수신자 번호

content
예제
body
예제
buttons
formatId
fallback
Fallback 최초 발신사업자 식별코드

text

String

RCS 내용

title

String

RCS 제목

media

String

미디어(maapfile://)

mediaUrl

String

클릭 시 랜딩 URL

(값이 '\' 경우 이미지 전체보기)

Object Array

버튼 정보

Object Array

서브 컨텐트 정보

text

String

RCS 내용

title

String

RCS 제목

media

String

미디어(maapfile://)

mediaUrl

String

클릭 시 랜딩 URL

(값이 '\' 경우 이미지 전체보기)

Object Array

버튼 정보

title

String

템플릿 제목

description

String

{key}

String

사전에 등록된 key, value(JSON)

Object Array

서브 컨텐트 정보

format ID(RCS messagebaseId)
예제

button
subContent
button
subContent
코드표