Concepts

This document introduces the Messaging API.

Message sending features

This section introduces various Kakao Talk message sending features provided by Kakao. The differences between products can be found in the table below.

Product	Description	Service → User message sending	Available platform
Kakao Talk Share	Users select content in the service and share it to Kakao Talk chatrooms themselves. Recommended use: Implementing content sharing features between users.	Not supported.	Kakao Developers
Kakao Talk Message	Users send messages to their Kakao Talk friends who use the same service, for interaction purposes. Recommended use: Implementing message sending for user interactions.	Not supported.	Kakao Developers
Ad Talk	The service sends promotional or informational messages to users who have added the service's Kakao Talk Channel. Recommended use: Sending promotional or informational messages to users.	Conditionally supported. (Only for users who added the channel)	Kakao Business
Info Talk	The service sends informational messages to users. Recommended use: Sending informational messages to users.	Supported.	Kakao Business
CS Talk	Users can open a Kakao Talk chatroom to make inquiries about the service. Recommended use: Implementing customer support using real-time chat or chatbot.	Conditionally supported. (After a user initiates a consultation)	Kakao Business

Select the product that fits your service needs based on the guide below.

• If your service requires sending messages between users, choose the appropriate product between Kakao Talk Share and Kakao Talk Message.
• If your service needs to send messages directly to users, choose the appropriate product between Ad Talk and Info Talk.
• If your service requires a customer support feature, select the CS Talk product.

For details on Ad Talk, Info Talk, and CS Talk, see the Kakao Business document.

Differences between Kakao Talk Share and Kakao Talk Message features

This section explains the differences between Kakao Talk Share and Kakao Talk Message, both of which are Kakao Talk Message sending features provided by Kakao Developers. Both features only support user-to-user messaging, and services cannot send messages directly to users.

Refer to the table below to check the feature differences and choose the product that best suits your service requirements.

Item	Kakao Talk Share	Kakao Talk Message
Message recipients	All Kakao Talk friends of the user	Friends who meet the information provision conditions of the Retrieve friends list API.
Recipient selection UI	No separate implementation required.	Requires calling the Friend picker API or implementing a UI using the Retrieve friends list API.
Message sending method	When the user selects recipients in the Kakao Talk app, the sharing message is automatically sent.	After providing a recipient selection UI, the Kakao Talk Message API must be called with the selected recipients.
Permission required	X	O
REST API supported	X	O
Confirmation of message delivery success	Confirm via the Kakao Talk Share webhook.	Confirm via API response.

Kakao Talk Share

Kakao Talk Share is a feature that allows users to manually select content from a service and share it to a Kakao Talk chatroom. The content sharing feature using Kakao Talk Share can be utilized as a means for event promotion or user acquisition.

For the types and characteristics of various message sending features provided by Kakao, see Message sending features. For the differences between the message sending features provided by Kakao Developers, see Differences between Kakao Talk Share and Kakao Talk Message features.

Kakao Talk Share process

This section explains the process of sending a Kakao Talk Share message from a service. Refer to the sequence diagram and the step-by-step explanation below.

1. When the user selects the Kakao Talk Share button on the service screen, the service calls the Kakao Talk Share API with the message composed using a message template as a parameter.
2. Kakao Talk launches on the user's device, and the Kakao Talk friend (or chatroom) list is displayed.
3. When the user selects the desired recipient from the Kakao Talk friend (or chatroom) list, the Kakao Talk Share message is sent.

Kakao Talk Message

Kakao Talk Message is a feature that allows users to send messages to their Kakao Talk friends who use the same service for the purpose of interaction. This feature provides an environment where users can interact by sending messages to each other, or enables personalized services by allowing users to send messages to themselves.

For the types and characteristics of various message sending features provided by Kakao, see Message sending features. For the differences between the message sending features provided by Kakao Developers, see Differences between Kakao Talk Share and Kakao Talk Message features.

Kakao Talk Message process

This section explains how a user sends a Kakao Talk Message from a service. Refer to the sequence diagram and step-by-step explanation below.

1. When a user selects the Kakao Talk Message send button on the service screen, the service provides a UI to select recipients through one of the following methods.
   • Call the Friends picker API.
   • Provide a UI for selecting recipients from the response of the Retrieve user list API.
2. When the user selects the desired recipients using the Friend picker or service UI, the service receives the recipient information as a response.
3. The service sends a Kakao Talk message by calling the Kakao Talk Message API with the recipient information and message parameters composed with a message template.

Usage Policy

Request permission

APIs that send messages to the Kakao Talk friends can only be used by apps that have been granted permissions. For apps without permissions or Test apps, only the app's team members can call APIs, and the response range is restricted to those team members. To enable these features for all users in a live service, apply for the required permissions under [My Application] > [Request for App Permissions].

Complete the following steps before the request.

1. Set the [Send message in Kakao Talk(friends)] scope. Refer to Manage consent items(talk_message).
2. Implement the feature using APIs that send messages to the Kakao Talk friends.
3. Test the feature works properly for the team members.

After getting permission, APIs that send messages to the Kakao Talk friends will be available for all service users.

Quota

Kakao API applies monthly and daily quotas for stable service. You can check the currently applied quota information in the Quota.

Kakao Talk Share

To increase the applied quota limit for Kakao Talk Share API, refer to Request for app permissions to request the permission. For other consultation and partnership, contact us separately.

Kakao Talk Message

The Kakao Talk Message API has a limited quota before you get the permission via Request permission, and the quota limit cannot be increased to protect users from frequent messages.

Preference to receive messages

Ensure that a Kakao Talk message sent through the Kakao Talk Message API can be delivered only to the users who allow showing their profile on the Friends list of a service.

Users can change the profile visibility option by selecting [Preferences] at the bottom right of the message sent from the user's friends or on [Manage connected services] page. To see more details, refer to Profile visibility settings.

If a user wants to block messages from a service, the user needs to disable the 'Show my profile on Friends list' option. Then, the user is not included in the response of the Retrieving list of friends API, and the user's friends cannot send any messages from the service because the user is not displayed on the Friends list.

Firewall and ACL

If access to the service server is restricted Kakao's server by the firewall or ACL (Access Control List), Kakao Talk Share message may not display the image or works slowly.

In this case, you must set the firewall rules or ACL to scrape your web page for Kakao Talk Share. Refer to Retrieve Kakao IP list.

Features

• Refer to Scope of support to know whether each Kakao SDK supports each feature.

Kakao Talk Share

Feature	Description	Documentation
Send message with default template	Configures a message in JSON format according to the default template type to use and shares it through Kakao Talk.	JavaScript Android iOS Flutter
Send message with custom template	Customizes a template in [Tools] > [Message Template Builder] and shares it through Kakao Talk.	JavaScript Android iOS Flutter
Send scrape message with default template	Scraps a web page, configures a message based on the scraped web page information, and then shares it through Kakao Talk.	JavaScript Android iOS Flutter
Send scrape message with custom template	Scraps a web page, configures a message based on the scraped web page information, and then shares it through Kakao Talk.	JavaScript Android iOS Flutter
Upload image	Uploads, scrapes or deletes an image for messages.	JavaScript Android iOS Flutter
Kakao Talk Share webhook	Sends a webhook request to the webhook URL of your server specified in the Kakao Developers when a Kakao Talk Share message is successfully sent to the selected users or chatrooms.	Webhook

Kakao Talk Message

Feature	Description	Documentation
Send message with default template	Sends a message with a default template in JSON format.	REST API JavaScript Android iOS Flutter
Send message with custom template	Sends a message with a custom template that configured in [Tools] > [Message Template Builder].	REST API JavaScript Android iOS Flutter
Send scrape message with default template	Scrape a specific web page and sends a message with a default template in JSON format.	REST API JavaScript Android iOS Flutter
Send scrape message with custom template	Scrape a specific web page and sends a message with a custom template that configured in [Tools] > [Message Template Builder].	REST API JavaScript Android iOS Flutter