bizgo Developers
API ReferenceCommunication APIKakao Biz Message

CS Talk

CS Talk is the Kakao Biz Message channel that lets you exchange 1:1 support messages with customers over a KakaoTalk channel and manage support sessions and operational settings alongside them.

Run a support conversation

Send a Plain message

POST/api/comm/v1/cstalk/plain
Try it in the Sandbox

Sends a CS Talk plain message. Depending on msgType, you can send TEXT, IMAGE, VIDEO, AUDIO, and FILE.

Body Parameters

{}JSON

userKey

RequiredString

The user key.

senderKey

RequiredString

The sender profile key.

msgType

RequiredString

The message type.

message

RequiredString

The message to deliver to the user. Up to 1,000 characters.

attachment

Object

The attachment message object. Used with the IMAGE, VIDEO, AUDIO, and FILE types.

ref

String

A reference field. Up to 200 characters; it is returned in the send-request result webhook.

Returns

common

Object

The common response section.

data

Object

The product response section.

Request example

1curl -X POST "https://mars.ibapi.kr/api/comm/v1/cstalk/plain" \
2 -H "Authorization: {ApiKey}" \
3 -H "Content-Type: application/json" \
4 -d '{
5 "userKey":"{userKey}",
6 "senderKey":"{senderKey}",
7 "msgType":"TEXT",
8 "message":"์ƒ๋‹ด ์•ˆ๋‚ด ๋ฉ”์‹œ์ง€์ž…๋‹ˆ๋‹ค.",
9 "ref":"client-ref-001"
10}'

Response example

1{
2 "common": {
3 "authCode":"A000",
4 "authResult":"Success",
5 "infobankTrId":"Infobank-Tracking-Id"
6 },
7 "data": {
8 "code":"A000",
9 "result":"Success",
10 "msgKey":"20260424104234546POM101182450000",
11 "ref":"client-ref-001"
12 }
13}

Send a Rich message

POST/api/comm/v1/cstalk/rich
Try it in the Sandbox

Sends a CS Talk rich message. It supports the TEXT, IMAGE, WIDE, ITEM_LIST, WIDE_ITEM_LIST, CAROUSEL_FEED, and PERSONAL types.

Body Parameters

{}JSON

userKey

RequiredString

The user key.

senderKey

RequiredString

The sender profile key.

msgType

RequiredString

The message bubble type.

message

String

The message to deliver to the user.

description

String

An additional message to deliver to the user.

header

String

The header.

attachment

Object

The message attachment information.

carousel

Object

The carousel information. Required for the CAROUSEL_FEED type.

autoAnswer

String

The automatic system response message.

lock

Boolean

Whether it is a secure message.

ref

String

A reference field. Up to 200 characters; it is returned in the send-request result webhook.

Returns

common

Object

The common response section.

data

Object

The product response section.

Request example

1curl -X POST "https://mars.ibapi.kr/api/comm/v1/cstalk/rich" \
2 -H "Authorization: {ApiKey}" \
3 -H "Content-Type: application/json" \
4 -d '{
5 "userKey":"{userKey}",
6 "senderKey":"{senderKey}",
7 "msgType":"TEXT",
8 "message":"์ƒ๋‹ด ์•ˆ๋‚ด ๋ฉ”์‹œ์ง€์ž…๋‹ˆ๋‹ค.",
9 "attachment": {
10 "buttons": [{
11 "type":"WL",
12 "name":"๋ฐ”๋กœ๊ฐ€๊ธฐ",
13 "urlMobile":"https://m.example.com",
14 "urlPc":"https://www.example.com"
15 }]
16 },
17 "ref":"client-ref-001"
18}'

Response example

1{
2 "common": {
3 "authCode":"A000",
4 "authResult":"Success",
5 "infobankTrId":"Infobank-Tracking-Id"
6 },
7 "data": {
8 "code":"A000",
9 "result":"Success",
10 "msgKey":"20260424104234546POM101182450000",
11 "ref":"client-ref-001"
12 }
13}

End a support conversation

POST/api/comm/v1/cstalk/end
Try it in the Sandbox

Ends the currently open support session.

Body Parameters

{}JSON

userKey

RequiredString

The user key.

senderKey

RequiredString

The sender profile key.

Returns

common

Object

The common response section.

data

Object

The product response section.

Request example

1curl -X POST "https://mars.ibapi.kr/api/comm/v1/cstalk/end" \
2 -H "Authorization: {ApiKey}" \
3 -H "Content-Type: application/json" \
4 -d '{
5 "userKey":"{userKey}",
6 "senderKey":"{senderKey}"
7}'

Response example

1{
2 "common": {
3 "authCode":"A000",
4 "authResult":"Success",
5 "infobankTrId":"header-value-X-Infobank-Tracking-Id"
6 },
7 "data": {
8 "code":"A000",
9 "result":"Success",
10 "data": {
11 "msgKey":"20260424104234546POM101182450000"
12 },
13 "ref":"client-ref-001"
14 }
15}

End a support conversation and hand over to the bot

POST/api/comm/v1/cstalk/endWithBot
Try it in the Sandbox

Ends the support session and then runs the bot event block.

Body Parameters

{}JSON

userKey

RequiredString

The user key.

senderKey

RequiredString

The sender profile key.

botEvent

String

The name of the bot event to run.

Returns

common

Object

The common response section.

data

Object

The product response section.

Request example

1curl -X POST "https://mars.ibapi.kr/api/comm/v1/cstalk/endWithBot" \
2 -H "Authorization: {ApiKey}" \
3 -H "Content-Type: application/json" \
4 -d '{
5 "userKey":"{userKey}",
6 "senderKey":"{senderKey}",
7 "botEvent":"์ƒ๋‹ด์ข…๋ฃŒ"
8}'

Response example

1{
2 "common": {
3 "authCode":"A000",
4 "authResult":"Success",
5 "infobankTrId":"header-value-X-Infobank-Tracking-Id"
6 },
7 "data": {
8 "code":"A000",
9 "result":"Success",
10 "data": {
11 "msgKey":"20260424104234546POM101182450000"
12 },
13 "ref":"client-ref-001"
14 }
15}

Block a user from receiving messages

POST/api/comm/v1/center/cstalk/profile/user/block
Try it in the Sandbox

Blocks a specific user from receiving CS Talk messages.

Body Parameters

{}JSON

cstalk

RequiredObject

The CS Talk request object.

Returns

common

Object

The common response section.

data

Object

The product response section.

Request example

1curl -X POST "https://mars.ibapi.kr/api/comm/v1/center/cstalk/profile/user/block" \
2 -H "Authorization: {ApiKey}" \
3 -H "Content-Type: application/json" \
4 -d '{
5 "cstalk": {
6 "senderKey":"{senderKey}",
7 "userKey":"{userKey}"
8 }
9}'

Response example

1{
2 "common": {
3 "authCode":"A000",
4 "authResult":"Success",
5 "infobankTrId":"Infobank-Tracking-Id"
6 },
7 "data": {
8 "code":"A000",
9 "result":"Success"
10 }
11}

Unblock a user from receiving messages

POST/api/comm/v1/center/cstalk/profile/user/unblock
Try it in the Sandbox

Unblocks a blocked user from receiving CS Talk messages.

Body Parameters

{}JSON

cstalk

RequiredObject

The CS Talk request object.

Returns

common

Object

The common response section.

data

Object

The product response section.

Request example

1curl -X POST "https://mars.ibapi.kr/api/comm/v1/center/cstalk/profile/user/unblock" \
2 -H "Authorization: {ApiKey}" \
3 -H "Content-Type: application/json" \
4 -d '{
5 "cstalk": {
6 "senderKey":"{senderKey}",
7 "userKey":"{userKey}"
8 }
9}'

Response example

1{
2 "common": {
3 "authCode":"A000",
4 "authResult":"Success",
5 "infobankTrId":"Infobank-Tracking-Id"
6 },
7 "data": {
8 "code":"A000",
9 "result":"Success"
10 }
11}

Look up a session

GET/api/comm/v1/center/cstalk/session
Try it in the Sandbox

Looks up the current support session by user key.

Query Parameters

QUERY

userKey

RequiredString

The user key.

Returns

common

Object

The common response section.

data

Object

The product response section.

Request example

1curl -X GET "https://mars.ibapi.kr/api/comm/v1/center/cstalk/session?userKey=userKeySample?userKey={userKey}" \
2 -H "Authorization: {ApiKey}"

Response example

1{
2 "common": {
3 "authCode":"A000",
4 "authResult":"Success",
5 "infobankTrId":"header-value-X-Infobank-Tracking-Id"
6 },
7 "data": {
8 "code":"A000",
9 "result":"Success",
10 "data": {
11 "session": {
12 "sessionId": 1,
13 "senderKey":"{senderKey}",
14 "startedType":"UM",
15 "startedAt":"2025-09-24T11:22:08.557",
16 "expiredType":"AE",
17 "expiredAt":"2025-10-25T10:00:00"
18 }
19 }
20 }
21}

Receive support messages (webhook)

Webhook receipt policy

  • A webhook is the method by which the Bizgo API delivers changes or inbound data to a URL you registered.
  • CS Talk, message report, and MO webhooks are all processed normally only when they receive HTTP 200 and a response that matches the specification.
  • If there is no response or the response does not match the specification, it is treated as a failure, and a failure is retried up to 3 times.
  • If every retry fails, that webhook delivery is treated as failed and is not delivered again.
  • The connect timeout and the read timeout are each processed on a 5-second basis.
  • For webhook service IPs and security requirements, see Firewall and security protocol.

Support sessions and the user key

  • A support session is a prerequisite for an agent to send messages to a customer; an agent can only send messages while a session exists.
  • A session is kept for 30 days after the last message received from the KakaoTalk user, and is extended every time a customer message arrives.
  • The session end time is set to 30 days from the next exact hour after the time the last message was received.
  • A session ends when the agent ends the support conversation or blocks the user, when the user enters !์ข…๋ฃŒ ("end"), leaves the chatroom, or blocks the channel, or when 30 days have passed since the last message was received.
  • userKey is the key that identifies a specific KakaoTalk user, and it is delivered together with the CS Talk message on receipt.
  • userKey is valid per KakaoTalk channel, so the same user gets a different user key on a different channel.
  • userKey is case-sensitive, and it changes to a different key if the user leaves KakaoTalk and signs up again.

Receive a user message

POST{your webhook URL}/cstalk/message

The webhook that receives user messages. It delivers the message data the user sent to the customer webhook URL you registered.

Body Parameters

{}JSON

msgKey

RequiredString

The message key.

userKey

RequiredString

The CS Talk user key.

senderKey

RequiredString

The key of the sender profile that received the message.

serviceType

RequiredString

The service type.

msgType

RequiredString

The message type.

requestType

String

The request type.

sendTime

RequiredString

The send time. Delivered in ISO 8601 format.

reportTime

RequiredString

The report time. Delivered in ISO 8601 format.

kakaoTime

String

The time the CS Talk server delivered the message. It is not the time the user actually typed it.

contents

Object Array

The array of message data the user sent. The content field is no longer provided after January 2026, so use contents.

attachment

Object

The area that additionally delivers the full message as a txt file URL when the user's message exceeds 4,000 characters.

Returns

code

String

The webhook processing result code.

result

String

The webhook processing result message.

Request example

1curl -X POST "{๊ณ ๊ฐ Webhook URL}/cstalk/message" \
2 -H "Accept: application/json" \
3 -H "Content-Type: application/json" \
4 -d '{
5 "msgKey":"20260424104234546POM101182450000",
6 "userKey":"{userKey}",
7 "senderKey":"{senderKey}",
8 "serviceType":"CSTALK",
9 "msgType":"TEXT",
10 "requestType":"message",
11 "sendTime":"2026-04-24T10:42:34.546+09:00",
12 "reportTime":"2026-04-24T10:42:35.120+09:00",
13 "kakaoTime":"2026-04-24T10:42:35.000+09:00",
14 "contents": [{
15 "comment":"์ƒ๋‹ด ๋ฌธ์˜ ๋‚ด์šฉ์ž…๋‹ˆ๋‹ค."
16 }]
17}'

Response example

1{
2 "code":"A000",
3 "result":"Success"
4}

Receive user meta information

POST{your webhook URL}/cstalk/reference

Delivers the metadata from when the user requested a support connection to the customer webhook URL you registered.

Body Parameters

{}JSON

msgKey

RequiredString

The message key.

userKey

RequiredString

A key that identifies a specific KakaoTalk user. It is valid per KakaoTalk channel and is case-sensitive.

senderKey

RequiredString

The key of the sender profile that received the message.

serviceType

RequiredString

The service type.

msgType

RequiredString

The message type.

requestType

RequiredString

The request type.

sendTime

RequiredString

The send time. Delivered in ISO 8601 format.

reportTime

RequiredString

The report time. Delivered in ISO 8601 format.

kakaoTime

String

The time the CS Talk server delivered the message. It is not the time the user actually typed it.

sessionId

String

The support session ID. An agent can send messages once a support session exists.

reference

Object

The current metadata you configured.

lastReference

Object

The most recent metadata delivered when there is no current metadata.

Returns

code

String

The webhook processing result code.

result

String

The webhook processing result message.

Request example

1curl -X POST "{๊ณ ๊ฐ Webhook URL}/cstalk/reference" \
2 -H "Accept: application/json" \
3 -H "Content-Type: application/json" \
4 -d '{
5 "msgKey":"20260424104234546POM101182450000",
6 "userKey":"{userKey}",
7 "senderKey":"{senderKey}",
8 "serviceType":"CSTALK",
9 "msgType":"REFERENCE",
10 "requestType":"reference",
11 "sendTime":"2026-04-24T10:42:34.546+09:00",
12 "reportTime":"2026-04-24T10:42:35.120+09:00",
13 "kakaoTime":"2026-04-24T10:42:35.000+09:00",
14 "sessionId":"{sessionId}",
15 "reference": {
16 "extra":"orderNo=1234"
17 },
18 "lastReference": {
19 "extra":"orderNo=1233",
20 "bot":"false",
21 "bot_event":" ์ƒ๋‹ด์‹œ์ž‘",
22 "created_at":"2026-04-23T09:30:00.000+09:00"
23 }
24}'

Response example

1{
2 "code":"A000",
3 "result":"Success"
4}

Receive session expiry

POST{your webhook URL}/cstalk/expired_session

Delivers session end information to the customer webhook URL you registered when the support session ends.

Body Parameters

{}JSON

userKey

RequiredString

The CS Talk user key.

senderKey

RequiredString

The key of the sender profile that received the message.

serviceType

RequiredString

The service type.

msgType

RequiredString

The message type.

requestType

RequiredString

The request type.

sendTime

RequiredString

The send time. Delivered in ISO 8601 format.

reportTime

RequiredString

The report time. Delivered in ISO 8601 format.

kakaoTime

String

The time the CS Talk server delivered the message. It is not the time the user actually typed it.

sessionId

String

The ID of the ended support session.

Returns

code

String

The webhook processing result code.

result

String

The webhook processing result message.

Request example

1curl -X POST "{๊ณ ๊ฐ Webhook URL}/cstalk/expired_session" \
2 -H "Accept: application/json" \
3 -H "Content-Type: application/json" \
4 -d '{
5 "userKey":"{userKey}",
6 "senderKey":"{senderKey}",
7 "serviceType":"CSTALK",
8 "msgType":"SESSION",
9 "requestType":"expired_session",
10 "sendTime":"2026-04-24T10:42:34.546+09:00",
11 "reportTime":"2026-04-24T10:42:35.120+09:00",
12 "kakaoTime":"2026-04-24T10:42:35.000+09:00",
13 "sessionId":"{sessionId}"
14}'

Response example

1{
2 "code":"A000",
3 "result":"Success"
4}

Receive read information

POST{your webhook URL}/cstalk/seen_info

Delivers user read information to the customer webhook URL you registered.

Body Parameters

{}JSON

userKey

RequiredString

The CS Talk user key.

senderKey

RequiredString

The key of the sender profile that received the message.

serviceType

RequiredString

The service type.

msgType

RequiredString

The message type.

requestType

RequiredString

The request type.

sendTime

RequiredString

The send time. Delivered in ISO 8601 format.

reportTime

RequiredString

The report time. Delivered in ISO 8601 format.

kakaoTime

String

The time the CS Talk server delivered the message. It is not the time the user actually typed it.

Returns

code

String

The webhook processing result code.

result

String

The webhook processing result message.

Request example

1curl -X POST "{๊ณ ๊ฐ Webhook URL}/cstalk/seen_info" \
2 -H "Accept: application/json" \
3 -H "Content-Type: application/json" \
4 -d '{
5 "userKey":"{userKey}",
6 "senderKey":"{senderKey}",
7 "serviceType":"CSTALK",
8 "msgType":"SEEN",
9 "requestType":"seen_info",
10 "sendTime":"2026-04-24T10:42:34.546+09:00",
11 "reportTime":"2026-04-24T10:42:35.120+09:00",
12 "kakaoTime":"2026-04-24T10:42:35.000+09:00"
13}'

Response example

1{
2 "code":"A000",
3 "result":"Success"
4}

Receive personal information

POST{your webhook URL}/cstalk/personal_info

Delivers the personal information provided after the user consents to its collection to the customer webhook URL you registered.

Body Parameters

{}JSON

userKey

RequiredString

The CS Talk user key.

senderKey

RequiredString

The key of the sender profile that received the message.

serviceType

RequiredString

The service type.

msgType

RequiredString

The message type.

requestType

RequiredString

The request type.

sendTime

RequiredString

The send time. Delivered in ISO 8601 format.

reportTime

RequiredString

The report time. Delivered in ISO 8601 format.

kakaoTime

String

The time the CS Talk server delivered the message. It is not the time the user actually typed it.

sessionId

String

The support session ID.

personalInfo

Object

The personal information the user consented to.

Returns

code

String

The webhook processing result code.

result

String

The webhook processing result message.

Request example

1curl -X POST "{๊ณ ๊ฐ Webhook URL}/cstalk/personal_info" \
2 -H "Accept: application/json" \
3 -H "Content-Type: application/json" \
4 -d '{
5 "userKey":"{userKey}",
6 "senderKey":"{senderKey}",
7 "serviceType":"CSTALK",
8 "msgType":"PERSONAL",
9 "requestType":"personal_info",
10 "sendTime":"2026-04-24T10:42:34.546+09:00",
11 "reportTime":"2026-04-24T10:42:35.120+09:00",
12 "kakaoTime":"2026-04-24T10:42:35.000+09:00",
13 "sessionId":"{sessionId}",
14 "personalInfo": {
15 "phone_number":"0100000000",
16 "nickname":"ํ™๊ธธ๋™"
17 }
18}'

Response example

1{
2 "code":"A000",
3 "result":"Success"
4}

Receive the delivery result

POST{your webhook URL}/cstalk/result

Delivers the result of a CS Talk message send request to the customer webhook URL you registered.

Body Parameters

{}JSON

msgKey

RequiredString

The message key.

userKey

RequiredString

The CS Talk user key.

senderKey

RequiredString

The key of the sender profile that received the message.

serviceType

RequiredString

The service type.

msgType

String

The message type.

requestType

RequiredString

The request type. One of write, end, and endwithbot.

sendTime

RequiredString

The send time. Delivered in ISO 8601 format.

reportTime

RequiredString

The report time. Delivered in ISO 8601 format.

reportCode

String

The report code.

reportText

String

The report message.

ref

String

The reference field you passed in the request.

Returns

code

String

The webhook processing result code.

result

String

The webhook processing result message.

Request example

1curl -X POST "{๊ณ ๊ฐ Webhook URL}/cstalk/result" \
2 -H "Accept: application/json" \
3 -H "Content-Type: application/json" \
4 -d '{
5 "msgKey":"20260424104234546POM101182450000",
6 "userKey":"{userKey}",
7 "senderKey":"{senderKey}",
8 "serviceType":"CSTALK",
9 "msgType":"TEXT",
10 "requestType":"write",
11 "sendTime":"2026-04-24T10:42:34.546+09:00",
12 "reportTime":"2026-04-24T10:42:35.120+09:00",
13 "reportCode":"A000",
14 "reportText":"Success",
15 "ref":"client-ref-001"
16}'

Response example

1{
2 "code":"A000",
3 "result":"Success"
4}

Upload files

Upload an image

POST/api/comm/v1/file/cstalk/image
Try it in the Sandbox

Uploads a CS Talk image file. It supports jpg, png, and gif, and you can register files up to 5MB.

Body Parameters

FORM-DATA

file

RequiredBinary

The image file to upload.

senderKey

RequiredString

The Kakao Biz Message sender profile key.

imageType

String

The image type. Enter rich when uploading an image for a Rich message.

Returns

common

Object

The common response section.

data

Object

The product response section.

Request example

1curl -X POST "https://mars.ibapi.kr/api/comm/v1/file/cstalk/image" \
2 -H "Authorization: {ApiKey}" \
3 -H "Content-Type: multipart/form-data" \
4 -F "file=@sample.jpg" \
5 -F "senderKey={senderKey}" \
6 -F "imageType=rich"

Response example

1{
2 "common": {
3 "authCode":"A000",
4 "authResult":"Success",
5 "infobankTrId":"header-value-X-Infobank-Tracking-Id"
6 },
7 "data": {
8 "code":"A000",
9 "result":"Success",
10 "data": {
11 "imgUrl":"https://mud-kage.kakao.com/.../cstalk_image.jpg"
12 }
13 }
14}

Upload a file

POST/api/comm/v1/file/cstalk
Try it in the Sandbox

Uploads a CS Talk attachment of the FILE, AUDIO, or VIDEO type.

Body Parameters

FORM-DATA

file

RequiredBinary

The binary of the file to upload.

senderKey

RequiredString

The Kakao Biz Message sender profile key.

fileType

String

The file type. file: general file, audio: audio file, video: video file.

Returns

common

Object

The common response section.

data

Object

The product response section.

Request example

1curl -X POST "https://mars.ibapi.kr/api/comm/v1/file/cstalk" \
2 -H "Authorization: {ApiKey}" \
3 -H "Content-Type: multipart/form-data" \
4 -F "file=@sample.pdf" \
5 -F "senderKey={senderKey}" \
6 -F "fileType=file"

Response example

1{
2 "common": {
3 "authCode":"A000",
4 "authResult":"Success",
5 "infobankTrId":"header-value-X-Infobank-Tracking-Id"
6 },
7 "data": {
8 "code":"A000",
9 "result":"Success",
10 "data": {
11 "fileUrl":"https://mud-kage.kakao.com/.../cstalk_file.pdf",
12 "fileName":"sample.pdf",
13 "size":"102400"
14 }
15 }
16}

Manage the channel

Activate CS Talk

POST/api/comm/v1/center/cstalk/sender/activate
Try it in the Sandbox

Enables CS Talk.

Body Parameters

{}JSON

cstalk

RequiredObject

The CS Talk request object.

Returns

common

Object

The common response section.

data

Object

The product response section.

Request example

1curl -X POST "https://mars.ibapi.kr/api/comm/v1/center/cstalk/sender/activate" \
2 -H "Authorization: {ApiKey}" \
3 -H "Content-Type: application/json" \
4 -d '{
5 "cstalk": {
6 "senderKey":"{senderKey}",
7 "committalCompany":"๋น„์ฆˆ๊ณ "
8 }
9}'

Response example

1{
2 "common": {
3 "authCode":"A000",
4 "authResult":"Success",
5 "infobankTrId":"Infobank-Tracking-Id"
6 },
7 "data": {
8 "code":"A000",
9 "result":"Success"
10 }
11}

Deactivate CS Talk

POST/api/comm/v1/center/cstalk/sender/deactivate
Try it in the Sandbox

Disables CS Talk.

Body Parameters

{}JSON

cstalk

RequiredObject

The CS Talk request object.

Returns

common

Object

The common response section.

data

Object

The product response section.

Request example

1curl -X POST "https://mars.ibapi.kr/api/comm/v1/center/cstalk/sender/deactivate" \
2 -H "Authorization: {ApiKey}" \
3 -H "Content-Type: application/json" \
4 -d '{
5 "cstalk": {
6 "senderKey":"{senderKey}",
7 "committalCompany":"๋น„์ฆˆ๊ณ "
8 }
9}'

Response example

1{
2 "common": {
3 "authCode":"A000",
4 "authResult":"Success",
5 "infobankTrId":"Infobank-Tracking-Id"
6 },
7 "data": {
8 "code":"A000",
9 "result":"Success"
10 }
11}

Activate the chat capability

POST/api/comm/v1/center/cstalk/sender/chat/activate
Try it in the Sandbox

Enables the chat feature of the KakaoTalk channel.

Body Parameters

{}JSON

cstalk

RequiredObject

The CS Talk request object.

Returns

common

Object

The common response section.

data

Object

The product response section.

Request example

1curl -X POST "https://mars.ibapi.kr/api/comm/v1/center/cstalk/sender/chat/activate" \
2 -H "Authorization: {ApiKey}" \
3 -H "Content-Type: application/json" \
4 -d '{
5 "cstalk": {
6 "senderKey":"{senderKey}"
7 }
8}'

Response example

1{
2 "common": {
3 "authCode":"A000",
4 "authResult":"Success",
5 "infobankTrId":"Infobank-Tracking-Id"
6 },
7 "data": {
8 "code":"A000",
9 "result":"Success"
10 }
11}

Deactivate the chat capability

POST/api/comm/v1/center/cstalk/sender/chat/deactivate
Try it in the Sandbox

Disables the chat feature of the KakaoTalk channel.

Body Parameters

{}JSON

cstalk

RequiredObject

The CS Talk request object.

Returns

common

Object

The common response section.

data

Object

The product response section.

Request example

1curl -X POST "https://mars.ibapi.kr/api/comm/v1/center/cstalk/sender/chat/deactivate" \
2 -H "Authorization: {ApiKey}" \
3 -H "Content-Type: application/json" \
4 -d '{
5 "cstalk": {
6 "senderKey":"{senderKey}"
7 }
8}'

Response example

1{
2 "common": {
3 "authCode":"A000",
4 "authResult":"Success",
5 "infobankTrId":"Infobank-Tracking-Id"
6 },
7 "data": {
8 "code":"A000",
9 "result":"Success"
10 }
11}

Look up support hours

GET/api/comm/v1/center/cstalk/consult/time
Try it in the Sandbox

Looks up the support hours.

Query Parameters

QUERY

senderKey

RequiredString

The Kakao Biz Message sender profile key.

Returns

common

Object

The common response section.

data

Object

The product response section.

Request example

1curl -X GET "https://mars.ibapi.kr/api/comm/v1/center/cstalk/consult/time?senderKey={senderKey}" \
2 -H "Authorization: {ApiKey}"

Response example

1{
2 "common": {
3 "authCode":"A000",
4 "authResult":"Success",
5 "infobankTrId":"header-value-X-Infobank-Tracking-Id"
6 },
7 "data": {
8 "code":"A000",
9 "result":"Success",
10 "data": {
11 "cstalk": {
12 "weekTimeTable": [{
13 "day":"mon",
14 "startAt":"0900",
15 "endAt":"1800"
16 }]
17 }
18 }
19 }
20}

Save support hours

POST/api/comm/v1/center/cstalk/consult/time
Try it in the Sandbox

Saves the support hours for the KakaoTalk channel. Once registered, hours can only be updated, and they are deleted if you disable CS Talk. The hours appear on the KakaoTalk channel home, and the chat feature must be enabled to view the configured hours.

Body Parameters

{}JSON

cstalk

RequiredObject

The CS Talk request object.

Returns

common

Object

The common response section.

data

Object

The product response section.

Request example

1curl -X POST "https://mars.ibapi.kr/api/comm/v1/center/cstalk/consult/time" \
2 -H "Authorization: {ApiKey}" \
3 -H "Content-Type: application/json" \
4 -d '{
5 "cstalk": {
6 "senderKey":"{senderKey}",
7 "weekTimeTable": [{
8 "day":"mon",
9 "startAt":"0900",
10 "endAt":"1800"
11 }]
12 }
13}'

Response example

1{
2 "common": {
3 "authCode":"A000",
4 "authResult":"Success",
5 "infobankTrId":"Infobank-Tracking-Id"
6 },
7 "data": {
8 "code":"A000",
9 "result":"Success"
10 }
11}

Look up system messages

GET/api/comm/v1/center/cstalk/system/message
Try it in the Sandbox

Looks up the list of system messages.

Query Parameters

QUERY

senderKey

RequiredString

The Kakao Biz Message sender profile key.

id

String

The system message ID. Enter it to look up a specific message only.

Returns

common

Object

The common response section.

data

Object

The product response section.

Request example

1curl -X GET "https://mars.ibapi.kr/api/comm/v1/center/cstalk/system/message?senderKey={senderKey}" \
2 -H "Authorization: {ApiKey}"

Response example

1{
2 "common": {
3 "authCode":"A000",
4 "authResult":"Success",
5 "infobankTrId":"header-value-X-Infobank-Tracking-Id"
6 },
7 "data": {
8 "code":"A000",
9 "result":"Success",
10 "data": {
11 "systemMessages": [{
12 "id":"7678",
13 "name":"์ƒ๋‹ด ์‹œ์ž‘ ์•ˆ๋‚ด",
14 "status":"A",
15 "createdAt":"2025-08-18 16:40:00",
16 "modifiedAt":"2025-08-18 16:40:00",
17 "inspectStatus":"REG",
18 "inspectRequestAt":"2025-08-27 13:16:59",
19 "inspectedAt":"",
20 "messages": [{
21 "messageType":"ST",
22 "content":"์ƒ๋‹ด์„ ์‹œ์ž‘ํ•ฉ๋‹ˆ๋‹ค.",
23 "buttons": [{
24 "ordering": 1,
25 "type":"WL",
26 "name":"๋ฐ”๋กœ๊ฐ€๊ธฐ",
27 "urlMobile":"https://m.example.com",
28 "urlPc":"https://www.example.com"
29 }]
30 }],
31 "comments": [{
32 "id":"101",
33 "content":"๊ฒ€์ˆ˜ ์š”์ฒญ์ด ๋“ฑ๋ก๋˜์—ˆ์Šต๋‹ˆ๋‹ค.",
34 "userName":"๋น„์ฆˆ๊ณ ",
35 "createdAt":"2025-08-27 13:17:02",
36 "status":"INQ"
37 }]
38 }]
39 }
40 }
41}

Register a system message

POST/api/comm/v1/center/cstalk/system/message
Try it in the Sandbox

Registers a system message.

Body Parameters

{}JSON

cstalk

RequiredObject

The CS Talk request object.

Returns

common

Object

The common response section.

data

Object

The product response section.

Request example

1curl -X POST "https://mars.ibapi.kr/api/comm/v1/center/cstalk/system/message" \
2 -H "Authorization: {ApiKey}" \
3 -H "Content-Type: application/json" \
4 -d '{
5 "cstalk": {
6 "senderKey":"{senderKey}",
7 "name":"์ƒ๋‹ด ์‹œ์ž‘ ์•ˆ๋‚ด",
8 "messages": [{
9 "messageType":"ST",
10 "content":"์ƒ๋‹ด์„ ์‹œ์ž‘ํ•ฉ๋‹ˆ๋‹ค.",
11 "buttons": [{
12 "ordering": 1,
13 "type":"WL",
14 "name":"๋ฐ”๋กœ๊ฐ€๊ธฐ",
15 "urlMobile":"https://m.example.com",
16 "urlPc":"https://www.example.com"
17 }]
18 }]
19 }
20}'

Response example

1{
2 "common": {
3 "authCode":"A000",
4 "authResult":"Success",
5 "infobankTrId":"header-value-X-Infobank-Tracking-Id"
6 },
7 "data": {
8 "code":"A000",
9 "result":"Success",
10 "data": {
11 "systemMessage": {
12 "id":"7678"
13 }
14 }
15 }
16}

Delete a system message

DELETE/api/comm/v1/center/cstalk/system/message/senderKey/{senderKey}/id/{id}
Try it in the Sandbox

Deletes a system message.

Path Parameters

PATH

senderKey

RequiredString

The sender profile key.

id

RequiredString

The ID of the system message to delete.

Returns

common

Object

The common response section.

data

Object

The product response section.

Request example

1curl -X DELETE "https://mars.ibapi.kr/api/comm/v1/center/cstalk/system/message/senderKey/%40bizgo/id/sysMsgId" \
2 -H "Authorization: {ApiKey}"

Response example

1{
2 "common": {
3 "authCode":"A000",
4 "authResult":"Success",
5 "infobankTrId":"Infobank-Tracking-Id"
6 },
7 "data": {
8 "code":"A000",
9 "result":"Success"
10 }
11}

Request a system message review

POST/api/comm/v1/center/cstalk/system/message/approval/request
Try it in the Sandbox

Requests a review of the system message.

Body Parameters

{}JSON

cstalk

RequiredObject

The CS Talk request object.

Returns

common

Object

The common response section.

data

Object

The product response section.

Request example

1curl -X POST "https://mars.ibapi.kr/api/comm/v1/center/cstalk/system/message/approval/request" \
2 -H "Authorization: {ApiKey}" \
3 -H "Content-Type: application/json" \
4 -d '{
5 "cstalk": {
6 "senderKey":"{senderKey}"
7 }
8}'

Response example

1{
2 "common": {
3 "authCode":"A000",
4 "authResult":"Success",
5 "infobankTrId":"Infobank-Tracking-Id"
6 },
7 "data": {
8 "code":"A000",
9 "result":"Success"
10 }
11}

Cancel a system message review

POST/api/comm/v1/center/cstalk/system/message/approval/cancel
Try it in the Sandbox

Cancels the review request for the system message.

Body Parameters

{}JSON

cstalk

RequiredObject

The CS Talk request object.

Returns

common

Object

The common response section.

data

Object

The product response section.

Request example

1curl -X POST "https://mars.ibapi.kr/api/comm/v1/center/cstalk/system/message/approval/cancel" \
2 -H "Authorization: {ApiKey}" \
3 -H "Content-Type: application/json" \
4 -d '{
5 "cstalk": {
6 "senderKey":"{senderKey}"
7 }
8}'

Response example

1{
2 "common": {
3 "authCode":"A000",
4 "authResult":"Success",
5 "infobankTrId":"Infobank-Tracking-Id"
6 },
7 "data": {
8 "code":"A000",
9 "result":"Success"
10 }
11}

Connect a support conversation

Customers can request support through a support connection button on a PC or mobile page.

When you pass meta information through the support connection button on PC, you must open the requesting page as a new window or a popup; the minimum recommended popup size is 1024 x 800.

If clicking the support connection button goes through a partner page before moving to the Kakao login page, include the script below inside the partner page and the popup window opens at the recommended size.

HTML
<script src="https://bizmessage.kakao.com/chat/includeScript"></script>

For a profile that uses both a bot and CS Talk, you can use the bot parameter to control whether the connection goes to the bot or to CS Talk.

Button connection (POST)

POSThttps://bizmessage.kakao.com/chat/open
Try it in the Sandbox

Calls the Kakao support connection URL directly with POST. Use application/x-www-form-urlencoded as the Content-Type.

Body Parameters

FORM-URLENCODED

uuid

RequiredString(40)

The sender profile key. Note that this is not the KakaoTalk channel @id.

extra

String(1000)

The metadata delivered to the user when switching to CS Talk or the bot.

bot

String(5)

Enter true to connect to the bot, false (default) to connect to an agent, and auto to keep an ongoing session.

event

String(100)

The name of the event fired when the user is handed off to the bot.

app_open_type

String

How the app is launched. Enter direct or modal.

Returns

redirect

Redirect

Opens the KakaoTalk support connection screen. This is not a separate Bizgo API JSON response.

Request example

1curl -X POST "https://bizmessage.kakao.com/chat/open" \
2 -H "Content-Type: application/x-www-form-urlencoded" \
3 -d "uuid={uuid}&extra={extra}&bot=false&event={event}&app_open_type=direct"

Response example

1์นด์นด์˜ค ์ƒ๋‹ด ์—ฐ๊ฒฐ URL ํ˜ธ์ถœ ํ›„ ์นด์นด์˜คํ†ก ์ƒ๋‹ด ํ™”๋ฉด์œผ๋กœ ์ด๋™ํ•ฉ๋‹ˆ๋‹ค.
2๋น„์ฆˆ๊ณ  API JSON ์‘๋‹ต์ด ์•„๋‹ˆ๋ผ ์นด์นด์˜ค URL ์ด๋™/์‘๋‹ต์œผ๋กœ ์ฒ˜๋ฆฌ๋ฉ๋‹ˆ๋‹ค.

Button connection (GET)

GEThttps://bizmessage.kakao.com/chat/open/{uuid}
Try it in the Sandbox

Calls the Kakao support connection URL directly with GET. Include uuid in the path and pass the remaining values as query parameters.

Query Parameters

QUERY

uuid

RequiredString(40)

The sender profile key. Pass it as a path parameter, and note that it is not the KakaoTalk channel @id.

extra

String(50)

The metadata delivered to the user when switching to CS Talk or the bot.

bot

String(5)

Enter true to connect to the bot, false (default) to connect to an agent, and auto to keep an ongoing session.

event

String(100)

The name of the event fired when the user is handed off to the bot.

app_open_type

String

How the app is launched. Enter direct or modal.

Returns

redirect

Redirect

Opens the KakaoTalk support connection screen. This is not a separate Bizgo API JSON response.

Request example

1curl -X GET "https://bizmessage.kakao.com/chat/open/{uuid}?extra={extra}&bot=false&event={event}&app_open_type=direct"

Response example

1์นด์นด์˜ค ์ƒ๋‹ด ์—ฐ๊ฒฐ URL ํ˜ธ์ถœ ํ›„ ์นด์นด์˜คํ†ก ์ƒ๋‹ด ํ™”๋ฉด์œผ๋กœ ์ด๋™ํ•ฉ๋‹ˆ๋‹ค.
2๋น„์ฆˆ๊ณ  API JSON ์‘๋‹ต์ด ์•„๋‹ˆ๋ผ ์นด์นด์˜ค URL ์ด๋™/์‘๋‹ต์œผ๋กœ ์ฒ˜๋ฆฌ๋ฉ๋‹ˆ๋‹ค.