다채널 대체 발송
다채널 대체 발송은 기존 대체 발송(부달 발송)이 SMS, LMS만 지원하던 것과 달리 대체 발송 채널을 다양화하여 발송할 수 있는 기능입니다. 다채널 대체 발송은 Rule 기반의 발송으로, 사용 시 고객사가 웹 화면에서 대체 발송 타입 진행 순서를 설정해야 합니다. 다채널 대체 발송의 Rule은 부서 코드와 1:1 맵핑되므로 발송 시 부서 코드를 첨부하면, 맵핑된 Rule을 참조하여 대체 발송이 진행됩니다. (부서 코드는 웹 화면에서 생성할 수 있습니다.)
대체 발송 타입을 발송 데이터에 임의로 지정할 시 기존 방식과 동일한 대체 발송이 진행됩니다. (SMS, LMS에 대한 1번의 대체 발송)
안내
- 다채널 대체 발송은 계약 정보 수정이 필요하므로, 별도 문의하시기 바랍니다.
- 다채널 대체 발송 관련 웹 화면은 추후 지원 예정입니다.
- 다채널 대체 발송은 발송/결과 테이블의 칼럼이 추가되므로 추가 대응이 필수로 요구됩니다.
다채널 대체 발송 사용 여부가 계약 정보에 반영되면, 아래와 같이 multiFallback의 값을 true
로 설정해야합니다. 다채널 대체 발송 사용 시 신규 칼럼이 추가됩니다. (동일한 이름의 테이블이 존재할 경우 추가되지 않습니다.)
코드예제agent.ini Syntax
[AGENT]
client_id=TEST0001
agent_id=TEST0001001
agent_type=AT
at_type=PUSH
multiFallback=true
신규 결과 칼럼 정보
다채널 대체 발송 사용 시 아래 칼럼이 추가로 생성됩니다. 1~5는 5개로 확장되는 칼럼입니다.
안내표신규 칼럼 정보
RESULT_MSG_TYPE1은 최초 발송 메시지 타입으로 고정됩니다.
에이전트 종류 | 칼럼 | 설명 |
---|---|---|
공통 | RESULT_MSG_TYPE(1~5) | 결과 메시지 타입 |
RESULT_CD(1~5) | 결과 코드 | |
SERVER_SEND_DATE(1~5) | 발송 요청 시간 (KEP 중계기 → 발송사) | |
RESULT_DATE(1~5) | 결과 수신 시간 (발송사 → KEP 중계기) | |
DEPARTMENT_CD | 부서 코드 - 부서 코드에 맵핑된 다채널 대체 발송 전략을 참조하여 발송 |
|
알림톡, 친구톡 | TELECOM_CD(1~5) | 통신사 코드 |
FALLBACK_YN | 대체 발송 사용 여부 | |
RCS | ERROR_MESSAGE(1~5) | 결과 상세 메시지 |
MNO_INFO(1~5) | 통신사 코드 | |
XMS | TELECOM_CD(1~5) | 통신사 코드 |
FALLBACK_YN | 대체 발송 사용 여부 | |
FALLBACK_SUBJECT | 대체 발송 제목 | |
FALLBACK_MESSAGE | 대체 발송 메시지 | |
네이버톡톡 | ERROR_MESSAGE(1~5) | 결과 상세 메시지 |
TELECOM_CD(1~5) | 통신사 코드 |
다채널 메시지 발송하기
다채널 대체 서비스로 다양한 메시지 유형에 따라 메시지를 테스트 발송할 수 있는 코드 예제를 제공합니다.
알림톡 발송
알림톡으로 대체 메시지를 발송합니다.
코드예제알림톡 발송 Sample Code
INSERT INTO K_MESSAGE (
KKO_MSG,
MSG_TYPE,
MOBILE_NO,
SENDER_NO,
RESERVE_DATE,
KKO_TEMPLATE_CD,
KKO_TEMPLATE_TYPE,
KKO_BTN_LINK1,
KKO_BTN_LINK2,
KKO_BTN_LINK3,
KKO_BTN_LINK4,
KKO_BTN_LINK5,
KKO_QUICK_REPLY1,
KKO_QUICK_REPLY2,
KKO_QUICK_REPLY3,
KKO_QUICK_REPLY4,
KKO_QUICK_REPLY5,
KKO_QUICK_REPLY6,
KKO_QUICK_REPLY7,
KKO_QUICK_REPLY8,
KKO_QUICK_REPLY9,
KKO_QUICK_REPLY10,
PHONE_MSG,
TITLE,
REG_DATE,
FALLBACK_YN,
DEPARTMENT_CD
) VALUES (
'[카카오뮤직] 회원가입 안내
고객명님, 카카오뮤직 회원이 되신 것을 환영합니다.
▶신규 가입 회원 혜택
1개월 무료 스트리밍 서비스 제공
카카오톡 이모티콘 증정',
'KX', # 메시지 타입. 대체 발송 타입은 지정하지 않아야 다채널 대체 발송이 이루어짐.
‘99999999’, # 수신자 번호 변경 필요
'99999999', # 발신자 번호 변경 필요
NOW(), # 미래 시간 입력 시, 예약 발송
'alimtalktest_001', # 템플릿 코드
'AT', # 기본 템플릿(기본 및 강조표기형) - AT, 이미지 템플릿 - AI '{"name":"앱링크버튼","type":"AL","scheme_android":"https://kakao.com","scheme_ios":"https://kakao.com","url_mobile":"https://kakao.com"}',
'{"name":"웹링크버튼","type":"WL","url_mobile":"http://kakao.com"}',
NULL,
NULL,
NULL,
'{"name":"바로연결1","type":"WL","url_mobile":"http://kakao.com"}',
'{"name":"바로연결2","type":"WL","url_mobile":"http://kakao.com"}',
NULL,
NULL,
NULL,
NULL,
NULL,
NULL,
NULL,
NULL,
'message',
'title1',
NOW(),
1, # 신규 컬럼. 대체 발송 진행 여부를 임의로 넣어주어야함.
'Downtown-001' # 신규 컬럼. 부서 코드를 넣어야함. (이는 웹 화면에서 생성해야함)
);
RCS 발송
RCS로 대체 메시지를 발송합니다.
코드예제RCS 발송 Sample Code
# RCSSMS 기본형 + BUTTONS 1개
INSERT INTO RCS_MESSAGE (
RESERVE_DATE,
AGENCY_ID,
PHONE_NO,
CALLBACK,
MESSAGE_BASE_ID,
SERVICE_TYPE,
HEADER,
FOOTER,
COPY_ALLOWED,
BODY,
BUTTONS,
FALLBACK_YN,
FALLBACK_CALLBACK,
FALLBACK_MESSAGE,
DEPARTMENT_CD
) VALUES (
now(),
‘kakaoenterprise’,
‘99999999’, # 수신자번호 수정필요
99999999, # 발신자번호 수정 필요
'SS000000', # 메시지 템플릿 코드
'RCSSMS', # [RCSSMS, RCSLMS, RCSMMS, RCSTMPL]
'1', # 0 : 정보성, 1 : 광고성
'080-0000-0000', # 광고성인 경우 필수 입력
true,
'{ "title": "","description":"일반 RCSSMS 테스트 메시지 입니다.\\n" }',
'[{"suggestions":[{
"action":{
"urlAction": {
"openUrl": {
"url": "https://www.google.com"
}
},
"displayText": "Open Url",
"postback": {
"data": "set_by_open_url"
}
}
}]
}
]',
1,
‘99999999’, # 발신자번호 수정 필요
'대체발송 메시지', # 대체 발송 타입 지정하지 않으면 다채널 대체 발송 진행
'Downtown-001' # 신규 컬럼. 부서 코드를 넣어야함. (이는 웹 화면에서 생성해야함)
);
XMS 발송
XMS로 대체 메시지를 발송합니다.
코드예제XMS 발송 Sample Code
INSERT INTO XMS_MESSAGE (
PHONE_MSG,
TITLE,
MSG_TYPE,
MOBILE_NO,
SENDER_NO,
IMG_ATTACH_CD,
MMS_IMG1,
MMS_IMG2,
MMS_IMG3,
REG_DATE,
FALLBACK_YN,
FALLBACK_MESSAGE,
DEPARTMENT_CD
) VALUES (
'LMS 메시지 입니다.',
'LMS 제목입니다.',
'LM', # 메시지 타입, 메시지 타입은 테이블 명세 참조
'01000000000', # 수신자 번호 변경 필요
'99999999999', # 발신자 번호 변경 필요
'N', # IMG_ATTACH_CD : LMS 에서는 해당 값을 ‘N’
NULL, # MMS_IMG1 : LMS 에서는 해당 값을 null 처리
NULL, # MMS_IMG2 : LMS 에서는 해당 값을 null 처리
NULL, # MMS_IMG3 : LMS 에서는 해당 값을 null 처리
NOW(),
1,
'대체 발송 메시지', # 대체 발송 타입 지정하지 않으면 다채널 대체 발송 진행
'Downtown-001' # 신규 컬럼. 부서 코드를 넣어야함. (이는 웹 화면에서 생성해야함)
);
네이버톡톡 발송
네이버톡톡으로 대체 메시지를 발송합니다.
코드예제네이버톡톡 발송 Sample Code
INSERT INTO NAVER_MESSAGE (
MESSAGE_TYPE,
TEMPLATE_CODE,
TEMPLATE_PARAMS,
USER_NAME,
SENDER_KEY,
PHONE_NUMBER,
ATTACHMENTS,
FALLBACK_YN,
FALLBACK_MESSAGE,
FALLBACK_CALLBACK,
FALLBACK_SUBJECT,
DEPARTMENT_CD
) VALUES (
'NT_TM',
'NT-20221117174151',
'{"이름": "홍길동", "휴대폰번호": "821099999999"}',
‘홍길동’,
‘senderkey',
8299999999, # 수신자 번호 변경 필요
'',
1,
'대체 메시지',
'99999999', # 발신자 번호 변경 필요
'대체 서브젝트', # 대체 발송 타입 지정하지 않으면 다채널 대체 발송 진행
'Downtown-001' # 신규 컬럼. 부서 코드를 넣어야함. (이는 웹 화면에서 생성해야함)
);
결과 타입 (RESULT_MSG_TYPE) 종류
표결과 타입항목 | 값 | 설명 |
---|---|---|
RESULT_MSG_TYPE | AT | 알림톡 |
AI | 알림톡 이미지(이미지 포함 발송) | |
FT | 친구톡 | |
FI | 친구톡 이미지(이미지 포함 발송) | |
FW | 친구톡 와이드 이미지(이미지 포함 발송) | |
SM | SMS | |
LM | LMS | |
MM | MMS | |
ISM | 국제 SMS | |
ILM | 국제 LMS | |
RCSSMS | RCSSMS | |
RCSLMS | RCSLMS | |
RCSMMS | RCSMMS | |
RCSTMPL | RCS 템플릿 | |
NT_TM | 네이버톡톡 변수부만 발송 | |
NT_FM | 네이버톡톡 전체 본문 발송 |