Kakao i Connect Message::BizMessage(KOR)::Agent 설치 방식::다채널 대체 발송

페이지 이동경로

다채널 대체 발송

다채널 대체 발송은 기존 대체 발송(부달 발송)이 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 네이버톡톡 전체 본문 발송
이 문서가 만족스러운 이유를 알려주세요.
이 문서에 아쉬운 점을 알려주세요.
평가해주셔서 감사합니다.

더 자세한 의견은 contact.dkt@kakaocorp.com 으로 제보해주세요.