메시지 문자열은 KSC 5601(ISO 10646-1/Unicode1.1) 한글 코드에 정의된 문자열입니다.
메시지 타입(TRAN_TYPE)
사용자는 총 5 가지(SMS/MMS/AT/FT/RCS) 메시지 타입을 TRAN_TYPE 에 입력 가능합니다.
AT/FT/RCS 타입에 한하여 설정에 의하여 대체발송이 이루어진 경우, 해당 레코드가 메시지테이블에 추가로 생성되며 TRAN_TYPE 은 1/SMS, 2/MMS, 23/AT, 24/FT, 27/RCS 로 구분됩니다.
| 본문 발송 | 대체 발송 | |
| SMS | 4 | 1 |
| MMS | 6 | 2 |
| AT | 7 | 23 |
| FT | 8 | 24 |
| RCS | 11 | 27 |
발송 상태 변화(STATUS)
| 상태 | 내용 |
| 1 | 발송 요청 |
| 0 | DBRO 발송 준비 |
| 2 | DBRO 발송 후 결과 리포트 대기 |
| 3 | 결과 리포트 업데이트 |
| 6 | Client 대체발송 처리 |
발송 결과 확인(TRAN_RSLT)
발송 결과는 메시지 테이블의 TRAN_RSLT 컬럼으로 확인이 가능하며 “발송 결과 코드”의 상세 설명은 “VI. 발송결과코드” 항목을 참고하여 주시기 바랍니다.
대체 발송 타입(RE_TYPE)
알림톡/친구톡/RCS 은 전송결과에 대해 실패가 발생할 경우, 최대 2차 대체 발송이 가능합니다
단, 해당 서비스 아이디에 대해 대체발송 가능여부와 주체에 대한 설정이 되어있어야 합니다.
상세 설명은 발송쿼리 항목을 참고하여 주시기 바랍니다.
카카오 비즈 메시지 대체 발송 타입
| 메시지타입 | 1자 대체 | 2자 대체 | EM_TRAN_KKO RE_TYPE 필드 입력값 |
EM_TRAN_RCS RE-TYPE 필드 입력값 |
| 알림톡(AT), 친구록(FT) |
SMS | SMS | - | |
| MMS | MMS | - | ||
| RCS | R | - | ||
| RCS | SMS | R | SMS | |
| RCS | MMS | R | MMS | |
| 메시지타입 | 1차 대체 | 2자 대체 | EM_TRAN_RCS RE-TYPE 필드 입력값 |
EM_TRAN_KKO RE-TYPE 필드 입력값 |
| RCS | SMS | SMS | ||
| MMS | MMS | |||
| AT | K | |||
| AT | SMS | K | SMS | |
| AT | MMS | K | MMS | |
| FT | B | |||
| FT | SMS | B | SMS | |
| FT | MMS | B | MMS |
SMS (텍스트 90byte 이하의 단문 메시지)
INSERT INTO EM_TRAN
(TRAN_PHONE, TRAN_CALLBACK, TRAN_STATUS, TRAN_DATE, TRAN_MSG, TRAN_TYPE)
VALUES (‘01000000000’, ‘01000000000’, ‘1’, NOW(), ‘Test Message 입니다’, 4)
MMS
텍스트 2000byte 이하, 이미지 60kb 이하 등 멀티미디어를 같이 보내는 메시지
TXT
INSERT INTO EM_TRAN_MMS
(FILE_CNT, MMS_BODY, MMS_SUBJECT) VALUES (1, ‘본문 내용’, ‘메시지 제목’);
INSERT INTO EM_TRAN
(TRAN_PHONE, TRAN_CALLBACK, TRAN_STATUS, TRAN_DATE, TRAN_TYPE, TRAN_ETC4)
VALUES (‘01000000000’, ‘01000000000’, ‘1’, NOW(), 6, {EM_TRAN_MMS 의 MMS_SEQ 값})
IMG + TXT
INSERT INTO EM_TRAN_MMS (FILE_CNT, MMS_BODY, MMS_SUBJECT, FILE_NAME1)
VALUES (1, ‘본문 내용’, ‘메시지 제목’, ‘D:/spool/mms.jpg’);
INSERT INTO EM_TRAN(TRAN_PHONE, TRAN_CALLBACK,
TRAN_STATUS, TRAN_DATE, TRAN_TYPE, TRAN_ETC4)
VALUES (‘01000000000’, ‘01000000000’, ‘1’, NOW(), 6, {EM_TRAN_MMS 의 MMS_SEQ 값});
AT 발송
알림톡은 사전에 발급된 발신 프로필 키와 미리 등록된 템플릿 코드를 통하여, 알림톡 발송이 가능합니다. 실제 발송할 메시지 유형으로 등록된 템플릿 형식에 맞춰 메시지를 입력하여야 합니다.
INSERT INTO EM_TRAN_KKO(SENDER_KEY, TEMPLATE_CODE, NATION_CODE, MESSAGE)
VALUES ({발신 프로필 키}, {템플릿 코드}, '82', 'AT 테스트입니다');
INSERT INTO EM_TRAN(TRAN_PHONE, TRAN_CALLBACK,
TRAN_STATUS, TRAN_DATE, TRAN_TYPE, TRAN_ETC4)
VALUES ('01000000000', '01000000000', '1', NOW(), 7, {EM_TRAN_KKO 의 KKO_SEQ 값});
FT 발송
친구톡은 발신 프로필 키를 사용하여 발송되며, 카카오톡 사용자이고 발신프로필(카카오톡 채널)과 친구일 경우 발송 가능합니다.
INSERT INTO EM_TRAN_KKO (SENDER_KEY, NATION_CODE, MESSAGE)
VALUES ({발신 프로필 키}, '82', 'FT 테스트입니다');
INSERT INTO EM_TRAN
(TRAN_PHONE, TRAN_CALLBACK, TRAN_STATUS, TRAN_DATE, TRAN_TYPE, TRAN_ETC4)
VALUES ('01000000000', '01000000000', '1', NOW(), 8, {EM_TRAN_KKO 의 KKO_SEQ 값});
AT/FT + ATTACHMENT 발송
알림톡/친구톡은 링크 버튼을 첨부하거나 추가 파라미터를 포함하여 발송할 수 있습니다. JSON 형식 파일을 생성 후 파일 경로를 입력합니다.
버튼 및 추가 파라미터가 등록된 템플릿코드만 사용가능합니다
AT + ATTACHMENT
INSERT INTO EM_TRAN_KKO(
SENDER_KEY, TEMPLATE_CODE, NATION_CODE, MESSAGE, ATTACHED_FILE_1)
VALUES (
{발신 프로필 키}, {템플릿 코드}, '82', 'AT 테스트입니다', ‘D:/spool/add_info.json’);
INSERT INTO EM_TRAN(
TRAN_PHONE, TRAN_CALLBACK, TRAN_STATUS, TRAN_DATE, TRAN_TYPE, TRAN_ETC4)
VALUES (
'01000000000', '01000000000', '1', NOW(), 7, {EM_TRAN_KKO 의 KKO_SEQ 값});
FT + ATTACHMENT
INSERT INTO EM_TRAN_KKO(
SENDER_KEY, NATION_CODE, MESSAGE, ATTACHED_FILE_1)
VALUES (
{발신 프로필 키}, '82', 'AT 테스트입니다', ‘D:/spool/add_info.json’);
INSERT INTO EM_TRAN(
TRAN_PHONE, TRAN_CALLBACK, TRAN_STATUS, TRAN_DATE, TRAN_TYPE, TRAN_ETC4)
VALUES (
'01000000000', '01000000000', '1', NOW(), 8, {EM_TRAN_KKO 의 KKO_SEQ 값});
ATTACHMENT FIELDS
| 키 | 타입 | 필수 | 설명 | ||
| button | array | - | 버튼 목록 | ||
| name | text(14) | Y | 버튼 제목 * 'AC 타입인 경우 '채널 추가'로 고성 | ||
| type | Text(2) | Y | 버튼 타입 (아래 타입 별 속성 표 참고) | ||
| url_pc | text | - | pc 환경에서 버튼 클릭 시 이동할 | ||
| url _mobile | text | - | Mobile 환경에서 버튼 클릭 시 이동활 URL | ||
| scheme_ios | text | - | Mobile ios 환경에서 버튼 클릭 시 실행할 AppIication Custom Scheme |
||
| scheme_android | text | - | Mobile Android 환경에서 버튼 클릭 시 실행할 AppIication Custom Scheme |
||
| chat extra | text(50) | - | 상담톡/봇 전환 시 전달할 메타정보 | ||
| chat event | text(50) | - | 봇 전환 시 연결할 봇 이벤트명 | ||
| plugin. id | text(24) | - | 플러그인 ID | ||
| relay_id | text | - | 플러그인 실행시 X-Kakao Plugin-Relay ld 헤더를 통해 전달 받을 값 |
||
| oneclick id | text | - | 원클릭 결제 플러그인이서 사용하는 결제 정보 | ||
| product_id | text | - | 원를릭 결제 플러그인이서 사용하는 결제 정보 | ||
| image | json | N | 친구톡 이미지 | ||
| Img_url | Text | Y | 노출할 이미지 *친구특 이미지(와이드) 발송 시 필수입력 |
||
| Img. link | text | N | 이미지 클릭시 이동활 url 미설정시 카카오톡 내 이미지 뷰어 사용 |
||
| item_highlight | json | N | 아이템 하이라이트 | ||
| title | text(30) | Y | 타이를 (이미지가 있는 경우 최대 21자) | ||
| description | text(19) | Y | 부가정보 (이미지가 있는 경우 최대 14자) | ||
| item | json | N | 아이템리스트와 아이템 요약정보 | ||
| list | array | Y | 아이템리스트 | ||
| title | text(6) | Y | 타이틀 | ||
| description | text(23) | Y | 부가정보 | ||
| summary | jon | N | 아이템 요약정보 | ||
| title | text(6) | Y | 타이를 | ||
| description | text(14) | Y | 가격정보 * 허용되는 문자: 통화기호(유니코트 통화가치 元, 円, 원) 통화코드(ISO 4217), 숫자, 콤마, 소수점, 공백 * 소수점 2자리까지 허용 |
||
| extra | json | - | 추가 기능 | ||
| msg._type | text | 카카오 발송 유형 * 알림톡 이미지 발송 시 필수입력 |
|||
| title | text(50) | 템플릿 내용 중 강조 표기할 핵심 정보 | |||
| supplement | json | 메시지에 첨부할 바로연결 * supplement 참조 |
|||
| price | number | 모먼트 광고 전환 최적화 전용 메시지 내 포함된 가격/금액/결제금액 |
|||
| currency_type | text(3) | 모먼트 광고 전한 최적화 전용 메시지 내 포함된 가격/금액/결제금액의 통화단위 KRW, USD, EUR 등 국제 통화 코드 사용 |
|||
| header | text(16) | 메시지 상단에 표기할 제목 |
{
"button": {
/* array *//* 버튼 목록 */
"name": {},
/* text(14) *//* 버튼 제목 ‘AC’ 타입인 경우 ‘채널 추가’로 고정*/
"type": {},
/* text(2) *//* 버튼 타입(아래 타입 별 속성 표 참조) */
"url_pc": {},
/* text *//* pc 환경에서 버튼 클릭 시 이동할 */
"url_mobile": {},
/* text *//* Mobile 환경에서 버튼 클릭 시 이동할 URL */
"scheme_ios": {},
/* text *//* Mobile iOS 환경에서 버튼 클릭 시 실행할 Application Custom Scheme */
"scheme_android": {},
/* text *//* Mobile Android 환경에서 버튼 클릭 시 실행할 Application Custom Scheme */
"chat_extra": {},
/* text(50) *//* 상담톡/봇 전환 시 전달할 메타정보 */
"chat_event": {},
/* text(50) *//* 봇 전환 시 연결할 봇 이벤트명 */
"plugin_id": {},
/* text(50) *//* 플러그인 ID */
"relay_id": {},
/* text *//* 플러그인 실행시 X-Kakao-Plugin-Relay-Id 헤더를 통해 전달 받을 값 */
"oneclick_id": {},
/* text *//* 원클릭 결제 플러그인에서 사용하는 결제 정보 */
"product_id": {}
/* text *//* 원클릭 결제 플러그인에서 사용하는 결제 정보 */
},
"image": {
/* JSON *//* 친구톡 이미지 */
"Img_url": {},
/* text *//* 노출할 이미지 친구톡 이미지(와이드) 발송 시 필수입력 */
"Img_link": {}
/* text *//* 이미지 클릭시 이동할 url - 미설정시 카카오톡 내 이미지 뷰어 사용*/
},
"item_highlight": {
/* JSON *//* 아이템 하이라이트 */
"title": {},
/* text(30) *//* 타이틀 (이미지가 있는 경우 최대 21자) */
"description": {}
/* text(19) *//* 부가정보 (이미지가 있는 경우 최대 14자) */
},
"item": {
/* JSON *//* 아이템 리스트와 아이템 요약정보 */
"list": {
/* array *//* 아이템리스트 */
"title": {},
/* text(6) *//* 타이틀 */
"description": {}
/* text(23) *//* 부가정보 */
},
"summary": {
/* JSON *//* 아이템 요약정보 */
"title": {},
/* text(6) *//* 타이틀 */
"description": {}
/* text(14) *//* 가격정보
* 허용되는 문자: 통화기호(유니코드 통화기호, 元, 円, 원),
통화코드(ISO 4217), 숫자, 콤마, 소수점, 공백
* 소수점 2자리까지 허용 */
}
},
"expansion": {
/* JSON *//* 추가 기능 */
"msg_type": {},
/* text *//* 카카오 발송 유형 - 알림톡 이미지 발송 시 필수입력 */
"title": {},
/* text(50) *//* 템플릿 내용 중 강조 표기할 핵심 정보 */
"supplement": {
/* json *//* 메시지에 첨부할 바로연결 */
"quick_reply": {
"name": {},
/* text(14) *//* 바로연결 제목 */
"type": {},
/* text(2) *//* 바로연결 타입 */
"scheme_android": {},
/* text *//* mobile android 환경에서 바로연결 클릭 시 실행할 application custom scheme */
"scheme_ios": {},
/* text *//* mobile ios 환경에서 바로연결 클릭 시 실행할 application custom scheme */
"url_mobile": {},
/* text *//* mobile 환경에서 바로연결 클릭 시 이동할 url */
"url_pc": {},
/* text *//* pc 환경에서 버튼 클릭 시 이동할 url */
"chat_extra": {},
/* text(50) *//* 상담톡/봇 전환 시 전달할 메타정보 */
"chat_event": {}
/* text(50) *//* 봇 전환 시 연결할 봇 이벤트명 */
}
},
"price": {},
/* number *//* 모먼트 광고 전환 최적화 전용 */
"currency_type": {},
/* text(6) *//* 모먼트 광고 전환 최적화 전용
메시지 내 포함된 가격/금액/결제금액의 통화단위
KRW, USD, EUR 등 국제 통화 코드 사용 */
"header": {}
/* text(6) *//* 메시지 상단에 표기할 제목 */
}
}
Supplement
| 키 | 타입 | 필수 | 설명 | |
| quick_reply | name | text(14) | Y | 바로연결 제목 |
| type | text(2) | Y | 바로연결 타입 | |
| scheme_android | text | - | mobile android 환경에서 바로연결 클릭 시 실행할 appllcatlon custom scheme |
|
| scheme_ios | text | - | moblle ios 환경에서 바로연결 클릭 시 실행할 application custom scheme |
|
| url mobile | text | - | mobile 환경에서 바로연결 클릭 시 이동할 url | |
| url_pc | text | - | pc 환경에서 버튼 클릭 시 이동할 url | |
| chat_extra | text(50) | - | 상담톡/봇 전환 시 전달할 메타정보 | |
| chat_event | text(50) | - | 봇 전환 시 연결할 봇 이벤트명 |
AT/FT + BUTTON
알림톡/친구톡은 링크 버튼을 첨부하여 발송할 수 있으며, 버튼 타입은 아래와 같습니다.
| 타입 | 기능 |
| 배송조회 | 메시지 내용에서 택배사명과 송장 번호를 파싱하여 카카오 검색 조회하기 버튼을 자동으로 생성함 |
| 웹 링크 | 버튼 클릭 시 인얩 브라우저에서 웹 페이지 실행 Mobile / PC에서 실행할 URL을 각각 설정 가능 *현재 알림톡은 PC에서 메시지 내용이 보이지 않음 |
| 앱 링크 | 버튼 클릭 시 앱 커스텀스킴 실행 Android /|os에서 실행할 커스텀스킴 각각 설정 필수 |
| 봇 키워드 | 버튼 클릭 시 유저로부터 '버튼 명'이 텍스트로 들어간 챗버블이 발송됨 봇 또는 상담원에게 유저의 액션을 전달할 때 사용할 수 있음 |
| 메시지전달 | 버튼 클릭 시 유저로부터 '버튼 명+메시지 본문'이 텍스트로 들어간 챗버블이 발송됨 봇 또는 상담원에게 유저가 수신한 알림톡과 함께 유저의 액션을 전달할 경우 사용 |
| 채널 추가 | 카카오톡 채널 추가 버튼 활성화 |
| 상담톡 전환 | 버튼 클릭 시 상담톡으로 전환 상담톡을 이용하는 카카오톡 채널만 이용 가능 |
| 봇 전환 | 버튼 클릭 시 봇으로 전환 카카오 | 오픈빌더의 챗봇을 사용하는 카카오톡 채널만 이용 가능 |
| 플러그인 | 버튼 클릭 시 플러그인 제공 이미지 보안 전송 플러그인, 개인정보이용 플러그인, 원클릭 결제 플러그인 |
AT/FT + BUTTON
알림톡/친구톡은 링크 버튼을 첨부하여 발송할 수 있으며, 버튼 타입은 아래와 같습니다.
(버튼은 최대 5개 등록 가능하나 바로연결과 함께 사용 시 2개로 제한됩니다.)
버튼 타입
| 타입 | 기능 |
| 배송조회 | 메시지 내용에서 택배사명과 송장 번호를 파싱하여 카카오 검색 조회하기 버튼을 자동으로 생성함 |
| 웹 링크 | 버튼 클릭 시 인얩 브라우저에서 웹 페이지 실행 Mobile / PC에서 실행할 URL을 각각 설정 가능 *현재 알림톡은 PC에서 메시지 내용이 보이지 않음 |
| 앱 링크 | 버튼 클릭 시 앱 커스텀스킴 실행 Android /|os에서 실행할 커스텀스킴 각각 설정 필수 |
| 봇 키워드 | 버튼 클릭 시 유저로부터 '버튼 명+메시지 본문'이 텍스트로 들어간 챗버블이 발송됨 봇 또는 상담원에게 유저의 액션을 전달할 때 사용할 수 있음 |
| 메시지전달 | 버튼 클릭 시 유저로부터 '버튼 명+메시지 본문'이 텍스트로 들어간 챗버블이 발송됨 봇 또는 상담원에게 유저의 액션을 전달할 때 사용할 수 있음 |
| 채널 추가 | 카카오톡 채널 추가 버튼 활성화 |
| 상담톡 전환 | 버튼 클릭 시 상담톡으로 전환 상담톡을 이용하는 카카오톡 채널만 이용 가능 |
| 봇 전환 | 버튼 클릭 시 봇으로 전환 카카오 | 오픈빌더의 챗봇을 사용하는 카카오톡 채널만 이용 가능 |
| 플러그인 | 버튼 클릭 시 플러그인 제공 이미지 보안 전송 플러그인, 개인정보이용 플러그인, 원클릭 결제 플러그인 |
버튼 타입 별 속성
| 버튼 타입 | 속성 | 타입 | 필수 | 설명 | |
| 웹링크 | WL | url_mobile | text | Y | 버튼 클릭 시 이동할 pc/mobile환경별 web url |
| url-pc | text | N | |||
| 얩링크 | AL | scheme iOS, scheme android, url mobile 중 2가지 필수 입력 | |||
| scheme_ios | text | - | 버튼 클릭 시 실행할 OS별 Application Custom Scheme | ||
| scheme android | text | - | |||
| url_mobile | text | - | mobile 환경에서 버튼 클릭 시 이동할 url | ||
| url-pc | text | N | pc 환경에서 버튼 클릭 시 이동할 url | ||
| 얩링크 | DS | - | - | - | 버튼 클릭 시 배송조회 페이지로 이동 |
| 봇 키워드 | BK | - | - | - | 해당 버튼 텍스트 전송 |
| 메시지 전달 | MD | - | - | - | 버튼 클릭 시 배송조회 페이지로 이동 |
| 채널 추가 | AC | - | - | - | 버튼 클릭 시 카카오톡 채널 추가 ※ 버튼은 단독 또는 첫번째 요소이어야 함 |
| 상담톡 전환 | BC | 상담톡을 이용하는 카카오톡 채널만 이용가능 | |||
| chat extra | text | N | 상담톡 전환 시 전달할 메타정보 | ||
| 봇 전환 | BT | 카카오 | 오픈빌더의 챗봇을 사용하는 카카오톡 채널만 이용가능 | |||
| chat extra | text | N | 봇 전환 시 전달할 메타정보 | ||
| chat event | text | N | 봇 전환 시 연결할 봇 이벤트명 | ||
| 플러그인 | P1 | - | - | - | 이미지 보안 전송 플러그인 |
| P2 | - | - | - | 개인정보이용 플러그인 | |
| P3 | - | - | - | 원클릭 결제 플러그인 (발송시 oneclick-id 또는 product-id를 필수로 전달해아 함) |
|
AT + 바로연결
알림톡 바로연결이란?
-
알림톡 하단에 가로 슬라이드 형태로 표시되며 웹/앱 연결, 상담톡 전환 등을 호출하는 기능
-
상담톡 또는 챗봇을 사용하는 발신프로필만 이용 가능
-
바로연결은 최대 10개까지 사용 가능, 사용 시 버튼 개수는 2개로 제한 *(챗봇, 상담톡 사용 채널에만 한해 사용 가능합니다.)
AT + 바로연결 타입별 속성
| 버튼 타입 | 속성 | 타입 | 필수 | 설명 | |
| 웹링크 | WL | url_mobile | text | Y | 바로연결 클릭 시 이동할 pc/mobile환경별 web url |
| url-pc | text | N | |||
| 얩링크 | AL | scheme iOS, scheme android, url mobile 중 2가지 필수 입력 | |||
| scheme_ios | text | - | 바로연결 클릭 시 실행할 OS별 Application Custom Scheme | ||
| scheme android | text | - | |||
| url_mobile | text | - | mobile 환경에서 바로연결 클릭 시 이동할 url | ||
| url-pc | text | N | pc 환경에서 바로연결 클릭 시 이동할 url | ||
| 봇 키워드 | BK | - | - | - | 해당 바로연결 텍스트 전송 |
| 메시지 전달 | MD | - | - | - | 해당 바로연결 텍스트 + 메시지 본문 전송 |
| 상담톡 전환 | BC | 상담톡을 이용하는 카카오톡 채널만 이용가능 | |||
| chat extra | text | N | 상담톡 전환 시 전달할 메타정보 | ||
| 봇 전환 | BT | 카카오 | 오픈빌더의 챗봇을 사용하는 카카오톡 채널만 이용가능 | |||
| chat extra | text | N | 봇 전환 시 전달할 메타정보 | ||
| chat event | text | N | 봇 전환 시 연결할 봇 이벤트명 | ||
바로연결 첨부파일 예시
알림톡 본문 하단에 바로연결 표기 내용을 add_info1~2.json 파일에 아래 내용을 추가합니다.
add_info1.json
버튼이 없고, 알림톡 바로연결 (웹링크/봇키워드/메시지전달/상담톡전환)이 있는 템플릿의 경우
{
"expansion": {
"supplement": {
"quick_reply": [
{
"type": "WL",
"name": "비즈뿌리오",
"url_mobile": "https://www.bizppurio.com/"
},
{
"type": "BK",
"name": "봇키워드하기"
},
{
"type": "MD",
"name": "메시지전달하기"
},
{
"type": "BC",
"name": "상담톡전환"
}
]
}
}
}
add_info2.json
버튼이 있고, 알림톡 바로연결 (웹링크/봇키워드/메시지전달/상담톡전환)이 있는 템플릿의 경우
{
"button": [
{
"type": "WL",
"name": "비즈뿌리오 바로가기",
"url_mobile": "https://www.bizppurio.com/"
}
],
"expansion": {
"supplement": {
"quick_reply": [
{
"type": "WL",
"name": "비즈뿌리오",
"url_mobile": "https://www.bizppurio.com/"
},
{
"type": "BK",
"name": "봇키워드하기"
},
{
"type": "MD",
"name": "메시지전달하기"
},
{
"type": "BC",
"name": "상담톡전환"
}
]
}
}
}
AT + 이미지, 아이템 리스트
이미지와 구조화된 목록이 포함된 알림톡
-
기존 텍스트 알림톡 기본형에 (이미지 / 헤더 / 아이템 하이라이트 / 아이템리스트 / 아이템 요약정보) 5가지 항목이 추가로 구성
-
이미지, 헤더, 아이템 하이라이트 영역을 필요에 따라 1 개 이상 필수 선택하여 템플릿 등록
-
템플릿 당 고정된 이미지만 사용 가능
-
아이템리스트는 최소 2개 이상 최대 10개 항목으로 구성 가능 (알림톡 템플릿 강조 유형이 이미지형(IMAGE) 인 경우에만 msg_type 을 ai 로 설정해주셔야 발송 가능합니다.) (ex. 알림톡 템플릿 강조 유형이 아이템리스트형이고 이미지가 포함된경우 msg_type 을 ai 로 설정시 발송 실패)
템플릿 강조 유형이 이미지 형인 템플릿의 경우
add_info1.json
{
"expansion": {
"msg_type": "ai"
}
}
템플릿 강조 유형이 아이템리스트 형이고 헤더, 아이템리스트, 아이템 요약정보를 포함한 템플릿의 경우
add_info2.json
{
"items": {
"list": [
{
"title": "가입일자",
"description": "2021.5.23"
},
{
"title": "이름",
"description": "김카카오"
}
],
"summary": {
"title": "구매가격",
"description": "18,000 원"
},
"expansion": {
"header": "카카오 가입을 환영합니다."
}
}
}
FT + 이미지
이미지 포함하여 친구톡 발송 시 카카오에 등록된 이미지의 유형(일반/와이드)에 따라 add_info.json 파일을 생성하여 등록합니다.
일반 유형의 이미지 경우
add_info1.json
{
"image": {
"img_url": "http://mud-kage.kakao.com/dn/bYNiOa/btqBqjiQxoK/4IDZksnFEuBdU6zk9UBRKK/img.jpg",
"img_link": "http://www.daou.co.kr"
}
}
와이드 유형의 이미지 경우
add_info2.json
{
"image": {
"img_url": "http://mud-kage.kakao.com/dn/bYNiOa/btqBqjiQxoK/4IDZksnFEuBdU6zk9UBRKK/img.jpg",
"img_link": "http://www.daou.co.kr"
},
"expansion": {
"wide": "y"
}
}
/
AT/FT + 대체(SMS/MMS) 발송
알림톡/친구톡 발송결과에 대해 실패가 발생할 경우, 대체발송이 가능합니다.
단, 해당 서비스 아이디에 대해 대체발송 가능여부와 주체에 대한 설정이 되어있어야 합니다. 대체발송의 경우, EM_TRAN 테이블에 해당 레코드가 추가로 생성되며 SMS 의 TRAN_TYPE 은 1 이며 MMS 의 TRAN_TYPE 은 2 이며, TRAN_ETC4 에 입력된 값이 실제 원본데이터의 TRAN_PR 입니다
AT+SMS
INSERT INTO EM_TRAN_KKO(
SENDER_KEY, TEMPLATE_CODE, NATION_CODE, MESSAGE, RE_TYPE, RE_BODY)
VALUES ({발신 프로필 키}, {템플릿 코드}, '82', 'AT+SMS 대체발송', 'SMS', '대체발송');
INSERT INTO EM_TRAN(
TRAN_PHONE, TRAN_CALLBACK, TRAN_STATUS, TRAN_DATE, TRAN_TYPE, TRAN_ETC4)
VALUES ('01000000000', '01000000000', '1', now(), 7, {EM_TRAN_KKO 의 KKO_SEQ});
AT+MMS
INSERT INTO EM_TRAN_KKO (
SENDER_KEY, TEMPLATE_CODE, NATION_CODE, MESSAGE, RE_TYPE, RE_BODY, ATTACHED_FILE_1)
VALUES (
{발신 프로필 키}, {템플릿 코드}, '82', 'AT+MMS 대체발송', 'MMS', '대체발송', ‘D:/spool/mms.jpg’);
INSERT INTO EM_TRAN(
TRAN_PHONE, TRAN_CALLBACK, TRAN_STATUS, TRAN_DATE, TRAN_TYPE, TRAN_ETC4)
VALUES ('01000000000', '01000000000', '1', now(), 7, {EM_TRAN_KKO 의 KKO_SEQ});
AT/FT + 1 차 + 2 차 대체발송
AT + RCS + SMS
INSERT INTO EM_TRAN_KKO(
KKO_SEQ, SENDER_KEY, TEMPLATE_CODE, NATION_CODE, MESSAGE, RE_TYPE)
VALUES ({KKO_SEQ}, {발신 프로필 키}, {템플릿 코드}, '82', 'AT 메시지, 'R’);
INSERT INTO EM_TRAN_RCS(
RCS_SEQ, CHATBOT_ID, HEADER, MESSAGEBASE_ID, RCS_BODY, RE_TYPE, RE_BODY)
VALUES (
{KKO_SEQ 동일}, {챗봇 ID}, 0, 'SS000000', '{"description":"AT+RCS+SMS 대체발송"}',
'SMS', 'SMS 2 차 대체발송 메시지');
INSERT INTO EM_TRAN
(TRAN_PHONE, TRAN_CALLBACK, TRAN_STATUS, TRAN_DATE, TRAN_TYPE, TRAN_ETC4)
VALUES ('01000000000', '01000000000', '1', now(), 7, {EM_TRAN_KKO 의 KKO_SEQ});
AT + RCS + MMS
INSERT INTO EM_TRAN_KKO(
KKO_SEQ, SENDER_KEY, TEMPLATE_CODE, NATION_CODE, MESSAGE, RE_TYPE)
VALUES ({KKO_SEQ}, {발신 프로필 키}, {템플릿 코드}, '82', 'AT 메시지', 'R');
INSERT INTO EM_TRAN_RCS(
RCS_SEQ, CHATBOT_ID, HEADER, MESSAGEBASE_ID, RCS_BODY,
RE_TYPE, RE_BODY, ATTACHED_FILE_1)
VALUES (
{KKO_SEQ 동일}, {챗봇 ID}, 0, 'SS000000', '{“description":"AT+RCS+MMS 대체발송"}',
'SMS', 'SMS 2 차 대체발송 메시지', 'D:/mms.jpg');
INSERT INTO EM_TRAN(
TRAN_PHONE, TRAN_CALLBACK, TRAN_STATUS, TRAN_DATE, TRAN_TYPE, TRAN_ETC4)
VALUES ('01000000000', '01000000000', '1', now(), 7, {EM_TRAN_KKO 의 KKO_SEQ});
카카오톡 이모티콘 삽입
카카오톡 기본 이모티콘 삽입을 원할 경우 이모티콘에 해당하는 명령어를 입력합니다.
예) 안녕하세요 (하하)(씨익)
RCS
RCS는 사용 가능한 챗봇ID와 메시지베이스ID를 사용하여 발송되며 RCS 지원기기 사용자인 경우 발송 가능합니다.
메시지베이스 ID 는 이통사에서 제공하는 메시지 포맷을 사용하거나 *[RCS 비즈센터]을 통해 템플릿을 등록하여 사용가능합니다.
INSERT INTO EM_TRAN_RCS(
CHATBOT_ID, HEADER, MESSAGEBASE_ID, RCS_BODY)
VALUES ({챗봇 ID}, 0, 'SS000000', '{"description":"안녕하세요"}');
INSERT INTO EM_TRAN(
TRAN_PHONE, TRAN_CALLBACK, TRAN_STATUS, TRAN_DATE, TRAN_TYPE, TRAN_ETC4)
VALUES ('01000000000', '01000000000', '1', NOW(), 11, {EM_TRAN_RCS 의 RCS_SEQ 값});
RCS 공통포맷 (MESSAGEBASE_ID)
| ID | 메시지 유형 | 카드장수 | 카드 별 최대 버튼 수 |
|
| SS000000 | SMS | Standalone | 1 | 1 |
| SL000000 | LMS | Standalone | 1 | 3 |
| SMwThTOO | MMS | Standalone Media Top | 1 | 2 |
| SMwTh M00 | MMS | Standalone Media Top | 1 | 2 |
| CMwMhM0300 | MMS | Carousel Medium | 2 | 2 |
| CMwMhM0300 | MMS | Carousel Medium | 3 | 2 |
| CMwMhM0400 | MMS | Carousel Medium | 4 | 2 |
| CMwMhM0500 | MMS | Carousel Medium | 5 | 2 |
| CMwMhM0600 | MMS | Carousel Medium | 6 | 2 |
| CMwShS0200 | MMS | Carousel Small | 2 | 2 |
| CMwShS0300 | MMS | Carousel Small | 3 | 2 |
| CMwShS0400 | MMS | Carousel Small | 4 | 2 |
| CMwShS0500 | MMS | Carousel Small | 5 | 2 |
| CMwShS0600 | MMS | Carousel Small | 6 | 2 |
| OMHITVOOOI | 신규 MMS |
이미지 & 타이틀 강조형 (3:4) |
1 | 2 |
| OMHITSOOOI | 신규 MMS |
이미지 & 타이틀 강조형 (1:1) |
1 | 2 |
| OMHIMVOOOI | 신규 MMS |
이미지 강조형 (3:4) | 1 | 2 |
| OMHIMSOOOI | 신규 MMS |
이미지 강조형 (1:1) | 1 | 2 |
| OMTBNVOOOI | 신규 MMS |
썸네일형 (세로) | 1 | 2 |
| OMTBNHOOOI | 신규 MMS |
썸네일형 (가로) | 1 | 2 |
| 0M5NSS0001 | 신규 MMS |
SNS | 1 | 2 |
| 0MSNSH0001 | 신규 MMS |
SNS | 1 | 2 |
| UBR로 시작 템플릿별 상이 |
템플릿 | 서술 (description) | 1 | 2 |
| 스타일 (cell) | 1 | 2 | ||
| 기본 (free) | 1 | 0 | ||
RCS MMS 슬라이드형(Carousel Medium, Small)은 1,300자까지 발송 가능하나 실제 단말에서 수신 가능한 글자 수가 적어 메시지 내용이 잘려 발송될 수 있습니다.
아래 글자/라인수 정의 확인하시어 발송하시기 바랍니다.
RCS MMS 슬라이드형 글자/ 라인수 정의
글자 수 : 1줄 당 정상적으로 표현가능한 글자 수, 한글 '가' 기준 측정
라인 수 : 수신 가능한 디스크립션(본문) 줄 수
LMS (Standalone No Media)
[글자 수]
| 타이틀 | 디스크립션 | 버튼명 |
| 16 | 18 | 17 |
[줄 수(접혀있는 경우)]
| 버튼 0개 | 버튼 1개 | 버튼 2개 | 버튼 3개 | |
| 디스크립션 only | 28 | 26 | 24 | 22 |
| 타이틀 1줄 + 디스크립션 |
27 | 25 | 23 | 20 |
| 타이틀 2줄 + 디스크립션 |
26 | 23 | 23 | 19 |
MMS (Standalone Media Top - 세로형)
[글자 수]
| 타이틀 | 디스크립션 | 버튼명 |
| 16 | 18 | 17 |
[줄 수(Media Tall인 경우, 접혀있는 경우)]
| 버튼 0개 | 버튼 1개 | 버튼 2개 | |
| 디스크립션 only | 9 | 8 | 6 |
| 타이틀 1줄 + 디스크립션 |
8 | 6 | 4 |
| 타이틀 2줄 + 디스크립션 |
7 | 5 | 3 |
MMS (Carousel Medium - 슬라이드)
| 한 라인에 들어가는 글자 수 (한글 '가' 기준 측정) |
타이틀 | 13 |
| 디스크립션 | 14 |
| 줄(라인) 수 | 버튼 0개 | 버튼 1개 | 버튼 2개 | |
| Media 없는 경우 | 디스크립션 OnIy | 28 | 26 | 23 |
| 타이틀 1줄 + 디스크립션 | 27 | 25 | 23 | |
| 타이틀 2줄 + 디스크립션 | 26 | 23 | 21 | |
| 타이틀 3줄 + 디스크립션 | 24 | 22 | 20 | |
| Media Medeum인 경우 | 버튼 0개 | 버튼 1개 | 버튼 2개 | |
| 디스크립션 OnIy | 17 | 15 | 13 | |
| 타이 1줄 + 디스크립션 | 16 | 14 | 12 | |
| 타이틀 2줄 + 디스크립션 | 15 | 13 | 11 | |
| 타이를 3줄 + 디스크립션 | 14 | 12 | 10 | |
MMS (Carousel Small - 슬라이드형)
| 한 라인에 들어가는 글자 수 (한글 '가' 기준 측정) |
타이틀 | 5 |
| 디스크립션 | 6 |
| 줄(라인) 수 | 버튼 0개 | 버튼 1개 | 버튼 2개 | |
| Media Short인 경우 | 디스크립션 OnIy | 20 | 18 | 16 |
| 타이를 1줄 + 디스크립션 | 19 | 17 | 15 | |
| 타이틀 2줄 + 디스크립션 | 18 | 16 | 14 | |
| 타이를 3줄 + 디스크립션 | 17 | 15 | 13 | |
| 타이를 4줄 + 디스크립션 | 16 | 14 | 12 | |
| 타이를 5줄 + 디스크립션 | 15 | 13 | 11 | |
RCS BODY
BODY
key : title, media, description
리치카드 개수 및 순서에 따라 넘버링 (ex. title1, title2, ...)
#1개
{
"title" : "카드",
"media" : "등록된 이미지 URL",
"description": "안녕하세요!"
}
#2개 이상
{
"title1" : "카드",
"media1" : "등록된 이미지 URL",
"description1": "안녕하세요!",
"title2" : "카드 2",
"media2" : "등록된 이미지 URL",
"description2" : "안녕하세요!",
.
.
.
}
신규 RCS 포맷
"body": {
"title1": "제목",
"description1": "본문 텍스트",
"media1": "maapfile://{fileId_1}",
"title2": "제목 2번째 카드",
"description2": "본문 텍스트",
"media2": "maapfile://{fileId_2}",
"title3": "제목 3번째 카드",
"description3": "본문 텍스트",
"media3": "maapfile://{fileId_3}",
"media": "maapfile://{fileId_main} > (신규포맷 mms 전용) 상단 main 이미지",
"title": "제목 텍스트 > (신규포맷 mms 전용) 상단 main 제목",
"description": "본문 텍스트 > (신규포맷 mms 전용) 상단 main 본문",
"subMedia1": "maapfile://{fileId_sub1} > (신규포맷 mms 전용) 선택 옵션 서브 이미지 1",
"subMediaUrl1": "URL > (신규포맷 mms 전용) 선택 옵션 서브 이미지 1 클릭 시 랜딩 URL",
"subTitle1": "제목 텍스트 > (신규포맷 mms 전용) 선택 옵션 소제목 1",
"subDesc1": "본문 텍스트 > (신규포맷 mms 전용) 선택 옵션 소본문 1",
"subMedia2": "maapfile://{fileId_sub2} > (신규포맷 mms 전용) 선택 옵션 서브 이미지 2",
"subMediaUrl2": "URL > (신규포맷 mms 전용) 선택 옵션 서브 이미지 2 클릭 시 랜딩 URL",
"subTitle2": "제목 텍스트 > (신규포맷 mms 전용) 선택 옵션 소제목 2",
"subDesc2": "본문 텍스트 > (신규포맷 mms 전용) 선택 옵션 소본문 2",
"subMedia3": "maapfile://{fileId_sub3} > (신규포맷 mms 전용) 선택 옵션 서브 이미지 3",
"subMediaUrl3": "URL > (신규포맷 mms 전용) 선택 옵션 서브 이미지 3 클릭 시 랜딩 URL",
"subTitle3": "제목 텍스트 > (신규포맷 mms 전용) 선택 옵션 소제목 3",
"subDesc3": "본문 텍스트 > (신규포맷 mms 전용) 선택 옵션 소본문 3"
}
Media 종류
이미지
-
비즈뿌리오 사이트의 [메시지관리] – [RCS 관리] – [RCS 이미지 관리] 메뉴에서 이미지를 등록하여 사용합니다.
이미지는 등록일로부터 365일간 발송 가능합니다. (이후 자동 삭제)
이미지 URL
포맷
maapfile://{fileId}
예시
"media" : "maapfile://BR.i6dOpSm8N8.20200302150000.001"
동영상 스트리밍
동영상 스트리밍 URL
포맷
https://www.youtube.com/watch?v=[videoId],maapfile://{썸네일용 fileId_1}
https://youtu.be/[VideoId],maapfile://{썸네일용 fileId_2}
https://m.youtube.com/watch?v=[videoId],maapfile://{썸네일용 fileId_3}
예시
"media1" : "https://www.youtube.com/watch?v=KCbtF9I0qvI,maapfile://BR.i6dOpSm8N8.20200302150000.001"
RCS MMS 슬라이드형(Carousel Medium, Small)은 1,300 자까지 발송 가능하나 실제 단말에서 수신 가능한 글자 수가 적어 메시지 내용이 잘려 발송될 수 있습니다. 포토여부/타이틀 글자 수/버튼 개수에 따라 입력 가능한 본문 글자 수가 상이할 수 있습니다.
RCS + BUTTONS
RCS 에 버튼 링크를 추가하고자 할 경우 아래와 같은 JSON 형식에 맞춰 RCS 테이블(BIZ_RCS)의 BUTTONS 필드에 입력합니다.
INSERT INTO EM_TRAN_RCS(
CHATBOT_ID, HEADER, MESSAGEBASE_ID, RCS_BODY, BUTTONS)
VALUES ({챗봇 ID}, 0, 'SS000000', '{"description":"안녕하세요"}', '{버튼 예시 참조}');
INSERT INTO EM_TRAN(
TRAN_PHONE, TRAN_CALLBACK, TRAN_STATUS, TRAN_DATE, TRAN_TYPE, TRAN_ETC4)
VALUES ('01000000000', '01000000000', '1', NOW(), 11, {EM_TRAN_RCS 의 RCS_SEQ 값});
RCS + 1차 대체 발송
RCS 는 발송결과에 대해 실패가 발생할 경우, 대체발송이 가능합니다.
단, 해당 서비스 아이디에 대해 대체발송 가능여부와 주체에 대한 설정이 되어있어야 합니다. 대체발송의 경우, EM_TRAN 테이블에 해당 레코드가 추가로 생성되며 SMS 의 TRAN_TYPE 은 1 이고 MMS 의 TRAN_TYPE 은 2 이며, TRAN_ETC4 에 입력된 값이 실제 원본데이터의 TRAN_PR 입니다.
RCS+SMS
INSERT INTO EM_TRAN_RCS(
CHATBOT_ID, HEADER, MESSAGEBASE_ID, RCS_BODY, RE_TYPE, RE_BODY)
VALUES (
{챗봇 ID}, 0, 'SS000000', '{"description":"RCS+SMS 대체발송"}' 'SMS', '대체발송');
INSERT INTO EM_TRAN(
TRAN_PHONE, TRAN_CALLBACK, TRAN_STATUS, TRAN_DATE, TRAN_TYPE, TRAN_ETC4)
VALUES (
'01000000000', '01000000000', '1', now(), 11, {EM_TRAN_RCS 의 RCS_SEQ});
RCS + MMS
INSERT INTO EM_TRAN_KKO(
CHATBOT_ID, HEADER, MESSAGEBASE_ID, RCS_BODY, RE_TYPE, RE_BODY)
VALUES (
{챗봇 ID}, 0, 'SS000000', '{"description":"RCS+MMS 대체발송"}',
'MMS', '대체발송', 'D:/spool/mms.jpg');
INSERT INTO EM_TRAN(
TRAN_PHONE, TRAN_CALLBACK, TRAN_STATUS, TRAN_DATE, TRAN_TYPE, TRAN_ETC4)
VALUES ('01000000000', '01000000000', '1', now(), 11, {EM_TRAN_RCS 의 RCS_SEQ});
RCS + 1차 + 2차 대체발송
RCS 는 발송결과에 대해 실패가 발생할 경우, 최대 2 차 대체발송이 가능합니다. - 대체발송의 경우, EM_TRAN 테이블에 해당 레코드가 추가로 됩니다.
-
발송에 사용되는 RCS_SEQ 값과 KKO_SEQ 값은 동일해야 합니다.
-
2 차 대체(SMS/MMS)의 정보는 KKO 테이블에 입력해야 정상적으로 발송됩니다.
RCS + AT + SMS
INSERT INTO EM_TRAN_RCS(
RCS_SEQ, CHATBOT_ID, HEADER, MESSAGEBASE_ID, RCS_BODY, RE_TYPE)
VALUES ({RCS_SEQ}, {챗봇 ID}, 0, 'SS000000', '{"description":"RCS 메시지"}', 'K');
INSERT INTO EM_TRAN_KKO(
KKO_SEQ, SENDER_KEY, TEMPLATE_CODE, NATION_CODE, MESSAGE, RE_TYPE, RE_BODY)
VALUES ({RCS_SEQ 동일}, {발신 프로필 키}, {템플릿 코드}, '82', 'RCS+AT+SMS 대체발송',
'SMS', 'SMS 2 차 대체발송 메시지');
INSERT INTO EM_TRAN(
TRAN_PHONE, TRAN_CALLBACK, TRAN_STATUS, TRAN_DATE, TRAN_TYPE, TRAN_ETC4)
VALUES ('01000000000', '01000000000', '1', now(), 11, {EM_TRAN_RCS 의 RCS_SEQ});
RCS + AT + MMS
INSERT INTO EM_TRAN_RCS(
RCS_SEQ, CHATBOT_ID, HEADER, MESSAGEBASE_ID, RCS_BODY, RE_TYPE)
VALUES ({RCS_SEQ}, {챗봇 ID}, 0, 'SS000000', '{"description":"RCS 메시지"}', 'K');
INSERT INTO EM_TRAN_KKO(
KKO_SEQ, SENDER_KEY, TEMPLATE_CODE, NATION_CODE, MESSAGE, RE_TYPE, RE_BODY)
VALUES ({RCS_SEQ 동일}, {발신 프로필 키}, {템플릿 코드}, '82', 'RCS+AT+MMS 대체발송',
'MMS', 'MMS 2 차 대체발송 메시지');
INSERT INTO EM_TRAN(
TRAN_PHONE, TRAN_CALLBACK, TRAN_STATUS, TRAN_DATE, TRAN_TYPE, TRAN_ETC4)
VALUES ('01000000000', '01000000000', '1', now(), 11, {EM_TRAN_RCS 의 RCS_SEQ});
댓글
댓글 0개
이 문서에는 댓글을 달 수 없습니다.