RCS
RCS 메시지 발송 규격입니다.
미디어메시지 종류에 따라 3가지(standalone, carousel, template)로 전송 요청 할 수 있습니다.
요청할 메시지 종류에 맞는 format ID(RCS messagebaseId)입력이 필요합니다.
상세 Response 내용은 코드표를 참조해주시기 바랍니다.
RCS메시지 전송
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"))pyrequire "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_bodyRequest
Header
Body
Response
Header
Body
Schema
content
3개 필드 중 1개 필수(standalone, carousel, template)입니다.
subContent
RCS formatId(messagebaseId)
RCS button
9가지 형태의 버튼을 제공하며 각 버튼에 맞는 옵션 값 입력이 필요합니다.