This document introduces the features of the Talk Calendar APIs.
The Talk Calendar API lets your service leverage the features of Talk Calendar in your service, such as adding and managing events or calendars in a user's Talk Calendar. The Talk Calendar API also enables users to subscribe to your service's calendar. If your service owns a Kakao Talk Channel, you can publish or manage a public event so that users can follow your service's events.
On the web or app version of Talk Calendar, a user can see the user's calendar divided into three categories.
Each calendar has the following features:
Calendar type | Description | How to create a calendar |
---|---|---|
My Calendar (🅐 > ⓐ) |
Primary calendar that is automatically created when a user starts to use the Talk Calendar service. | My calendar is automatically created for each user. NOTE: This calendar cannot be deleted because it is set as a default calendar. |
Sub-calendar (🅐 > ⓑ) |
Additional calendars that a user or a service has created. | A service can create a calendar through the Creating sub-calendar API. Users also can create a calendar in the Talk Calendar service. |
Subscribed Calendar (🅒) | Calendar that Kakao Talk Channel publishes or manages to let users subscribe to the calendar based on interests. | A service can request to create a subscribed calendar at DevTalk. |
Here are the types of events that can be handled with the Talk Calendar APIs.
Event type | Description | How to add | How to edit |
---|---|---|---|
Personal event | Events that a user has added to the user's My Calendar or sub-calendars | Users can create an event through the Creating event API. NOTE: The created event is added to a user's My Calendar or sub-calendars. |
For event hosts, use the Editing event for host API. For event attendees, use the Editing event for attendee API. |
Public event | Events that are published by a service's Kakao Talk Channel for marketing purpose | Your service can publish a public event through the Creating public event API. Users can add a public event published by your service to their own calendar by calling the Following public event API. NOTE: The public event is added to a user's My Calendar or sub-calendar. |
Use the Editing event for attendee API. |
Subscribed event | Events that are published by Kakao Talk Channel (Example: Kakao TV, Sports channel) |
If a user subscribes to a subscribed calendar, all the events of the service are added to its subscribed calendar. If a user chooses to unsubscribe, all subscribed events are deleted. NOTE: The subscribed event is added to a user's Subscribed calendar. |
Use the Editing event for attendee API. |
If your service uses a public event or subscribed calendar, you can encourage users to add the event or calendar to their calendar by sending a Kakao Talk message through the Messaging API. For this, you need to configure a message with a follow or subscribe button by using the calendar template.
To implement this functionality, see the following documentation:
Purpose | Guide |
---|---|
To configure a calendar type of message | Message Template |
To send a calendar message through Kakao Talk Sharing | JavaScript SDK Android SDK iOS SDK Flutter SDK |
To send a calendar message through Kakao Talk Messaging IMPORTANT: To send a calendar message to all users who are linked to your app, complete Kakao Talk Social > prerequisites and Message > Request permission. |
REST API JavaScript SDK Android SDK iOS SDK Flutter SDK |
Before permission is granted to your app,
To apply the implemented Talk Calendar functionality to your actual service or to use more advanced features, your app must obtain permission. To request permission, go to DevTalk, select ➊'톡캘린더 API(Talk Calendar API)' > '톡캘린더 API 사용 신청(Request permission to use Talk Calendar API)' category > ➋[새글 쓰기(New Topic)].
The Kakao platform administrator decides whether to give permission to use the Talk Calendar API after reviewing the request form and lets you know the result.
After permission is granted to your app,
To see the list of APIs that you can use after permission is granted, refer to Scope of support.
Before permission is granted, you cannot create or manage a public event or subscribed calendar. To fully use the features of Talk Calendar API, your app must obtain permission.
Kakao puts limits and quotas on API requests. By default, you can use the API on a limited quota for testing. If you obtain permission by requesting permission, you can call the API as much as the specified quota per month. To see more about the limits and quotas, refer to Platform Operating Policy. If the quota of API requests from an app is exceeded, an error occurs, and you cannot use the API anymore.
Permission: Indicates the APIs with this tag attached require permission to use the APIs.
API | Description |
---|---|
Retrieving list of calendars | Retrieves user's all calendars, except for a Shared calendar. |
Creating sub-calendar | Creates a sub-calendar on user's Talk Calendar. |
Editing sub-calendar | Edits a particular sub-calendar. |
Deleting sub-calendar | Deletes a particular sub-calendar. |
Creating event | Adds an event to a user's calendar. Users can see the created events under the Talk Calendar category in Talk Calendar. |
Retrieving list of events | Retrieves the events added on a user's calendar. |
Retrieving details of event | Retrieves the details of a user's personal event. |
Editing event for host | Edits a particular personal event that a user has created. |
Deleting event | Deletes a user's personal event or public event. |
Creating public event Permission | Creates a public event. |
Retrieving list of public events Permission | Retrieves all public events that your service has created. |
Retrieving details of public event Permission | Retrieves the details of a particular public event that your service has created. |
Editing public event Permission | Edits a particular public event. |
Deleting public event Permission | Deletes a particular public event. |
Adding public event to user calendar | Adds a public event published by your service to user's calendar. |
Retrieving list of subscribable calendars Permission | Retrieves the list of the available calendars that a user can subscribe to. |
Subscribing Permission | Subscribes to a service's subscribed calendar. |
Unsubscribing Permission | Unsubscribes from a service's subscribed calendar. |
Editing event for attendee | Edits a particular public event or subscribed event added to a user's calendar. |
Retrieving holidays and celebrations | Retrieves holidays and celebrations in the Republic of Korea. |
You can use the Talk Calendar API only with a REST API.