메시지 문자열은 KSC 5601(ISO 10646-1/Unicode1.1) 한글 코드에 정의된 문자열입니다.
이동통신 3사에서 지원하는 인코딩 방식이며 해당 인코딩 범주를 벗어나는 문자는 ? 로 표시되어 전송 될 수 있습니다.
Ex ) 핳, 힣, 탙 ... ...
CMID 는 발송데이터의 고유한 키 값(Primary key)으로서 중복되지 않게 생성해주시면 됩니다.
메시지 타입(MSG_TYPE)
사용자는 총 9가지 (SMS/MMS/AT/FT/BI/BW/RCS/PHONE/FAX)의 메시지 타입 발송이 가능합니다.
(사전에 비즈 아이디의 서비스 형태가 관련 메시지타입 발송이 가능하도록 설정이 필요)
메시지 타입 별 이모지 발송 가능 여부
일반 SMS, LMS/MMS 를 제외한 메시지 타입에서 이모지 문자열 발송 가능합니다.
*FAX 발송 문서 파일에 입력된 이모지는 정상 발송 가능합니다.
메시지 타입 | |
SMS | X |
LMS/MMS | X |
AT/FT | O |
RCS | O |
FAX/PHONE | X |
발송 상태 변화(STATUS)
STATUS는 다음과 같은 상태 변화를 가집니다.
코드 | 내용 |
0 | 발송 대기 |
7 | 발송 중 |
1 | 발송 후 결과 대기 |
2 |
발송 결과 업데이트 (로그 테이블 이동 대상) |
3 | 리포트 재요청 후 대기 |
11 | 클라이언트 대체발송 처리 중 |
13 | 대체발송 설정을 하지 않고 대체발송 한 경우 |
status = 13 인 경우 로그테이블로 이동되지 않습니다.
대체발송을 사용하시려면 대체발송 사용여부를 변경해주시기 바랍니다.
발송 결과 확인(CALL_STATUS)
발송 결과는 메시지 테이블의 CALL_STATUS 컬럼으로 확인이 가능하며 발송 결과 코드의 상세 설명은 발송결과코드 항목을 참고하여 주시기 바랍니다.
대체 발송 타입(RE_TYPE)
사용자는 메시지 타입(AT/FT/BI/BW/RCS)에 따라 최대 2 차 대체발송까지 가능합니다.
상세 설명은 카카오 비즈 메시지 대체발송 ~ RCS 대체발송 항목을 참고하여 주시기 바랍니다.
참고
2개 이상의 파일을 전송할 때는 ATTACHED_FILE 필드에 파일 1**|파일 2|** ... 형식으로 파일을 |(파이프라인) 으로 구분하여 입력합니다 (SMS 제외)
메시지 타입 별 첨부파일을 발송해야 하는 경우 아래 지원 가능한 첨부파일 타입을 참조해주시길 바랍니다.
지원 가능한 첨부파일 타입
- MMS
Image : jpg
Audio : ma3
Video : k3g
Image 를 제외한 타입에 대해서는, 전송은 되지만 일부 이동통신사 또는 단말기에 대해 지원하지 않을 수 있습니다.
- AT/FT
Button/Image : JSON
- PHONE
Voice : wav (8bit-8KHz mono 형식)
- FAX
Docs : doc, docx, xls, xlsx, ppt, pptx, hwp, pdf, txt, html, html
Image : bmp, gif, jpg, png
SMS (텍스트 90byte 이하의 단문 메시지)
INSERT INTO biz_msg (
MSG_TYPE, CMID, REQUEST_TIME, SEND_TIME, DEST_PHONE, SEND_PHONE, MSG_BODY)
VALUES (
0, '201XXXXXXXXX', NOW(), NOW(),
'01012341234', '0212341234', '본 메시지는 SMS 테스트 메시지 입니다.')
MMS
텍스트 2000byte 이하, 이미지 60kb 이하 등 멀티미디어를 같이 보내는 메시지
INSERT INTO biz_msg (
MSG_TYPE, CMID, REQUEST_TIME, SEND_TIME,
DEST_PHONE, SEND_PHONE, SUBJECT, MSG_BODY, ATTACHED_FILE)
VALUES (
5, '201XXXXXXXXX', NOW(), NOW(), '01012341234', '0212341234',
'MMS 제목', '본 메시지는 MMS 테스트 메시지 입니다.', {첨부파일명.jpg})
LMS
INSERT INTO biz_msg (
MSG_TYPE, CMID, REQUEST_TIME, SEND_TIME,
DEST_PHONE, SEND_PHONE, SUBJECT, MSG_BODY)
VALUES (
5, '201XXXXXXXXX', NOW(), NOW(), '01012341234', '0212341234',
'LMS 제목', '본 메시지는 LMS 테스트 메시지 입니다.')
AT 발송
알림톡은 비즈뿌리오 서버에 등록된 사용 가능 발신프로필 키 와 템플릿 코드 로 사용량이 많습니다.
알림톡은 내용을 포함하고 한글, 영어, 숫자, 문자 및 공백을 모두 포함하여 최대 1000자까지만 가능합니다.
INSERT INTO biz_msg (MSG_TYPE, CMID, REQUEST_TIME, SEND_TIME,
DEST_PHONE, SEND_PHONE, MSG_BODY, TEMPLATE_CODE, SENDER_KEY, NATION_CODE)
VALUES (6, '201XXXXXXXXX', NOW(), NOW(), '01012341234', '0212341234',
'홍길동 고객님 다우기술 비즈메시지 프로모션에 당첨 되었습니다.', {템플릿코드}, {발신프로필키}, '82')
템플릿 예시
### 비즈뿌리오 사이트에 등록한 템플릿 내용 ###
안녕하세요 #{고객명}님 다우기술 입니다.
#{날짜}에 주문하신 상품이 발송 되었습니다.
택배사명 : #{택배사}
배송일자 : #{배송일}
감사합니다.
### MSG_BODY 컬럼에 입력할 내용 ###
안녕하세요 홍길동님 다우기술 입니다.
2020.01.01 에 주문하신 상품이 발송 되었습니다.
택배사명 : 다우택배
배송일자 : 2020.01.02
감사합니다.
대체 발송 타입 (RE_TYPE)
1차 대체발송 타입에 따라 최대 2차 대체발송까지 가능합니다.
1차 대체 발송 | 2차 대체 발송 | RE_TYPE 입력값 |
SMS | SMS | |
MMS | MMS | |
RCS | R | |
RCS | SMS | RS |
RCS | MMS | RM |
AT/FT + 1차 대체 발송
알림톡/친구톡 발송 결과 실패 시 지정하신 대체 발송 타입(SMS/MMS/RCS)과 대체 발송 본문을 사용하여 발송됩니다.
(단, 비즈뿌리오 ID 가 대체 발송 사용 가능하도록 설정되어 있어야 합니다.)
SMS/MMS 대체 발송의 경우 대체 발송 본문에 대해 동일 본문을 사용하려면, 대체 발송 메시지 필드(RE_BODY)를 비워두시면 됩니다.
(단, SMS 대체 발송의 경우에는 메시지 본문 (MSG_BODY) 길이가 SMS 의 허용 길이를 초과하였을 때 발송되지 않습니다.)
AT/FT + SMS 1차 대체 발송
AT/FT + SMS 1차 대체 발송
INSERT INTO biz_msg (
MSG_TYPE, CMID, REQUEST_TIME, SEND_TIME, DEST_PHONE,
SEND_PHONE, MSG_BODY, TEMPLATE_CODE, SENDER_KEY, NATION_CODE, RE_TYPE, RE_BODY)
VALUES (
6, '201XXXXXXXXX', NOW(), NOW(), '01012341234', '0212341234',
'홍길동 고객님 다우기술 비즈메시지 프로모션에 당첨 되었습니다.', {템플릿코드}, {발신프로필키},
82, 'SMS', '[다우기술] 응모하신 프로모션에 당첨되셨습니다.')
AT/FT + MMS 1차 대체 발송
AT/FT + MMS 1차 대체 발송
INSERT INTO biz_msg (
MSG_TYPE, CMID, REQUEST_TIME, SEND_TIME, DEST_PHONE, SEND_PHONE,
MSG_BODY, TEMPLATE_CODE, SENDER_KEY, NATION_CODE, RE_TYPE, RE_BODY, ATTACHED_FILE)
VALUES (
6, '201XXXXXXXXX', NOW(), NOW(), '01012341234', '0212341234',
'홍길동 고객님 다우기술 비즈메시지 프로모션에 당첨 되었습니다.', {템플릿코드}, {발신프로필키},
82, 'MMS', '[다우기술] 응모하신 프로모션에 당첨되셨습니다.') , {첨부파일명.jpg}
RCS 대체발송은 RCS 테이블의 데이터를 사용하여 메시지가 발송됩니다.
AT/FT + RCS 1차 대체 발송
AT/FT + MMS 1차 대체 발송
INSERT INTO biz_msg (
MSG_TYPE, CMID, REQUEST_TIME, SEND_TIME, DEST_PHONE, SEND_PHONE,
MSG_BODY, TEMPLATE_CODE, SENDER_KEY, NATION_CODE, RE_TYPE, RCS_REFKEY)
VALUES (
6, '201XXXXXXXXX', NOW(), NOW(), '01012341234', '0212341234',
'홍길동 고객님 다우기술 비즈메시지 프로모션에 당첨 되었습니다.', {템플릿코드}, {발신프로필키},
82, 'R', '{RCS_REFKEY}')
대체 발송이 이루어진 경우, 클라이언트는 수신 받은 리포트를 업데이트하는 시점에 대체 발송에 대한 정보를 추가 레코드로 신규 생성하게 됩니다. 알림톡/친구톡과 대체 발송에 대한 레코드의 매핑 키는 알림톡/친구톡의 UMID 필드가 대체 발송의 CMID 필드로 이루어집니다.
AT/FT + 2차 대체 발송
알림톡/친구톡 발송 실패 시 RCS메시지를 발송하며 RCS메시지 발송 결과 실패 시 지정한 2차 대체 발송 타입(SMS/MMS)과 대체 발송 본문을 사용하여 발송됩니다. (단, 비즈뿌리오 ID 가 대체 발송 사용 가능하도록 설정되어 있어야 합니다.)
대체 발송 본문에 대해 동일 본문을 사용하려면, 대체 발송 메시지 필드(RE_BODY)를 비워두시면 됩니다. (단, SMS 대체발송의 경우에는 메시지 본문(MSG_BODY) 길이가 SMS 의 허용 길이를 초과하였을 때 발송되지 않습니다.)
AT/FT + RCS(1차) + SMS(2차)
AT/FT + RCS(1차) + SMS(2차)
INSERT INTO biz_msg (
MSG_TYPE, CMID, REQUEST_TIME, SEND_TIME, DEST_PHONE, SEND_PHONE,
MSG_BODY, TEMPLATE_CODE, SENDER_KEY, NATION_CODE,RE_TYPE, RE_BODY, RCS_REFKEY)
VALUES (
6, '201XXXXXXXXX', NOW(), NOW(), '01012341234', '0212341234',
'홍길동 고객님 다우기술 비즈메시지 프로모션에 당첨 되었습니다.', {템플릿코드}, {발신프로필키},
82, 'RS', '[다우기술] 응모하신 프로모션에 당첨되셨습니다.', '{RCS_REFKEY}')
대체 발송이 이루어진 경우, 클라이언트는 수신 받은 리포트를 업데이트하는 시점에 대체 발송에 대한 정보를 추가 레코드로 신규 생성하게 됩니다. 알림톡/친구톡과 대체 발송에 대한 레코드의 매핑 키는 알림톡/친구톡의 UMID 필드가 대체 발송의 CMID 필드로 이루어집니다.
2차 대체 발송이 이루어진 경우, 알림톡/친구톡의 UMID 값 앞에 "**RE_"**이 추가된 문자열이 2차 대체 발송의 CMID 필드로 이루어지며 1차 대체 발송의 UMID 도 같은 값으로 설정됩니다.
AT/FT + ATTACHMENT 발송
알림톡/친구톡에 버튼 및 추가 기능을 사용하고자 할 경우 환경설정 파일에서 지정한 파일경로(FILE_PATH)에 JSON 형식 파일을 업로드 한 후, 첨부될 파일은 ATTACHED_FILE 필드에 입력합니다.
(JSON 형식 파일 인코딩은 EUC-KR 로 생성되어 있어야 합니다.)
(웹 링크, 앱 링크에 변수가 있거나 JSON 파일 생성이 어려운 경우 FILE_HANDLING_MODE 테이블을 활용 할 수 있습니다.)
(버튼 및 추가 기능이 등록된 템플릿코드만 사용가능합니다.)
AT + ATTACHMENT
INSERT INTO biz_msg (
MSG_TYPE, CMID, REQUEST_TIME, SEND_TIME, DEST_PHONE, SEND_PHONE,
MSG_BODY, TEMPLATE_CODE, SENDER_KEY, NATION_CODE, ATTACHED_FILE)
VALUES (
6, '201XXXXXXXXX', NOW(), NOW(), '01012341234', '0212341234',
'홍길동 고객님 다우기술 비즈메시지 프로모션에 당첨 되었습니다.',
{템플릿코드}, {발신프로필키}, '82', '{파일명}.json')
FT + ATTACHMENT
INSERT INTO biz_msg (
MSG_TYPE, CMID, REQUEST_TIME, SEND_TIME, DEST_PHONE, SEND_PHONE,
MSG_BODY, SENDER_KEY, NATION_CODE,ATTACHED_FILE)
VALUES (7, '201XXXXXXXXX', NOW(), NOW(), '01012341234', '0212341234',
'홍길동 고객님 다우기술 비즈메시지 프로모션에 당첨 되었습니다.',
{발신프로필키}, '82', '{파일명}.json')
알림톡 ATTACHMENT 정보
Key:supplement 항목은 아래 이어지는 supplement 테이블을 참고
키 | 타입 | 필수 | 설명 | ||
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 환경에서 버튼 클릭 시 실행할 Application Custom Scheme |
||
scheme_android | text | - |
Mobile Android 환경에서 버튼 클릭 시 실행할 Application Custom Scheme |
||
chat_extra | text(50) | - | 상담톡/봇 전환 시 전달할 메타정보 | ||
chat_event | text(50) | - | 봇 전환 시 연결할 봇 이벤트명 | ||
plugin_id | text(24) | - | 플러그인 ID | ||
relay_id | text | - |
플러그인 실행시 X-Kakao-Plugin-Realy-Id 헤더를 통해 전달 받을 값 |
||
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 | N | 아이템리스트 | ||
iitle | text(6) | Y | 타이틀 | ||
description | text(23) | Y | 부가정보 | ||
summary | json | N | 아이템 요약정보 | ||
title | text(6) | Y | 타이틀 | ||
description | text(14) | Y |
가격정보 *허용되는 문자: 통화기호(유니코드 통화기호, 元, 円, 원), 통화코드(ISO 4217), 숫자, 콤마, 소수점, 공백 *소수점 2자리까지 허용 |
||
extra | json | - | 추가 기능 | ||
msg_type | text |
카카오 발송 유형 (at : 알림톡, ai :이미지 알림톡) * ai 발송 시 필수입력 |
|||
title | text(50) | 템플릿 내용 중 강조 표기할 핵심 정보 | |||
supplement | Json |
메시지에 첨부할 바로연결 *supplement 참조 |
|||
price | number |
모먼트 광고 전환 최적화 전용 메시지 내 포함된 가격/금액/결제금액 |
|||
currency_type | text(3) |
모먼트 광고 전환 최적화 전용 메시지 내 포함된 가격/금액/결제금액의 통화단위 KRW, USD, EUR 등 국제 통화 코드 사용 |
|||
header | text(16) | 메시지 상단에 표기할 제목 | |||
link | 대표 링크 | ||||
url_mobile | text | mobile 환경에서 버튼 클릭 시 이동할 url | |||
url_pc | text | pc 환경에서 버튼 클릭 시 이동할 url | |||
scheme_android | text |
mobile android 환경에서 버튼 클릭 시 실행할 application custom scheme |
|||
scheme_ios | text |
mobile ios 환경에서 버튼 클릭 시 실행할 application custom scheme |
supplement
키 | 타입 | 필수 | 설명 | |
quick_reply | name | text(14) | Y | 바로연결 제목 |
type | text(2) | Y | 바로연결 타입 | |
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) | - | 봇 전환 시 연결할 봇 이벤트명 |
버튼
버튼 타입
타입 | 기능 |
배송조회 |
메시지 내용에서 택배사명과 송장 번호를 피싱하여 카카오 검색 배송조회 페이지로 이동하는 배송 조회하기 버튼을 자동으로 생성함 |
웹 링크 |
버튼 클릭 시 인앱 브라우저에서 웹 페이지 실행 Movile / PC에서 실행할 URL을 각각 설정 가능 *현재 알림톡은 PC에서 메시지 내용이 보이지 않음 |
앱 링크 |
버튼 클릭 시 앱 커스텀스킴 실행 Android / IOS에서 실행할 커스텀스킴 각각 설정 필수 |
봇 키워드 |
버튼 클릭 시 유저로부터 ‘버튼 명’이 들어간 챗버블이 발송됨 봇 또는 상담원에게 유저의 액션을 전달할 때 사용할 수 있음 |
메시지전달 |
버튼 클릭 시 상담톡으로 전환 상담톡을 이용하는 카카오톡 채널만 이용 가능 |
채널 추가 | 카카오톡 채널 추가 버튼 활성화 |
상담톡 전환 |
버튼 클릭 시 상담톡으로 전환 상담톡을 이용하는 카카오톡 채널만 이용 가능 |
봇 전환 |
버튼 클릭 시 봇으로 전환 카카오 I 오픈빌더의 챗봇을 사용하는 카카오톡 채널만 이용 가능 |
플러그인 |
버튼 클릭 시 플러그인 제공 이미지 보안 전송 플러그인, 개인정보이용 플러그인, 원클릭 결제 플러그인 |
비즈니스폼 | 카카오톡 클라이언트 내에서 고객에게 응모, 설문조사, 신청/예약 등의 다양한 신청을 받을 수 있는 비즈도구 |
AT + 버튼 타입별 속성
타입 | 속성 | 타입 | 필수 | 성명 |
WL | url_mobile | text | Y | 버튼 클릭 시 이동할 pc/mobile환경별 Web URL |
url_pc | text | N | ||
AL | scheme_ios | text | Y | 버튼 클릭 시 실행할 OS별 Application Custom Scheme |
scheme_android | text | Y | ||
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를 필수로 전달해야 함) |
BF | Biz_form_id | number | Y | 카카오 비즈니스에서 생성한 비즈니스폼 ID |
버튼 첨부파일 예시
button.json |
{ “button”: [ { “name”: “미리 주문하기”, “type”: “WL”, “url_mobile”: “http://www.bizppurio.com” }, { “name”: “상담원 연결하기”, “type”: “MD” }, { “name”: “방송 알림 설정 보기”, “type”: “AL”, “scheme_android”: “daumapps://open”, “scheme_ios”: “daumapps://open” } ] } |
바로연결
알림톡 바로연결이란?
-
알림톡 하단에 가로 슬라이드 형태로 표시되며 웹/앱 연결, 상담톡 전환 등을 호출하는 기능
-
상담톡 또는 챗봇을 사용하는 발신프로필만 이용 가능
-
바로연결은 최대 10개까지 사용 가능, 사용 시 버튼 개수는 2개로 제한
*(챗봇, 상담톡 사용 채널에만 한해 사용 가능합니다.)
바로연결 타입별 속성
타입 | 속성 | 타입 | 필수 | 성명 |
WL | url_mobile | text | Y | 버튼 클릭 시 이동할 pc/mobile환경별 Web URL |
url_pc | text | N | ||
AL | 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 | 봇 전환 시 연결할 봇 이벤트명 | |
BF | biz_form_id | number | Y | 카카오 비즈니스에서 생성한 비즈니스폼 ID |
바로연결 첨부파일 예시
quick_reply.json |
{ “button”: [ { “name”: “비즈뿌리오 바로가기”, “type”: “WL”, “url_mobile”: “https://www.bizppurio.com/” } ], “extra”: { “supplement”: { “quick_reply”: [ { “name”: “비즈뿌리오”, “type”: “WL”, “url_mobile”: “https://www.bizppurio.com/” }, { “name”: “봇키워드하기”, “type”: “BK” }, { “name”: “메시지전달하기”, “type”: “MD” }, { “name”: “상담톡전환”, “type”: “BC” } ] } } } |
강조 표기
템플릿 내용 중 강조 표기할 핵심 정보 (메시지 강조 표기 타이틀은 최대 50 자 까지 설정 가능하며 알림톡 본문(1000 자)에 포함되지 않습니다.)
강조 표기 첨부파일 예시
Title.json ( 버튼이 없는 경우 ) |
{ “extra” : { “title” : “입금 123,456원” } } |
Title.json ( 버튼이 있는 경우 ) |
{ “button” : [ { “name” : ”채널 추가”, “type” : “AC” } ], “extra” : { “title” : “입금 123,456원” } } |
알림톡 이미지, 아이템 리스트
이미지와 구조화된 목록이 포함된 알림톡
-
기존 텍스트 알림톡 기본형에 (이미지 / 헤더 / 아이템 하이라이트 / 아이템리스트 / 아이템 요약정보) 5가지 항목이 추가로 구성
-
이미지, 헤더, 아이템 하이라이트 영역을 필요에 따라 1 개 이상 필수 선택하여 템플릿 등록
-
템플릿 당 고정된 이미지만 사용 가능
-
아이템리스트는 최소 2개 이상 최대 10개 항목으로 구성 가능 (알림톡 템플릿 강조 유형이 이미지형(IMAGE) 인 경우에만 msg_type 을 ai 로 설정해주셔야 발송 가능합니다.) (ex. 알림톡 템플릿 강조 유형이 아이템리스트형이고 이미지가 포함된경우 msg_type 을 ai 로 설정시 발송 실패)
이미지, 아이템리스트형 첨부파일 예시
Alimtalk_image.json ( 이미지형 ) |
{ "extra": { "msg_type": "ai" } } |
Alimtalk_item_list.json ( 아이템리스트형, 헤더 + 아이템리스트 + 아이템 요약정보 ) |
{ "item": { "list": [ { "title": "가입일자", "description": "2021.5.23" }, { "title": "이름", "description": "김카카오" } ], "summary": { "title": "구매가격", "description": "18,000원" } }, "extra": { "header": "카카오 가입을 환영합니다.", "msg_type": "at" } } |
Alimtalk_item_list_button.json ( 아이템리스트형, 버튼 + 이미지 + 아이템 하이라이트 ) |
{ "button": [ { "name": "채널 추가", "type": "AC" } ], "item_highlight": { "title": "가입 환영 포인트", "description": "10,000P" } } |
FT 발송
친구톡은 비즈뿌리오 서버에 등록된 사용 가능한 발신 프로필 키를 사용하여 발송되며, 카카오톡 사용자이고 발신 프로필(카카오톡 채널)과 친구일 경우 발송 가능합니다.
친구톡은 한글, 영어, 숫자, 특수문자 및 공백을 모두 포함하여 최대 1000 자 까지만 발송 가능합니다
INSERT INTO biz_msg (
MSG_TYPE, CMID, REQUEST_TIME, SEND_TIME,
DEST_PHONE, SEND_PHONE, MSG_BODY, SENDER_KEY, NATION_CODE)
VALUES (
6, '201XXXXXXXXX', NOW(), NOW(), '01012341234', '0212341234',
'홍길동 고객님 다우기술 비즈메시지 프로모션에 당첨 되었습니다.', {발신프로필키}, '82'
FT 상품 타입
텍스트 타입 (FT)
-
텍스트 최대 1,000자 + 버튼 최대 5개
이미지 타입 (FI)
-
텍스트 최대 400자 + 이미지 1장(500KB) + 버튼 최대 5개
-
기본적으로 텍스트 타입과 동일하나 attachment 필드에 이미지를 추가하여 발송
-
비즈뿌리오 사이트에서 이미지 사전 등록 필요
와이드 이미지타입 (FW)
-
텍스트 최대 76자 + 이미지 1장(2MB) + 버튼 최대 1개
-
기본적으로 텍스트 타입과 동일하나 attachment 필드에 이미지를 추가하여 발송
-
비즈뿌리오 사이트에서 이미지 사전 등록 필요
와이드 아이템 리스트 타입 (FL)
-
리스트 최소 3개, 최대 4개
-
리스트당 텍스트 최대 25자 + 이미지 1장(2MB)
-
버튼 최대 2개(가로 정렬)
-
하나의 말풍선에 여러 아이템 리스트를 attachment.item.list 필드에 담아서 발송 가능
-
비즈뿌리오 사이트에서 이미지 사전 등록 필요
-
광고 발송만 가능
캐러셀 피드 타입 (FC)
-
캐러셀 최소 2장, 최대 6장
-
캐러셀당 제목 최대 20자, 본문 최대 80자 + 이미지 1장(2MB) + 버튼 최대 2개(가로정렬)
-
여러 말풍선을 carousel 필드에 list 로 추가 할 수 있고, 더보기 버튼(tail)을 지정하여 발송
-
비즈뿌리오 사이트에서 이미지 사전 등록 필요
-
광고 발송만 가능
커머스 타입(FM)
- 부가 정보 최대 34자
- 버튼 최소 1개 이상, 최대 2개 (가로정렬)
- (필수)상품 제목 + (필수) 가격정보+ 부가정보 + 링크 버튼(2개/가로배열) + (필수) 이미지 발송
- 비즈뿌리오 사이트에서 이미지 사전 등록 필요
프리미엄 동영상 타입 (FP)
-
동영상 링크는 카카오 TV에 업로드 된 영상만 사용가능합니다. (https://tv.kakao.com/v/#{숫자}
/https://tv.kakao.com/channel/#{숫자}/cliplink/#{숫자}) )
-
헤더 최대 20자, 텍스트 최대 76자
-
헤더와 텍스트는 옵셔널한 값으로 없어도 발송
-
버튼 최대 1개
캐러셀 커머스 타입 (FA)
-
여러 커머스 타입을 캐러셀로 발송
-
캐러셀 인트로가 존재하는 경우 캐러셀은 최소 1개, 최대 10개
-
캐러셀 인트로가 존재하지않는 경우 캐러셀은 최소 2개, 최대 10개
-
각 캐러셀마다 버튼 1개 필수, 최대 2개
-
캐러셀 1개당 상품 제목+ 가격정보 + 부가정보 + 링크버튼(2개/가로배열) + 이미지발송
- 비즈뿌리오 사이트에서 이미지 사전 등록필요
- 광고 발송만 가능
친구톡에 버튼 및 추가 기능을 사용하고자 할 경우 환경설정파일에서 지정한 파일경로(FILE_PATH)에 JSON형식 파일을 업로드 한 후, 첨부될 파일은 ATTACHED_FILE 필드에 입력합니다.
(JSON 형식 파일 인코딩은 UTF-8로 생성되어 있어야 합니다.)
(웹링크, 앱링크에 변수가 있거나 JSON파일 생성이 어려운 경우 FILE_HANDLING_MODE 테이블을 활용 할 수 있습니다.)
(버튼 및 추가 기능이 등록된 템플릿코드만 사용가능합니다.)
FT + ATTACHMENT |
INSERT INTO biz_msg (MSG_TYPE, CMID, REQUEST_TIME, SEND_TIME, DEST_PHONE, SEND_PHONE, MSG_BODY, SENDER_KEY, NATION_CODE, ATTACHED_FILE) VALUES (7, ‘201XXXXXXXXX’, NOW(), NOW(), ‘01012341234’, ‘0212341234’, ‘홍길동 고객님 다우기술 비즈메시지 프로모션에 당첨 되었습니다.’, {발신프로필키}, ‘82’, ‘{파일명}.json’) |
친구톡 ATTACHMENT 정보
키 | 타입 | 필수 | 설명 | ||
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 환경에서 버튼 클릭 시 실행할 Application Custom Scheme |
||
scheme_android | text | - |
Mobile Android 환경에서 버튼 클릭 시 실행할 Application Custom Scheme |
||
image | json | N | 친구톡 이미지 | ||
img_url | text | Y |
노출할 이미지 *친구톡 이미지(와이드) 발송 시 필수입력 |
||
img_link | text | N |
이미지 클릭시 이동할 url 미설정시 카카오톡 내 이미지 뷰어 사용 |
||
item | json | N | 아이템리스트와 아이템 요약정보 | ||
list | array | Y | 아이템리스트 | ||
title | text(6) | Y | 타이틀 | ||
img_url | text | Y | 아이템 이미지 URL | ||
scheme_android | text | N |
Mobile android 환경에서 이미지 클릭 시 실행할 Application custom scheme |
||
scheme_ios | text | N |
Mobile ios 환경에서 이미지 클릭시 실행할 Application custom scheme |
||
url_mobile | Text | Y | Mobile 환경에서 이미지 클릭 시 이동할 url | ||
url_pc | text | N | pc환경에서 이미지 클릭 시 이동할 url | ||
coupon | json | N | |||
title | text | Y | 쿠폰 이름 형식 <4.4.2 쿠폰> | ||
description | text | Y | 쿠폰 상세 설명 (FT, FI – 12자 / FW, FL – 18자 제한) | ||
url_pc | text | - | Pc 환경에서 쿠폰 클릭 시 이동할 url | ||
url_mobile | text | - | Mobile 환경에서 쿠폰 클릭 시 이동할 url | ||
scheme_android | text | - |
Mobile android 환경에서 쿠폰 클릭 시 실행할 Application custom scheme |
||
scheme_ios | text | - |
Mobile ios 환경에서 쿠폰 클릭 시 실행할 Application custom scheme |
||
extra | json | - | 추가 기능 | ||
header | text(25) | N | [ 와이드 아이템 리스트(FL) 사용시 필수 ] | ||
carousel | json | N |
[ 캐러셀 피드(FC) 사용시 필수 ] * Carousel |
||
msg_type | text | N |
카카오 친구톡 발송 유형 (ft: 친구톡텍스트, fi : 친구톡이미지, fw: 친구톡와이드이미지, fl: 친구톡와이드아이템리스트, fc: 친구톡캐러셀피드) * fw, fl, fc 발송 시 필수 |
||
adult | text(1) | N |
성인용 메시지 여부 (성인용 메시지 여부 Y/N, 기본값 N) |
||
additional_content | text(34) | N |
부가 정보 (공백 포함 34자로 제한) FM 타입에서 사용 |
||
group_tag_key | text(40) | N |
그룹 태그 키 (통계는 24년 3Q 제공 예정) |
||
push_alarm | text(1) | N |
메시지 푸시 알람 발송 여부 (Y/N, 기본값 Y) |
#Carousel
키 | 타입 | 필수 | 설명 | |||
head | N |
캐러셀 인트로 정보 - 캐러셀 피드형(FC)은 사용불가 |
||||
header | text(20) | Y | 캐러셀 인트로 헤더 | |||
content | text(50) | Y | 캐러셀 인트로 내용 | |||
image_url | text | Y | 캐러셀 인트로 이미지 주소 | |||
url_mobile | text | N |
mobile 환경에서 인트로 클릭 시 이동할 url url_mobile, url_pc, scheme_android, scheme_ios 넷 중 하나라도 빈 값이 아니라면 url_mobile이 필수 |
|||
url_pc | text | N | pc 환경에서 인트로 클릭 시 이동할 url | |||
scheme_android | text | N |
mobile android 환경에서 인트로 클릭 시 실행할 application custom scheme |
|||
scheme_ios | text | N |
mobile ios 환경에서 인트로 클릭 시 실행할 application custom scheme |
|||
list | array | Y | Carousel Item List | |||
header | text(20) | Y | 캐러셀 아이템 제목 | |||
message | text(180) | Y | 캐러셀 아이템 메시지 | |||
attachment | json | N | 캐러셀 아이템 이미지, 버튼 정보 | |||
button | array | Y | 버튼 목록(버튼없을시 empty array) | |||
name | text(28) | - | 버튼 제목 | |||
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 | |||
image | json | Y | 캐러셀 썸네일 이미지 | |||
img_url | text | Y | 캐러셀 썸네일 이미지 주소 | |||
img_link | text | Y | 캐러셀 썸네일 링크 주소 | |||
coupon | json | N | 캐러셀 최하단에 쿠폰 추가 | |||
title | text | Y | 쿠폰 이름 형식 | |||
description | text | Y | 12자 제한 | |||
url_pc | text | - | pc 환경에서 쿠폰 클릭 시 이동할 url | |||
url_mobile | text | - | mobile 환경에서 쿠폰 클릭 시 이동할 url | |||
scheme_android | text | - |
mobile android 환경에서 쿠폰 클릭 시 실행할 application custom scheme |
|||
scheme_ios | text | - |
mobile ios 환경에서 쿠폰 클릭 시 실행할 application custom scheme |
|||
commerce | json | N |
커머스 - 캐러셀 커머스형 (FA) 사용 시 필수값 - 캐러셀 피드형(FC)은 사용불가 |
|||
title | number | Y | 상품제목 | |||
regular_price | number | Y | 정상가격 (0 ~ 99,999,999) | |||
discount_price | number | N | 할인가격 (0 ~ 99,999,999) | |||
discount_rate | number | N |
할인율 할인가격 존재시 할인율, 정액할인가격 중 하나는 필수 (0 ~ 100) |
|||
discount_fixed | number | N |
정액할인가격 할인가격 존재시 할인율, 정액할인가격 중 하나는 필수 (0 ~ 999,999) |
|||
tail | json | N | 더보기 버튼 정보 | |||
url_pc | text | N | Pc 환경에서 버튼 클릭 시 이동할 url | |||
url_mobile | text | Y | Mobile 환경에서 버튼 클릭 시 이동할 url | |||
scheme_android | text | N |
Mobile android 환경에서 버튼 클릭 시 실행할 application custom scheme |
|||
scheme_ios | text | N |
Mobile ios 환경에서 버튼 클릭 시 실행할 application custom scheme |
버튼
# 버튼 타입
타입 | 기 능 |
배송조회 |
- 메시지 내용에서 택배사명과 송장 번호를 파싱하여 카카오 검색 배송조회 페이지로 이동하는 배송 조회하기 버튼을 자동으로 생성함 |
웹 링크 |
- 버튼 클릭 시 인앱 브라우저에서 웹 페이지 실행 - Mobile / PC에서 실행할 URL을 각각 설정 가능 *현재 알림톡은PC에서 메시지 내용이 보이지 않음 |
앱 링크 |
- 버튼 클릭 시 앱 커스텀스킴 실행 - Android /Ios에서 실행할 커스텀스킴 각각 설정 필수 |
봇 키워드 |
- 버튼 클릭 시 유저로부터 ’버튼 명’이 텍스트로 들어간 챗버블이 발송됨 - 봇 또는 상담원에게 유저의 액션을 전달할 때 사용할 수 있음 |
메시지전달 |
- 버튼 클릭 시 유저로부터 ‘버튼 명+메시지 본문’이 텍스트로 들어간 챗버블이 발송됨 - 봇 또는 상담원에게 유저가 수신한 알림톡과 함께 유저의 액션을 전달할 경우 사용 |
채널 추가 | - 카카오톡 채널 추가 버튼 활성화 |
상담톡 전환 |
- 버튼 클릭 시 상담톡으로 전환 - 상담톡을 이용하는 카카오톡 채널만 이용 가능 |
봇 전환 |
- 버튼 클릭 시 봇으로 전환 - 카카오 I 오픈빌더의 챗봇을 사용하는 카카오톡 채널만 이용 가능 |
플러그인 |
- 버튼 클릭 시 플러그인 제공 - 이미지 보안 전송 플러그인, 개인정보이용 플러그인, 원클릭 결제 플러그인 |
비즈니스폼 | - 카카오톡 클라이언트 내에서 고객에게 응모, 설문조사, 신청/예약 등의 다양한 신청을 받을 수 있는 비즈도구 |
#버튼 첨부파일 예시
button.json |
{ "button": [ { "name": "미리 주문하기", "type": "WL", "url_mobile": "http://www.bizppurio.com" }, { "name": "상담원 연결하기", "type": "MD" }, { "name": "방송 알림 설정 보기", "type": "AL", "scheme_android": "daumapps://open", "scheme_ios": "daumapps://open" } ] } |
이미지 타입의 친구톡을 발송하기 위하여 반드시 이미지를 사전에 비즈뿌리오 사이트의 [카카오톡 비즈메시지] – [친구톡 이미지 등록] 을 통해 업로드 해야 합니다. 이후 *[친구톡 이미지 관리]에서 해당 이미지 URL 을 확인하여 발송합니다.
이미지에 대한 정보는 JSON 파일로 만들어 환경설정 파일에서 지정한 파일경로(FILE_PATH)에 JSON 형식 파일을 업로드 한 후, 첨부될 파일은 ATTACHED_FILE 필드에 입력합니다.
이미지, 와이드 이미지
친구톡 이미지 타입 첨부파일의 실제 내용은 다음과 같이 JSON 형태로 구성됩니다.
friend_image.json |
{ "image": { "img_url": "등록된 이미지 URL", "img_link": "http://www.bizppurio.com" } } |
friend_wide_image.json |
{ |
친구톡 와이드 이미지 + 버튼링크 첨부파일의 실제 내용은 다음과 같이 하나의 JSON 형태로 구성됩니다.
friend_wide_image_button.json |
{ "extra": { "msg_type": "fw" }, "button": [ { "name": "미리 주문하기", "type": "WL", "url_mobile": "http://www.bizppurio.com" } ], "image": { "img_url": "등록된 이미지 URL", "img_link": "http://www.bizppurio.com" } } |
와이드 아이템 리스트
와이드 아이템 리스트에 대한 정보는 JSON 파일로 만들어 환경설정파일에서 지정한 파일경로(FILE_PATH)에 JSON형식 파일을 업로드 한 후, 첨부될 파일은 ATTACHED_FILE 필드에 입력합니다.
친구톡 와이드 아이템 리스트 타입 첨부파일의 실제 내용은 다음과 같이 JSON 형태로 구성됩니다.
friend_wide_itemlist.json |
{ "extra": { "msg_type": "fl", "header": "메시지 상단에 표기할 제목" }, "item": { "list": [ { "title": "아이템 제목", "img_url": "등록된 이미지 URL", "url_mobile": "http://www.kakao.com" }, { "title": "아이템 제목", "img_url": "등록된 이미지 URL", "url_mobile": "http://www.kakao.com" }, { "title": "아이템 제목", "img_url": "등록된 이미지 URL", "url_mobile": "http://www.kakao.com" } ] } } |
캐러셀 피드
캐러셀에 대한 정보는 JSON 파일로 만들어 환경설정파일에서 지정한 파일경로(FILE_PATH)에 JSON형식 파일을 업로드 한 후, 첨부될 파일은 ATTACHED_FILE 필드에 입력합니다.
친구톡 캐피드 타입 첨부파일의 실제 내용은 다음과 같이 JSON 형태로 구성됩니다.
friend_carousel.json |
{ "extra": { "msg_type": "fc", "carousel": { "list": [ { "header": "캐러셀 아이템 제목", "message": "캐러셀 아이템 메시지", "attachment": { "button": [ { "name": "버튼 제목", "type": "버튼 타입", "scheme_android": "mobile android 환경에서 버튼 클릭 시 실행할 application custom scheme", "scheme_ios": "mobile ios 환경에서 버튼 클릭 시 실행할 application custom scheme", "url_mobile": " mobile 환경에서 버튼 클릭 시 이동할 url", "url_pc": "pc 환경에서 버튼 클릭 시 이동할 url" } ], "image": { "img_url": "캐러셀 썸네일 이미지 주소", "img_link": "캐러셀 썸네일 링크 주소" } } }, { "header": "캐러셀 아이템 제목2", "message": "캐러셀 아이템 메시지2", "attachment": { "image": { "img_url": "캐러셀 썸네일 이미지 주소", "img_link": "캐러셀 썸네일 링크 주소" } } } ], "tail": { "url_pc": "pc 환경에서 버튼 클릭 시 이동할 url", "url_mobile": " mobile 환경에서 버튼 클릭 시 이동할 url", "scheme_ios": "mobile ios 환경에서 버튼 클릭 시 실행할 application custom scheme", "scheme_android": "mobile android 환경에서 버튼 클릭 시 실행할 application custom scheme" } } } } |
커머스
커머스에 대한 정보는 JSON 파일로 만들어 환경설정파일에서 지정한 파일경로(FILE_PATH)에 JSON형식 파일을 업로드 한 후, 첨부될 파일은 ATTACHED_FILE 필드에 입력합니다.
친구톡 커머스 타입 첨부파일의 실제 내용은 다음과 같이 JSON 형태로 구성됩니다.
friend_commerce.json |
{ "button": [ { "name": "구매하기", "type": "WL", "url_mobile": "http://www.bizppurio.com" } ], "image": { "img_url": "https://mud-kage.kakao.com/dn/1ps88/btsIJbD6CS8/2JIuxHZpmiDEHbX2wM1uO1/img_l.jpg" }, "commerce": { "title": "친구톡 커머스 할인 쿠폰", "regular_price": "99999999", "discount_price": "0", "discount_rate": "100" }, "extra": { "msg_type": "fm", "additional_content": "부가정보", "adult": "Y", "push_alarm": "Y" } } |
프리미엄 동영상
프리미엄 동영상에 대한 정보는 JSON 파일로 만들어 환경설정파일에서 지정한 파일경로(FILE_PATH)에 JSON형식 파일을 업로드 한 후, 첨부될 파일은 ATTACHED_FILE 필드에 입력합니다.
친구톡 프리미엄 동영상 타입 첨부파일의 실제 내용은 다음과 같이 JSON 형태로 구성됩니다.
friend_video.json |
{ "button": [ { "name": "구매하기", "type": "WL", "url_mobile": "http://www.bizppurio.com" } ], "video": { "video_url": "https://tv.kakao.com/channel/10078879/cliplink/447422551", "thumbnail_url": "https://mud-kage.kakao.com/dn/1ps88/btsIJbD6CS8/2JIuxHZpmiDEHbX2wM1uO1/img_l.jpg" }, "extra": { "msg_type": "fp", "header": "헤더" } } |
캐러셀 커머스
캐러셀 커머스에 대한 정보는 JSON 파일로 만들어 환경설정파일에서 지정한 파일경로(FILE_PATH)에 JSON형식 파일을 업로드 한 후, 첨부될 파일은 ATTACHED_FILE 필드에 입력합니다.
친구톡 캐러셀 커머스 타입 첨부파일의 실제 내용은 다음과 같이 JSON 형태로 구성됩니다.
friend_carousel_commerce.json |
{ "extra": { "msg_type": "fa", "carousel": { "head": { "header": "캐러셀 인트로 헤더", "content": "캐러셀 인트로 내용", "image_url": "https://mud-kage.kakao.com/dn/phjWh/btsIG1QxaXK/f8w4Ylf3FQDtf2maYac0qK/img_l.jpg", "url_mobile": "http://www.bizppurio.com" }, "list": [ { "attachment": { "button": [ { "name": "구매하기", "type": "WL", "url_mobile": "http://www.bizppurio.com" } ], "image": { "img_url": "https://mud-kage.kakao.com/dn/bNHrHl/btsIHV27gAH/eaqKIbCazpsxl0E9456OVk/img_l.jpg" }, "commerce": { "title": "친구톡 커머스 할인 쿠폰", "regular_price": "5000", "discount_price": "0", "discount_rate": "100" } } }, { "attachment": { "button": [ { "name": "구매하기", "type": "WL", "url_mobile": "http://www.bizppurio.com" } ], "image": { "img_url": "https://mud-kage.kakao.com/dn/phjWh/btsIG1QxaXK/f8w4Ylf3FQDtf2maYac0qK/img_l.jpg" }, "commerce": { "title": "친구톡 커머스 할인 쿠폰", "regular_price": "5000", "discount_price": "2500", "discount_rate": "50" } } } ] } } } |
쿠폰
쿠폰에 대한 정보는 JSON 파일로 만들어 환경설정파일에서 지정한 파일경로(FILE_PATH)에 JSON형식 파일을 업로드 한 후, 첨부될 파일은 ATTACHED_FILE 필드에 입력합니다.
-
title의 경우 5가지 형식으로 제한 됨
-
"${숫자}원 할인 쿠폰" 숫자는 1이상 99,999,999 이하
-
"${숫자}% 할인 쿠폰" 숫자는 1이상 100 이하
-
"배송비 할인 쿠폰"
-
"${7자 이내} 무료 쿠폰"
-
"${7자 이내} UP 쿠폰"
-
url_pc, url_mobile, scheme_android, scheme_ios의 경우 필수값이 두가지 케이스로 구분됨
-
기본 - url_mobile 필수값 나머지 옵션값
-
채널 쿠폰 URL(포멧: alimtalk=coupon://) 사용 - scheme_android 혹은 scheme_ios 둘 중 하나 필수값 나머지 옵션값
친구톡 이미지 타입 첨부파일의 실제 내용은 다음과 같이 JSON 형태로 구성됩니다
friend_coupon.json |
{ "extra": { "msg_type": "ft" }, "coupon": { "title": "쿠폰 이름 형식", "description": "쿠폰 상세 설명 ( FW, FL, FP - 18자 제한 / 그 외 -12자 )", "url_pc": "pc 환경에서 이미지 클릭 시 이동할 url", "url_mobile": "mobile 환경에서 이미지 클릭 시 이동할 url", "scheme_android": "mobile android 환경에서 쿠폰 클릭 시 실행할 application custom scheme", "scheme_ios": "mobile ios 환경에서 쿠폰 클릭 시 실행할 application custom scheme" } } |
button.json
{
"button": [
{
"name": "미리 주문하기",
"type": "WL",
"url_mobile": "http://www.kakao.com"
}
],
"image": {
"img_url": "등록된 이미지 URL",
"img_link": "http://bizmessage.kakao.com/"
}
}
카카오톡 기본 이모티콘 삽입을 원할 경우 이모티콘에 해당하는 명령어를 입력합니다.
예) 안녕하세요 (하하)(씨익)
RCS
RCS는 비즈뿌리오 서버에 등록된 사용 가능한 챗봇ID와 메시지베이스ID를 사용하여 발송되며 RCS 지원기기 사용자인 경우 발송 가능합니다.
메시지베이스 ID 는 이통사에서 제공하는 메시지 포맷을 사용하거나 RCS 비즈센터를 통해 템플릿을 등록하여 사용가능합니다.
INSERT INTO biz_msg (
MSG_TYPE, CMID, REQUEST_TIME, SEND_TIME, DEST_PHONE, SEND_PHONE, RCS_REFKEY)
VALUES (
8, '201XXXXXXXXX', NOW(), NOW(), '01012341234', '0212341234', {RCS_REFKEY})
RCS 공통포맷 (MESSAGEBASE_ID)
ID | 메시지 유형 | 카드장수 |
카드 별 최대 버튼 수 |
본문 글자 수 | |
SS000000 | SMS | Standalone | 1 | 1 | 100 |
SL000000 | LMS | Standalone Media Top | 1 | 3 | 1300 |
SMwThT00 | MMS | Standalone Media Top | 1 | 2 | 1300 |
SMwThM00 | MMS | Standalone Media Top | 1 | 2 | 1300 |
CMwMhM0300 | MMS | Carousel Medium | 2 | 2 | RCS MMS 슬라이드형 글자/라인수 정의 참고 |
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 | |
OMHITV0001 |
신규 MMS |
이미지 & 타이틀 강조형 (3:4) | 1 | 2 | 150 |
OMHITS0001 |
신규 MMS |
이미지 & 타이틀 강조형 (1:1) | 1 | 2 | |
OMHIMV0001 |
신규 MMS |
이미지 강조형 (3:4) | 1 | 2 | |
OMHIMS0001 |
신규 MMS |
이미지 강조형 (1:1) | 1 | 2 | |
OMTBNV0001 |
신규 MMS |
썸네일형 (세로) | 1 | 2 | |
OMTBNH0001 |
신규 MMS |
썸네일형 (가로) | 1 | 2 | |
OMSNSS0001 |
신규 MMS |
SNS | 1 | 2 | |
OMSNSH0001 |
신규 MMS |
SNS | 1 | 2 | |
UBR로 시작 템플릿별 상이 |
템플릿 | 서술 (description) | 1 | 2 | 90 |
스타일 (cell) | 2 | ||||
기본 (free) | 0 | ||||
IBR로 시작 템플릿별 상이 |
이미지 템플릿 |
신규 MMS 동일 (8종) | 1 | 2 | 150 |
LBR로 시작 템플릿별 상이 |
LMS 템플릿 |
LMS 템플릿 (4종) | 1 | 2 | 1300 |
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 | 21 | 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 |
[줄 수(Media Medium인 경우, 접혀있는 경우)]
버튼 0개 | 버튼 1개 | 버튼 2개 | |
디스크립션 only | 15 | 13 | 11 |
타이틀 1줄 + 디스크립션 | 14 | 12 | 10 |
타이틀 2줄 + 디스크립션 | 13 | 11 | 9 |
MMS (Carousel Medium - 슬라이드)
한 라인에 들어가는 글자 수 (한글 ‘가’ 기준 측정) |
타이틀 | 13 |
디스크립션 | 14 |
줄(라인) 수 | 버튼 0개 | 버튼 1개 | 버튼 2개 | |||
디스크립션 Only | 28 | 26 | 23 | |||
타이틀 1줄 + 디스크립션 | 27 | 25 | 23 | |||
타이틀 2줄 + 디스크립션 | 26 | 23 | 21 | |||
타이틀 3줄 + 디스크립션 | 24 | 22 | 20 | |||
버튼 0개 | 버튼 1개 | 버튼 2개 | ||||
디스크립션 Only | 17 | 15 | 13 | |||
타이틀 1줄 + 디스크립션 | 16 | 14 | 12 | |||
타이틀 2줄 + 디스크립션 | 15 | 13 | 11 | |||
타이틀 3줄 + 디스크립션 | 14 | 12 | 10 |
RCS BODY
1. 신규 MMS 제외
키 | 타입 | 필수 | 설명 |
media | text | N | main 첨부파일 |
title | text | N | main 제목 |
description | text | N | main 내용 |
title1 | text | N | 1번째 카드 제목 |
description1 | text | N | 1번째 카드 본문 텍스트 |
media1 | text | N | 1번째 카드 첨부파일 |
* 리치카드 개수 및 순서에 따라 넘버링 (title1, title2 … …)
2. 신규 MMS, 이미지 템플릿 발송 규격 – 이미지 & 타이틀 강조형
키 | 타입 | 필수 | 설명 |
media | text | Y | 이미지 *이미지 템플릿 발송 시 불필요 |
mediaUrl | text | N | 이미지 클릭 시 랜딩 URL |
title | text | N | 제목 |
subTitle1 | text | Y | 소제목 1 |
subDesc1 | text | Y | 소본문 1 |
3. 신규 MMS, 이미지 템플릿 발송 규격 – 이미지 강조형, SNS형
키 | 타입 | 필수 | 설명 |
media | text | Y | 이미지 *이미지 템플릿 발송 시 불필요 |
mediaUrl | text | N | 이미지 클릭 시 랜딩 URL |
title | text | N | 제목 |
description | text | Y | 본문 |
4. 신규 MMS, 이미지 템플릿 발송 규격 – 썸네일형 (세로)
키 | 타입 | 필수 | 설명 |
media | text | Y | main 첨부파일 *이미지 템플릿 발송 시 불필요 |
mediaUrl | text | N | 이미지 클릭 시 랜딩 URL |
title | text | N | 제목 |
description | text | N | 본문 |
subMedia1 | text | Y | 서브 이미지 1 |
subMediaUrl1 | text | N | 서브 이미지 1 클릭 시 랜딩 URL |
subDesc1 | text | Y | 소본문 1 |
* 리치카드 개수 및 순서에 따라 넘버링 (title1, title2 … …)
5. 신규 MMS, 이미지 템플릿 발송 규격 – 썸네일형 (가로)
키 | 타입 | 필수 | 설명 |
media | text | Y | main 첨부파일 *이미지 템플릿 발송 시 불필요 |
mediaUrl | text | N | 이미지 클릭 시 랜딩 URL |
title | text | N | 제목 |
description | text | N | 본문 |
subMedia1 | text | Y | 서브 이미지 1 |
subMediaUrl1 | text | N | 서브 이미지 1 클릭 시 랜딩 URL |
리치카드 개수 및 순서에 따라 넘버링 (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 종류
1. 이미지
-
비즈뿌리오 사이트 [메시지관리] - [RCS 관리] - [RCS 이미지 관리] 에서 이미지를 등록하여 사용합니다. 이미지는 등록일로부터 365일간 발송 가능합니다. (이후 자동 삭제)
이미지 URL 포맷 maapfile://{fileId} 예시 “media”:“maapfile://BR.i6dOpSm8N8.20200302150000.001”
-
3가지 형태의 YouTube URL 주소 지원 (정확한 형식을 준수해야 하며, 일부만 일치하는 경우 실패)
-
동영상 썸네일은 등록된 이미지만 사용 가능하며 YouTube URL 뒤에 콤마(,)와 함께 입력
(콤마(,) 외 공백을 포함하는 경우 실패)
-
동영상 발송 시 Footer에 '동영상 재생 시 데이터 요금제가 적용됩니다.'라는 문구 자동 삽입
동영상 스트리밍 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 에 버튼 링크를 추가하고자 할 경우 아래와 같은 JSON 형식에 맞춰 RCS 테이블(BIZ_RCS)의 BUTTONS 필드에 입력합니다.
INSERT INTO biz_msg (
MSG_TYPE, CMID, REQUEST_TIME, SEND_TIME, DEST_PHONE, SEND_PHONE, RCS_REFKEY)
VALUES (
8, '201XXXXXXXXX', NOW(), NOW(), '01012341234', '0212341234', {RCS_REFKEY})
BUTTONS (대문자)
키 | 타입 | 필수 | 설명 |
suggestions | Array | N |
Suggestions (소문자)
키 | 타입 | 필수 | 설명 |
action | Object | Y |
action (소문자)
키 | 타입 | 필수 | 설명 |
[ Action 타입 ] | Object | Y | |
displayText | Y | 버튼에 출력될 텍스트 | |
postback | N |
postback (소문자)
키 | 타입 | 필수 | 설명 |
data | Y |
# Action 타입
1. urlAction
필드 1 | 필드 2 | 필드 3 | 설명 |
urlAction | URL 연결하기 | ||
openUrl | |||
url |
2. dialerAction
필드 1 | 필드 2 | 필드 3 | 설명 |
dialerAction | 전화 연결하기 | ||
dialPhoneNumber | |||
phoneNumber |
3. mapAction
필드 1 | 필드 2 | 필드 3 | 필드 4 | 설명 |
mapAction | 지도 보여주기 | |||
showLocation | ||||
location | ||||
query | ||||
latitude | ||||
longitude | ||||
label | ||||
fallbackUrl |
4. mapAction
필드 1 | 필드 2 | 설명 |
mapAction | 현재 위치 공유하기 | |
requestLocationPush |
5. calendarAction
필드 1 | 필드 2 | 필드 3 | 설명 |
calendarAction | 캘린더 등록 | ||
createCalendarEvent | |||
startTime | |||
endTime | |||
title | |||
description |
6. composeAction
필드 1 | 필드 2 | 필드 3 | 설명 |
composeAction | 메시지 전송 | ||
composeTextMessage | |||
phoneNumber | |||
text |
7. clipboardAction
필드 1 | 필드 2 | 필드 3 | 설명 |
clipboardAction | 복사하기 | ||
copyToClipboard | |||
text |
# Action 예시
버튼 표현 방식 3장의 카드이고 2, 0, 1의 버튼이 있다고 가정하면 BUTTONS는 아래와 같이 구성 할 수 있습니다. (JSON KEY 대소문자 구분)
{
"BUTTONS": [
{
"suggestions": [
{
"action": {
"urlAction": {
"openUrl": {
"url": "https://www.google.com"
}
},
"displayText": "Open website or deep link",
"postback": {
"data": "set_by_chatbot_open_url"
}
}
},
{
"action": {
"urlAction": {
"openUrl": {
"url": "https://www.google2.com"
}
},
"displayText": "Open website or deep link",
"postback": {
"data": "set_by_chatbot_open_url_2"
}
}
}
]
},
{},
{
"suggestions": [
{
"action": {
"urlAction": {
"openUrl": {
"url": "https://www.google2.com"
}
},
"displayText": "Open website or deep link",
"postback": {
"data": "set_by_chatbot_open_url_2"
}
}
}
]
}
]
}
New RCS examples
Highlighted image n title (이미지 & 타이틀 강조형)
{
"body": {
"media": "maapfile://fileId123", (필수)
"title": "제목",
"subTitle1": "소제목1",(필수)
"subDesc1": "소본문1",(필수)
"subTitle2": "소제목2",
"subDesc2": "소본문2"
},
"buttons": [
{
"suggestions": [
{
"action": {
"urlAction": {
"openUrl": {
"url": "https://www.google.com"
}
},
"displayText": "구글"
}
},
{
"action": {
"urlAction": {
"openUrl": {
"url": "https://www.naver.com"
}
},
"displayText": "네이버"
}
}
]
}
]
}
이미지 강조형, SNS형
{
"body": {
"media": "maapfile://fileId123",(필수)
"title": "제목",
"description": "본문"(필수)
},
"buttons": [
{
"suggestions": [
{
"action": {
"urlAction": {
"openUrl": {
"url": "https://www.google.com"
}
},
"displayText": "구글"
}
},
{
"action": {
"urlAction": {
"openUrl": {
"url": "https://www.naver.com"
}
},
"displayText": "네이버"
}
}
]
}
]
}
썸네일형 (세로)
{
"body": {
"media": "maapfile://fileId123",(필수)
"title": "제목",
"description": "본문",
"subMedia1": "maapfile://fileid456",(필수)
"subMediaUrl1": "http://www.naver.com",
"subDesc1": "소본문1 이미지클릭가능",(필수)
"subMedia2": "maapfile://fileid789",(필수)
"subDesc2": "소본문2 이미지클릭불가"(필수)
},
"buttons": [
{
"suggestions": [
{
"action": {
"urlAction": {
"openUrl": {
"url": "https://www.google.com"
}
},
"displayText": "구글"
}
},
{
"action": {
"urlAction": {
"openUrl": {
"url": "https://www.naver.com"
}
},
"displayText": "네이버"
}
}
]
}
]
}
썸네일형 (가로)
{
"body": {
"media": "maapfile://fileId123",(필수)
"title": "제목",
"description": "본문",(필수)
"subMedia1": "maapfile://fileid456",(필수)
"subMediaUrl1": "http://www.naver.com",
"subMedia2": "maapfile://fileid789",(필수)
"subMedia3": "maapfile://fileid000"(필수)
},
"buttons": [
{
"suggestions": [
{
"action": {
"urlAction": {
"openUrl": {
"url": "https://www.google.com"
}
},
"displayText": "구글"
}
},
{
"action": {
"urlAction": {
"openUrl": {
"url": "https://www.naver.com"
}
},
"displayText": "네이버"
}
}
]
}
]
}
1차 대체발송 타입에 따라 최대 2 차 대체발송까지 가능합니다.
RCS 결과 실패 시 지정하신 대체발송타입(SMS/MMS/AT/FT)과 대체발송본문을 사용하여 발송됩니다. (단, 비즈뿌리오 ID 가 대체 발송 사용 가능하도록 설정되어 있어야 합니다.) (SMS 대체발송의 경우에는 메시지 본문 (RE_BODY) 길이가 SMS 의 허용 길이를 초과하였을 때 발송되지 않습니다.)
RCS + SMS
INSERT INTO biz_msg (
MSG_TYPE, CMID, REQUEST_TIME, SEND_TIME,
DEST_PHONE, SEND_PHONE, RCS_REFKEY, RE_TYPE, RE_BODY)
VALUES (
8, '201XXXXXXXXX', NOW(), NOW(), '01012341234', '0212341234',
{RCS_REFKEY}, 'SMS', '[다우기술] 응모하신 프로모션에 당첨되셨습니다.')
RCS + MMS
INSERT INTO biz_msg (
MSG_TYPE, CMID, REQUEST_TIME, SEND_TIME,
DEST_PHONE, SEND_PHONE, RCS_REFKEY, RE_TYPE, RE_BODY, ATTACHED_FILE)
VALUES (
8, '201XXXXXXXXX', NOW(), NOW(), '01012341234', '0212341234',
{RCS_REFKEY}, 'MMS', '[다우기술] 응모하신 프로모션에 당첨되셨습니다.', '{첨부파일.jpg}')
아래의 알림톡/친구톡으로 대체 발송 하는 경우 MSG_BODY 필드의 데이터를 사용하여 발송됩니다.
RCS + AT
INSERT INTO biz_msg (
MSG_TYPE, CMID, REQUEST_TIME, SEND_TIME, DEST_PHONE, SEND_PHONE,
MSG_BODY, TEMPLATE_CODE, SENDER_KEY, NATION_CODE, RE_TYPE, RCS_REFKEY)
VALUES (
8, '201XXXXXXXXX', NOW(), NOW(), '01012341234', '0212341234',
'홍길동 고객님 다우기술 비즈메시지 프로모션에 당첨 되었습니다.', {템플릿코드}, {발신프로필키},
'82', 'K', '{RCS_REFKEY}')
RCS + FT
INSERT INTO biz_msg (
MSG_TYPE, CMID, REQUEST_TIME, SEND_TIME, DEST_PHONE, SEND_PHONE,
MSG_BODY, SENDER_KEY, NATION_CODE, RE_TYPE, RCS_REFKEY)
VALUES (
8, '201XXXXXXXXX', NOW(), NOW(), '01012341234', '0212341234',
'홍길동 고객님 다우기술 비즈메시지 프로모션에 당첨 되었습니다.', {발신프로필키},
'82', 'B', '{RCS_REFKEY}')
대체 발송이 이루어진 경우, 클라이언트는 수신 받은 리포트를 업데이트하는 시점에 대체 발송에 대한 정보를 추가 레코드로 신규 생성하게 됩니다. RCS 와 대체 발송에 대한 레코드의 매핑 키는 알림톡/친구톡의 UMID 필드가 대체 발송의 CMID 필드로 이루어집니다.
RCS 결과 실패 시 지정하신 1 차 대체 발송 타입(AT/FT)을 발송하며 알림톡/친구톡 발송 결과 실패 시 지정하신 2 차 대체 발송 타입(SMS/MMS)과 대체 발송 본문을 사용하여 발송됩니다. 알림톡/친구톡 대체 발송의 경우 MSG_BODY 필드의 데이터를 사용하여 발송되며 SMS/MMS 대체 발송의 경우 대체 발송 본문에 대해 알림톡/친구톡과 동일 본문(MSG_BODY)을 사용하려면, 대체 발송 메시지 필드(RE_BODY)를 비워두시면 됩니다.
단, 비즈뿌리오 ID 가 대체 발송 사용 가능하도록 설정되어 있어야 합니다. SMS 대체발송의 경우에는 메시지 본문 (MSG_BODY) 길이가 SMS 의 허용 길이를 초과하였을 때 발송되지 않습니다.
알림톡/친구톡 대체 발송의 경우 MSG_BODY 필드의 데이터를 사용하여 발송됩니다.
RCS + AT(1차) + SMS(2차)
INSERT INTO biz_msg (
MSG_TYPE, CMID, REQUEST_TIME, SEND_TIME, DEST_PHONE, SEND_PHONE,
RCS_REFKEY, RE_TYPE, MSG_BODY,TEMPLATE_CODE, SENDER_KEY, NATION_CODE, RE_BODY )
VALUES (
8, '201XXXXXXXXX', NOW(), NOW(), '01012341234', '0212341234',
{RCS_REFKEY}, 'KS', ' 홍길동 고객님 다우기술 비즈메시지 프로모션에 당첨 되었습니다.',
{템플릿코드}, {발신프로필키}, '82', '[다우기술] 응모하신 프로모션에 당첨되셨습니다.')
RCS + AT(1차) + SMS(2차)
INSERT INTO biz_msg (
MSG_TYPE, CMID, REQUEST_TIME, SEND_TIME, DEST_PHONE, SEND_PHONE,
RCS_REFKEY, RE_TYPE, MSG_BODY, TEMPLATE_CODE, SENDER_KEY, NATION_CODE, RE_BODY,
ATTACHED_FILE )
VALUES (
8, '201XXXXXXXXX', NOW(), NOW(), '01012341234', '0212341234',
{RCS_REFKEY}, 'KM', ' 홍길동 고객님 다우기술 비즈메시지 프로모션에 당첨 되었습니다.',
{템플릿코드}, {발신프로필키}, '82', '[다우기술] 응모하신 프로모션에 당첨되셨습니다.', {첨부파일.jpg})
RCS + FT(1차) + SMS(2차)
INSERT INTO biz_msg (
MSG_TYPE, CMID, REQUEST_TIME, SEND_TIME, DEST_PHONE, SEND_PHONE,
RCS_REFKEY, RE_TYPE, MSG_BODY, SENDER_KEY, NATION_CODE, RE_BODY )
VALUES (8, ‘201XXXXXXXXX’, NOW(), NOW(), ‘01012341234’, ‘0212341234’,
{RCS_REFKEY}, ‘BS’, ‘ 홍길동 고객님 다우기술 비즈메시지 프로모션에 당첨 되었습니다.’,
{발신프로필키}, ‘82’, ‘[다우기술] 응모하신 프로모션에 당첨되셨습니다.’)
RCS + FT(1차) + SMS(2차)
INSERT INTO biz_msg (
MSG_TYPE, CMID, REQUEST_TIME, SEND_TIME, DEST_PHONE, SEND_PHONE,
RCS_REFKEY, RE_TYPE, MSG_BODY, SENDER_KEY, NATION_CODE, RE_BODY, ATTACHED_FILE )
VALUES (8,'201XXXXXXXXX', NOW(), NOW(), '01012341234', '0212341234',
{RCS_REFKEY}, 'BM', ' 홍길동 고객님 다우기술 비즈메시지 프로모션에 당첨 되었습니다.',
{발신프로필키}, '82', '[다우기술] 응모하신 프로모션에 당첨되셨습니다.', {첨부파일.jpg})
대체 발송이 이루어진 경우, 클라이언트는 수신 받은 리포트를 업데이트하는 시점에 대체 발송에 대한 정보를 추가 레코드로 신규 생성하게 됩니다. RCS 와 대체 발송에 대한 레코드의 매핑 키는 RCS 의 UMID 필드가 대체 발송의 CMID 필드로 이루어집니다.
2차 대체 발송이 이루어진 경우, RCS의 UMID값 앞에 "**RE_"**이 추가된 문자열이 2차 대체발송의 CMID 필드로 이루어지며 1차 대체발송의 UMID 도 같은 값으로 설정됩니다.
FAX
한글 100자 이하의 표지를 포함한 이미지 및 문서를 발송할 수 있습니다.
INSERT INTO biz_msg (
MSG_TYPE, CMID, REQUEST_TIME, SEND_TIME, DEST_PHONE, SEND_PHONE,
SUBJECT, MSG_BODY, ATTACHED_FILE, COVER_FLAG)
VALUES (
2, '201XXXXXXXXX', NOW(), NOW(), '03112341234', '0212341234',
'표지제목', '표지내용', {첨부파일}, {팩스표지 사용여부 (사용할 경우 1 입력)})
PHONE
한글 100자 이하의 TTS(Text to Speech) 및 3분 미만의 WAVE 파일을 발송할 수 있습니다.
INSERT INTO biz_msg (MSG_TYPE, CMID, REQUEST_TIME, SEND_TIME, DEST_PHONE,
SEND_PHONE, MSG_BODY, VXML_FILE, REPLY_FLAG)
VALUES (3, '201XXXXXXXXX', NOW(), NOW(), '01012341234', '0212341234',
'본 메시지는 테스트입니다. 다우기술 비즈메시지 서비스를 이용해주셔서 감사합니다.',
{시나리오파일 사용시, 시나리오파일명}, {시나리오 답변 기능 사용여부 (사용할 경우 1 입력)});
대체 발송 시나리오
댓글
댓글 0개
이 문서에는 댓글을 달 수 없습니다.