Message types
Each KakaoTalk service offers different message types. Different rules may apply to each message type.
Alim Talk
To send a message using Alim Talk, you must use templates that are approved by Kakao Corp. Refer to the Deliverability and compliace for more information.
An Alim Talk message can consist of one of the following options:
- Text only
- Text + title
- Text + image
- Text + linked-type buttons
- Text + title + linked-type buttons
- Text + image + linked-type buttons
Text
Text messages support a maximum of 1,000 characters, including spaces, regardless of language. Supported languages are Korean and English.
Image
You can include images in an Alim Talk template.
To send an image using Alim Talk, follow these guidelines.
- Do not include promotional content in the image.
- Upload the image to the Kakao server during template registration.
- After the template is approved, you cannot modify the image or use a different image for that template.
Images must follow the specifications shown in the table below:
Image | |
Recommended size | 800 px * 400 px |
Size limit | If the width is less than 500 px or if the aspect ratio is not 2:1, upload is not allowed |
File format | .jpg, .png |
File size (max) | 500 KB |
Linked-type button
You can include up to five buttons in each message. Each button can be of a different type. The following table provides information about the types of buttons that can be included in the text message.
Button name | Purpose | Description |
---|---|---|
WL | Web link | Launches a web page either in the KakaoTalk in-app browser or in an external browser if you add the relevant attribute |
AL | App link | Runs the KakaoTalk app custom scheme |
DS | Delivery tracking | Parses the name of the courier company and the invoice number from the message content, and launches the delivery inquiry page that the courier company provides |
MD | Message delivery | Sends a text message, which contains the text on the button and the message body, from the end user |
BK | Bot keyword | Sends a text message, which contains the text on the button, from the end user |
BT | Chatbot switch | Switches from the current chatbot to a different one |
Chingu Talk
Messages sent through Chingu Talk do not need to be approved by Kakao Corp.
A Chingu Talk message can consist of one of the following options:
- Text: Send simple text messages.
- Image: Share visual content.
- Commerce: Feature product information, including prices and descriptions, to promote goods and services.
- Carousel: Present a series of images or items that users can swipe through to showcase multiple products or offers.
- Carousel commerce: A specialized carousel format focused on commerce, allowing you to display products with pricing and purchasing options.
- Premium video: Share high-quality video content to create more engaging and dynamic interactions with users.
- Item list: Display a list of items to showcase product catalogs or multiple options.
Various rules apply to media assets, text character limitations, the number of buttons, button types, and coupons. To send a message with an image, first upload the image to the Kakao server and register it using the Alim Talk admin web interface. Alternatively, use the Infobip KakaoTalk Channel configuration under Media Library. Images must follow the defined specification. All these limitations are described in the below table.
Message types and specifications
Message type | Character limits* | Buttons | Media asset** | Requirements |
---|---|---|---|---|
Text | 1,000 characters | Up to 5 buttons are allowed. | - | - |
Image (narrow) | 400 characters | Up to 5 buttons are allowed. |
| - |
Image (wide) | 76 characters | Up to 2 buttons are allowed. |
| - |
Item list |
| Up to 5 buttons are allowed. |
|
|
| ||||
Commerce |
| At least 1 button (up to 2). |
| Additional content is optional. |
Carousel |
| Up to 2 buttons (one required per carousel). |
|
|
Carousel commerce |
|
| ||
Premium video |
| Up to 1 button is allowed. | Video links must be for videos uploaded to Kakao TV (opens in a new tab). | Both header and text are optional. |
* Including spaces, regardless of language. Supported languages are Korean and English.
** Supported file formats: .jpg, .png. Maximum file size: 5 MB.
Each message type supports adding a coupon.
Coupon
If you want to use a coupon within a text, narrow image, commerce, carousel, carousel commerce, or premium video message type, note that the coupon is limited to 12 characters. However, if you are sending a message with a wide image or a list item, then it is limited to 18 characters.
Coupons can be used in all message types. The title can have the following formats:
-
"
${number}
won discount coupon" - The number should range from 1 to 99,999,999. -
"
${number}
% discount coupon" - The number should range from 1 to 100. -
"Shipping discount coupon"
- "
${7 characters or less}
free coupon" - "
${7 characters or less}
UP coupon"
- "
-
For
url_pc
,url_mobile
,scheme_android
, andscheme_ios
, the required values depend on the case:
-
Default
url_mobile
is a required value.- All other URL-related fields are optional.
-
Using a channel coupon URL (format:
alimtalk=coupon://
):- Either
scheme_android
orscheme_ios
is required. - All other URL-related fields are optional.
- Either
Linked-type button
The number of buttons you can include in a message depends on the message type, ranging from one to five different buttons. Narrow image and item list messages support up to five buttons, while wide image, commerce, carousel, and carousel commerce messages allow up to two buttons. For premium video messages, only one button is allowed.
You can include up to five buttons in each message. Each button can be of a different type. The following table provides information about the types of buttons that can be included in the message.
Button name | Purpose | Description |
---|---|---|
WL | Web link | Launches a web page either in the KakaoTalk in-app browser or in an external browser if you add the relevant attribute |
AL | App link | Runs the KakaoTalk app custom scheme |
MD | Message delivery | Sends a text message, which contains the text on the button and the message body, from the end user |
BK | Boty keyword | Sends a text message, which contains the text on the button, from the end user |
Kakao Chingu in our Broadcast solution only supports Web link and App link button types.
Sangdam Talk
Outbound messages
Text
Text messages are limited to 1,000 characters, including spaces, regardless of language. Supported languages are Korean and English.
Image
To send either an image or an image for linked-type buttons, first upload the image to the Kakao server.
Images must follow the specifications shown in the table below.
Image | Image for linked-type button | |
---|---|---|
Recommended size | 720 px * 720 px | |
Size limit | If the width is less than 500 px, or if the aspect ratio is either less than 2:1 or exceeds 3:4, upload is not allowed | |
File format | .jpg, .png, .gif | .jpg, .png |
File size (max) | 5 MB | 0.5 MB |
Linked-type button
You can include up to five buttons in each message. Each button can be of a different type. The following table provides information about the types of buttons that can be included in the text message.
Button name | Purpose | Description |
---|---|---|
WL | Web link | Launches a web page either in the KakaoTalk in-app browser or in an external browser if you add the relevant attribute |
AL | App link | Runs the KakaoTalk app custom scheme |
MD | Message delivery | Sends a text message, which contains the text on the button and the message body, from the end user |
BK | Bot keyword | Sends a text message, which contains the text on the button, from the end user |
Inbound messages
An inbound Sangdam Talk message can consist of the following:
- Text
- Image
- Video
- Audio
Media must follow the specifications shown in the table below.
Image | Video | Audio | |
---|---|---|---|
File format | .jpg, .jpeg, .gif, .bmp, .png, .tiff | .mp4, .m4v, .avi, .asf, .wmv, .mkv, .ts, .mpg, .mpeg, .mov, .flv, .ogv | .mp3, .wav, .flac, .tta, .tak, .aac, .wma, .ogg, .m4a |
File size (max) | Mobile: 15 MB PC: 300 MB | 300 MB | PC: 300 MB |
Duration (max) | 5 minutes when recording using KakaoTalk | Mobile: 5 minutes |