Sending Alim Talk

Alim Talk is a service that enables corporate clients to send informative KakaoTalk messages to users, including those who have not connected as friends on KakaoTalk channels.

The messages that can be sent through Alimtalk are limited to certain informative messages that are deemed appropriate for the service from a user protection standpoint among the exceptions to advertising information according to the Korea Internet & Security Agency (KISA) guidelines related to the Information and Communication Network Act. This includes informational content such as order/reservation confirmation, payment details, and delivery status that are sent immediately according to the customer’s actions. Informational messages do not include newsletters for subscribers, congratulations on membership, announcements, and so on.

Sending spam messages through Alim Talk can result in the suspension of both Alim Talk and KakaoTalk channels, as well as fines. For more information on informational messages, please visit the KISA Illegal Spam Response Center. For a detailed explanation, please refer to the KISA Information and Communications Network Act Guidelines for Prevention of Illegal Spam (5th Revised Edition).

Note

Before calling every BizMessage API, you must call OAuth 2.0 API in advance.

For detailed information on button guides and specifications by message type, please refer to the Appendix. Layout Guide and Message Specs.

In order to send AlimTalk, you need to first register a template on the Kakao Biz Message site and have it inspected for approval.

Sending Alim Talk

To send an AlimTalk, you need to enter data in the AlimTalk table. The main columns of the INSERT statement are as follows.

표Main Column of INSERT Statement

Column	Description
MSG_TYPE	Alim Talk (No alternative message to be sent upon failure)
MSG_TYPE	Fixed to `KX`
SEND_TYPE	Message type
	`S`: To send a single message in real time
	`M`: To send bulk messages in batches
IMG_ATTACH_CD	Whether to attach an image
	`N`: No image to attach
	`Y`: To attach an image when SEND_TYPE is `S`
	`M`: To attach an image when SEND_TYPE is `M`
KKO_TEMPLATE_TYPE	AlimTalk template type - If `NULL` is entered, and the server recognizes it as `AT`.
	`AT`: General text-type template
	`AI`: Image-type template

코드예제Sample Code of Sending Alim Talk(MySQL)

MySQL

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 (
'[Kakao Music] Welcome
Hello, Welcome to Kakao Music.

▶ Membership Subscription Benefits
1 Month Free Streaming
Free Kakao Talk emoticons',
'KX',                         # Sending Alim Talk only (No alternative message to be sent upon failure)
'99999999999',  	            # Recipient’s number needs to be changed.
'99999999999',                # Sender’s number needs to be changed.
NOW(),                        # Sending time(If future time is input, the message will be sent later.)
'alimtalktest_001',           # Template code
‘AT’,                         # Basic Template(Basic type and Text Emphasized type) - AT, Image template - AI
‘{"name":"App Link Button","type":"AL","scheme_android":"https://kakao.com","scheme_ios":"https://kakao.com","url_mobile":"https://kakao.com"}’,
‘{"name":"Web Link Button","type":"WL","url_mobile":"http://kakao.com"}’,
NULL,
NULL,
NULL,
‘{"name":"Direct Link 1","type":"WL","url_mobile":"http://kakao.com"}’,
‘{"name":"Direct Link 2","type":"WL","url_mobile":"http://kakao.com"}’,
NULL,
NULL,
NULL,
NULL,
NULL,
NULL,
NULL,
NULL,
NOW ()
);

NOTE
For details of each column, refer to Table Specification.

Warning
You can send Alim Talk only after registering a template in advance. Kakao does not allow sending Alim Talk messages with unapproved templates.

If there are contents, buttons and Direct Link information that do not match the approved template, Alim Talk will not be sent.

In case of sending an AlimTalk, the value of KKO_TEMPLATE_TYPE must be entered exactly according to the template type.

Set (KKO_TEMPLATE_TYPE) to AI if the Emphasis Type is the Image Type. As for the other types, set to AT.

Sending Alim Talk + SMS(Alternative Message)

If an AlimTalk fails to be sent, you can create data to send an SMS as an alternative message as follows.

표Main Column of INSERT Statement

Column	Description
MSG_TYPE	Sending Alim Talk and SMS as an alternative message
MSG_TYPE	Fixed to `KS`
SEND_TYPE	Message type
	`S`: To send a single message in real time
	`M`: To send bulk messages in batches
IMG_ATTACH_CD	Whether to attach an image
	`N`: No image to attach
	`Y`: To attach an image when SEND_TYPE is `S`.
	`M`: To attach an image when SEND_TYPE is `M`.
KKO_TEMPLATE_TYPE	AlimTalk template type
	`AT`: General text-type template
	`AI`: Image-type template

코드예제Sample Code of Sending Alim Talk + SMS(Alternative Message)(MySQL)

MySQL

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 (
'[Kakao Music] Thanks to Join
Dear, welcome to Kakao Music.

▶ Membership Subscription Benefits
1 Month Free Streaming
Free Kakao Talk emoticons',
‘This is an SMS message(alternative message).’,
'KS',                         # Message type. See the table specification for Message type.
'99999999999',  	            # Recipient’s number needs to be changed.
'99999999999',                # Sender’s number needs to be changed.
NOW(),                        # If future time is input, the message will be sent later.
'alimtalktest_001',           # Template code
‘AT’,                         # Basic Template(Basic type and Highlighted Type) - AT, Image Template - AI
‘{"name":"App Link Button","type":"AL","scheme_android":"https://kakao.com","scheme_ios":"https://kakao.com","url_mobile":"https://kakao.com"}’,
‘{"name":"Web Link Button","type":"WL","url_mobile":"http://kakao.com"}’,
NULL,
NULL,
NULL,
‘{"name":"Direct Link 1","type":"WL","url_mobile":"http://kakao.com"}’,
‘{"name":"Direct Link 2","type":"WL","url_mobile":"http://kakao.com"}’,
NULL,
NULL,
NULL,
NULL,
NULL,
NULL,
NULL,
NULL,
NOW ()
);

Sending Alim Talk + LMS(MMS)(Alternative Message)

The following is how to create data to send a LMS message as an alternative one upon the failure of sending an Alim Talk.

NOTE
LMS is sent when IMG_ATTACH_CD is N and MMS_IMG1-3 values are NULL.

표Main Column of INSERT Statement

cloumn	Description
MSG_TYPE	Sending Alim Talk and LMS(Alternative Message)
MSG_TYPE	Fixed to `KM`
SEND_TYPE	Message type
	`S`: To send a single message in real time
	`M`: To send bulk messages in batches
IMG_ATTACH_CD	Whether to attach an image
	`N`: No image to attach
	`Y`: To attach an image when SEND_TYPE is `S`.
	`M`: To attach an image when SEND_TYPE is `M`.
KKO_TEMPLATE_TYPE	AlimTalk template type
	`AT`: General text-type template
	`AI`: Image-type template

코드예제Sample Code of Sending Alim Talk + LMS(MMS)(Alternative Message)(MySQL)

MySQL

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 (
'[Kakao Music] Thanks to Join
Dear, welcome to Kakao Music.

▶ Membership Subscription Benefits
1 Month Free Streaming
Free Kakao Talk emoticons',
‘This is an LMS alternative message.’,
‘This is the title of LMS alternative message.’,
'KM',                         # Message type. See the table specification for Message type.
'99999999999',  	            # Recipient’s number needs to be changed.
'99999999999',                # Sender’s number needs to be changed.
NOW(),                        # If future time is input, the message will be sent later.
'alimtalktest_001',           # Template code
‘AT’,                         # Basic Template(Basic type and Highlighted Type) - AT, Image Template - AI
‘{"name":"App Link Button","type":"AL","scheme_android":"https://kakao.com","scheme_ios":"https://kakao.com","url_mobile":"https://kakao.com"}’,
‘{"name":"Web Link Button","type":"WL","url_mobile":"http://kakao.com"}’,
NULL,
NULL,
NULL,
‘{"name":"Direct Link 1","type":"WL","url_mobile":"http://kakao.com"}’,
‘{"name":"Direct Link 2","type":"WL","url_mobile":"http://kakao.com"}’,
NULL,
NULL,
NULL,
NULL,
NULL,
NULL,
NULL,
NULL,
‘N’,                             # IMG_ATTACH_CD :  To be ‘N’ in LMS
NULL,                            # MMS_IMG1 : To be null in LMS
NULL,                            # MMS_IMG2 : To be null in LMS
NULL,                            # MMS_IMG3 : To be null in LMS
NOW ()
);

Sending SMS/LMS

This is how to send only SMS/LMS to customers. If you use SMS/LMS/MMS service alone, please refer to the XMS document.

Sending SMS

The following is how to create data to send an SMS message.

코드예제Sample Code of Creating SMS data(MySQL)

MySQL

INSERT INTO K_MESSAGE (
PHONE_MSG,
MSG_TYPE,
MOBILE_NO,
SENDER_NO,
SEND_TYPE,
RESERVE_DATE,
REG_DATE
) VALUES (
‘This is an SMS.’,
'XS',                # Message type. See the table specification for Message type.
'99999999999',  	   # Recipient’s number needs to be changed.
'99999999999',       # Sender’s number needs to be changed.
'S',                 # Sending Type  : S - Real time,   M –  Batch
NOW(),               # If future time is input, the message will be sent later.
NOW()
);

Sending LMS

The following is how to create data to send an LMS message.

코드예제Sample Code of Creating LMS data(MySQL)

MySQL

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 (
‘This is a LMS message.’,
‘This is a title of LMS.’,
'XM',                             # Message type. See the table specification for Message type.
'99999999999',  	                # Recipient’s number needs to be changed.
'99999999999',                    # Sender’s number needs to be changed.
'S',                              # Sending Type  : S - Real time,   M –  Batch
‘N’,                              # IMG_ATTACH_CD : ‘N’ in case of LMS
NULL,                             # MMS_IMG1 : Null in case of LMS
NULL,                             # MMS_IMG2 : Null in case of LMS
NULL,                             # MMS_IMG3 : Null in case of LMS
NOW ()
);

Alim Talk sending code

For the messaging result code for AlimTalk, please refer to the Messaging Code of Alim Talk document.

kakaoIdocumentation

Kakao i Connect Message::BizMessage(ENG)::BizMessage Agent::Sending Alim Talk

페이지 이동경로

Sending Alim Talk

Sending Alim Talk

Sending Alim Talk + SMS(Alternative Message)

Sending Alim Talk + LMS(MMS)(Alternative Message)

Sending SMS/LMS

Sending SMS

Sending LMS

Alim Talk sending code