알림톡 발송
알림톡은 기업 고객이 사용자에게 ‘정보성’ 카카오톡 메시지를 발송하는 서비스이며, 카카오톡 채널과 친구를 맺지 않은 사용자에게도 발송할 수 있습니다.
알림톡으로 전송 가능한 메시지는 정보통신망법 관련 한국인터넷진흥원(KISA) 가이드상 ‘광고성 정보의 예외’ 중 사용자 보호 차원에서 서비스에 적합하다고 보는 일부 정보성 메시지에 한합니다. 예를 들어 고객의 행동에 따라 즉각적으로 발송하는 정보성 내용인 주문/예약 확인, 결제 내역, 배송 현황 메시지 등이 해당합니다. 구독자 대상의 뉴스레터, 회원가입 축하, 공지문 등은 정보성 메시지에 포함되지 않습니다.
알림톡으로 스팸 메시지를 발송하는 경우, 알림톡 및 카카오톡 채널 운영이 중단될 수 있으며 과태료가 부과될 수 있습니다. 정보성 메시지 관련 상세 내용은 KISA 불법스팸대응센터를 통해 확인할 수 있습니다. 자세한 설명은 KISA 불법 스팸 방지를 위한 정보통신망법 안내서(제5차 개정판) 바로가기를 참고하시기 바랍니다.
안내
- 버튼 가이드 및 메시지 유형별 스펙에 대한 자세한 정보는 부록. 메시지 타입별 가이드 및 스펙 문서를 참고하시기 바랍니다.
- 각 테이블에 입력하는 데이터는 테이블 명세 문서를 참고하시기 바랍니다.
- 알림톡을 발송하기 위해서는 Kakao Biz Message 사이트에서 템플릿을 등록 후 검수를 받아야 합니다.
알림톡만 발송하기
알림톡 발송을 위해서는 알림톡 발송 테이블에 데이터를 입력해야 합니다. INSERT 구문의 주요 칼럼은 다음과 같습니다.
표INSERT 구문의 주요 칼럼칼럼 | 설명 |
---|---|
MSG_TYPE | 알림톡(대체 메시지 없음)만 발송 |
KX 로 고정 |
|
SEND_TYPE |
메시지 발송 유형 |
S : 메시지 실시간 발송 |
|
M : 대량 메시지를 배치로 발송 |
|
IMG_ATTACH_CD | 이미지 첨부 여부 |
N : 이미지 첨부 없음 |
|
Y : 이미지 첨부 있고, SEND_TYPE이 S 인 경우 |
|
M : 이미지 첨부 있고, SEND_TYPE이 M 인 경우 |
|
KKO_TEMPLATE_TYPE | 알림톡의 템플릿 유형 - NULL 로 입력 시, 서버는 AT로 인식 |
AT : 일반적인 텍스트형 템플릿인 경우 |
|
AI : 알림톡의 템플릿이 이미지형 템플릿인 경우 |
코드예제알림톡 발송 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,
REG_DATE
) VALUES (
'[카카오뮤직] 회원가입 안내
고객명님, 카카오뮤직 회원이 되신 것을 환영합니다.
▶ 신규 가입 회원 혜택
1개월 무료 스트리밍 서비스 제공
카카오톡 이모티콘 증정',
'KX', # 알림톡(대체 메시지 없음)만 발송
'99999999999', # 수신자 번호
'99999999999', # 발신자 번호
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,
NOW ()
);
안내
각 칼럼에 대한 자세한 설명은 테이블 명세 문서를 참고하시기 바랍니다.
주의
알림톡 발송은 사전에 템플릿을 등록 후 발송할 수 있으며, 카카오에서 승인되지 않는 템플릿으로는 알림톡을 발송할 수 없습니다.
- 승인된 템플릿과 일치하지 않는 내용, 버튼 및 바로 연결 정보가 존재할 경우 알림톡은 발송되지 않습니다.
- 알림톡 발송인 경우 KKO_TEMPLATE_TYPE 의 값을 템플릿 유형에 맞게 정확히 입력합니다.
- 강조 유형이 이미지형인 경우에는 KO_TEMPLATE_TYPE을
AI
, 그 외는AT
로 설정합니다.
알림톡 + SMS 대체 메시지 발송하기
알림톡 발송 실패 시, 알림톡과 함께 SMS 형식의 대체 메시지를 발송을 할 수 있습니다.
표INSERT 구문의 주요 칼럼칼럼 | 설명 |
---|---|
MSG_TYPE | 알림톡과 SMS 대체 메시지 발송 |
KS 로 고정 |
|
SEND_TYPE |
메시지 발송 유형 |
S : 메시지 실시간 발송 |
|
M : 대량 메시지를 배치로 발송 |
|
IMG_ATTACH_CD | 이미지 첨부 여부 |
N : 이미지 첨부 없음 |
|
Y : 이미지 첨부 있고, SEND_TYPE이 S 인 경우 |
|
M : 이미지 첨부 있고, SEND_TYPE이 M 인 경우 |
|
KKO_TEMPLATE_TYPE | 알림톡의 템플릿 유형 |
AT : 일반적인 텍스트형 템플릿인 경우 |
|
AI : 알림톡의 템플릿이 이미지형 템플릿인 경우 |
코드예제알림톡 + SMS 발송 Sample Code
INSERT INTO K_MESSAGE (
KKO_MSG,
PHONE_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,
REG_DATE
) VALUES (
'[카카오뮤직] 회원가입 안내
고객명님, 카카오뮤직 회원이 되신 것을 환영합니다.
▶신규 가입 회원 혜택
1개월 무료 스트리밍 서비스 제공
카카오톡 이모티콘 증정',
‘SMS 부달 메시지입니다.’,
'KS', # 메시지 타입, 메시지 타입은 테이블 명세 참조
'99999999999', # 수신자 번호 변경 필요
'99999999999', # 발신자 번호 변경 필요
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,
NOW ()
);
알림톡 + LMS(MMS) 대체 메시지 발송하기
알림톡 발송 실패 시, 알림톡과 함께 LMS 형식의 대체 메시지를 발송할 수 있습니다.
안내표INSERT 구문의 주요 칼럼
LMS는 IMG_ATTACH_CD가N
이고 MMS_IMG1~3 값이NULL
인 경우 발송됩니다.
칼럼 | 설명 |
---|---|
MSG_TYPE | 알림톡과 LMS 대체 메시지 발송 |
KM 으로 고정 |
|
SEND_TYPE |
메시지 발송 유형 |
S : 메시지 실시간 발송 |
|
M : 대량 메시지를 배치로 발송 |
|
IMG_ATTACH_CD | 이미지 첨부 여부 |
N : 이미지 첨부 없음 |
|
Y : 이미지 첨부 있고, SEND_TYPE이 S 인 경우 |
|
M : 이미지 첨부 있고, SEND_TYPE이 M 인 경우 |
|
KKO_TEMPLATE_TYPE | 알림톡의 템플릿 유형 |
AT : 일반적인 텍스트형 템플릿인 경우 |
|
AI : 알림톡의 템플릿이 이미지형 템플릿인 경우 |
코드예제알림톡 + LMS(MMS) 발송 Sample Code
INSERT INTO K_MESSAGE (
KKO_MSG,
PHONE_MSG,
TITLE,
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,
IMG_ATTACH_CD,
MMS_IMG1,
MMS_IMG2,
MMS_IMG3,
REG_DATE
) VALUES (
'[카카오뮤직] 회원가입 안내
고객명님, 카카오뮤직 회원이 되신 것을 환영합니다.
▶신규 가입 회원 혜택
1개월 무료 스트리밍 서비스 제공
카카오톡 이모티콘 증정',
‘LMS 부달 메시지입니다.’,
‘LMS 부달 제목입니다.’,
'KM', # 메시지 타입, 메시지 타입은 테이블 명세 참조
'99999999999', # 수신자 번호 변경 필요
'99999999999', # 발신자 번호 변경 필요
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,
‘N’, # IMG_ATTACH_CD : LMS에서는 해당 값을 ‘N’
NULL, # MMS_IMG1 : LMS에서는 해당 값을 null 처리
NULL, # MMS_IMG2 : LMS에서는 해당 값을 null 처리
NULL, # MMS_IMG3 : LMS에서는 해당 값을 null 처리
NOW ()
);
SMS/LMS 발송하기
고객에게 SMS/LMS만 단독으로 발송하는 방법입니다.
SMS/LMS/MMS 서비스를 단독으로 사용하는 경우에는 XMS(SMS/LMS/MMS) 발송 문서를 참고하시기 바랍니다.
SMS 발송하기
SMS를 발송하는 방법은 다음과 같습니다.
코드예제SMS 데이터 생성 Sample Code
INSERT INTO K_MESSAGE (
PHONE_MSG,
MSG_TYPE,
MOBILE_NO,
SENDER_NO,
SEND_TYPE,
RESERVE_DATE,
REG_DATE
) VALUES (
‘SMS 메시지입니다.’,
'XS', # 메시지 타입, 메시지 타입은 테이블 명세 참조
'99999999999', # 수신자 번호 변경 필요
'99999999999', # 발신자 번호 변경 필요
'S', # 발송 타입 : S - 실시간, M – 배치
NOW(), # 미래 시간 입력 시, 예약 발송
NOW()
);
LMS 발송하기
LMS를 발송하는 방법은 다음과 같습니다.
코드예제LMS 데이터 생성 Sample Code
INSERT INTO K_MESSAGE (
PHONE_MSG,
TITLE,
MSG_TYPE,
MOBILE_NO,
SENDER_NO,
SEND_TYPE,
RESERVE_DATE,
IMG_ATTACH_CD,
MMS_IMG1,
MMS_IMG2,
MMS_IMG3,
REG_DATE
) VALUES (
‘LMS 메시지입니다.’,
‘LMS 제목입니다.’,
'XM', # 메시지 타입, 메시지 타입은 테이블 명세 참조
'99999999999', # 수신자 번호 변경 필요
'99999999999', # 발신자 번호 변경 필요
'S', # 발송 타입 : S - 실시간, M – 배치
‘N’, # IMG_ATTACH_CD : LMS에서는 해당 값을 ‘N’
NULL, # MMS_IMG1 : LMS에서는 해당 값을 null 처리
NULL, # MMS_IMG2 : LMS에서는 해당 값을 null 처리
NULL, # MMS_IMG3 : LMS에서는 해당 값을 null 처리
NOW ()
);
알림톡 발송 코드
알림톡 발송 코드는 알림톡 발송 코드 문서를 참고하시기 바랍니다.