bizgo Developers
API 레퍼런스커뮤니케이션 API카카오 비즈메시지

상담톡

상담톡은 카카오톡 채널을 통해 고객과 1:1 상담 메시지를 송수신하고, 상담 세션과 운영 설정을 함께 관리할 수 있는 카카오 비즈메시지 채널입니다.

상담하기

Plain 메시지 발송

POST/api/comm/v1/cstalk/plain
샌드박스로 테스트하기

상담톡 Plain 메시지를 발송합니다. msgType에 따라 TEXT, IMAGE, VIDEO, AUDIO, FILE을 발송할 수 있습니다.

Body Parameters

{}JSON

userKey

필수String

사용자 키입니다.

senderKey

필수String

발신프로필 키입니다.

msgType

필수String

메시지 타입입니다.

message

필수String

사용자에게 전달할 메시지입니다. 최대 1,000자입니다.

attachment

Object

첨부 메시지 객체입니다. IMAGE, VIDEO, AUDIO, FILE 타입에서 사용합니다.

ref

String

참조 필드입니다. 최대 200자이며 전송 요청 결과 Webhook에서 함께 반환됩니다.

Returns

common

Object

공통 응답 영역입니다.

data

Object

상품 응답 영역입니다.

요청 예시

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}'

응답 예시

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}

Rich 메시지 발송

POST/api/comm/v1/cstalk/rich
샌드박스로 테스트하기

상담톡 Rich 메시지를 발송합니다. TEXT, IMAGE, WIDE, ITEM_LIST, WIDE_ITEM_LIST, CAROUSEL_FEED, PERSONAL 타입을 지원합니다.

Body Parameters

{}JSON

userKey

필수String

사용자 키입니다.

senderKey

필수String

발신프로필 키입니다.

msgType

필수String

메시지 풍선 타입입니다.

message

String

사용자에게 전달할 메시지입니다.

description

String

사용자에게 전달할 부가 메시지입니다.

header

String

헤더입니다.

attachment

Object

메시지 첨부 정보입니다.

carousel

Object

캐러셀 정보입니다. CAROUSEL_FEED 타입에서 필수입니다.

autoAnswer

String

시스템 자동 응답 메시지입니다.

lock

Boolean

보안 메시지 여부입니다.

certExpiry

Integer

본인인증 유효 시간(분)입니다. msgType이 KAKAO_CERT일 때 필수입니다.

ref

String

참조 필드입니다. 최대 200자이며 전송 요청 결과 Webhook에서 함께 반환됩니다.

Returns

common

Object

공통 응답 영역입니다.

data

Object

상품 응답 영역입니다.

요청 예시

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}'

응답 예시

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}

상담 종료

POST/api/comm/v1/cstalk/end
샌드박스로 테스트하기

현재 열려 있는 상담 세션을 종료합니다.

Body Parameters

{}JSON

userKey

필수String

사용자 키입니다.

senderKey

필수String

발신프로필 키입니다.

Returns

common

Object

공통 응답 영역입니다.

data

Object

상품 응답 영역입니다.

요청 예시

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}'

응답 예시

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}

상담 종료 및 봇 전환

POST/api/comm/v1/cstalk/endWithBot
샌드박스로 테스트하기

상담 세션을 종료한 뒤 봇 이벤트 말블록을 실행합니다.

Body Parameters

{}JSON

userKey

필수String

사용자 키입니다.

senderKey

필수String

발신프로필 키입니다.

botEvent

String

실행할 봇 이벤트명입니다.

Returns

common

Object

공통 응답 영역입니다.

data

Object

상품 응답 영역입니다.

요청 예시

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}'

응답 예시

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}

사용자 수신 차단

POST/api/comm/v1/center/cstalk/profile/user/block
샌드박스로 테스트하기

특정 사용자의 상담톡 수신을 차단합니다.

Body Parameters

{}JSON

cstalk

필수Object

상담톡 요청 객체입니다.

Returns

common

Object

공통 응답 영역입니다.

data

Object

상품 응답 영역입니다.

요청 예시

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}'

응답 예시

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}

사용자 수신 차단 해제

POST/api/comm/v1/center/cstalk/profile/user/unblock
샌드박스로 테스트하기

차단된 사용자의 상담톡 수신 차단을 해제합니다.

Body Parameters

{}JSON

cstalk

필수Object

상담톡 요청 객체입니다.

Returns

common

Object

공통 응답 영역입니다.

data

Object

상품 응답 영역입니다.

요청 예시

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}'

응답 예시

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}

세션 조회

GET/api/comm/v1/center/cstalk/session
샌드박스로 테스트하기

사용자 키 기준으로 현재 상담 세션 정보를 조회합니다.

Query Parameters

QUERY

userKey

필수String

사용자 키입니다.

Returns

common

Object

공통 응답 영역입니다.

data

Object

상품 응답 영역입니다.

요청 예시

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

응답 예시

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}

카카오톡 인증 상태 조회

GET/api/comm/v1/center/cstalk/cert/status
샌드박스로 테스트하기

인증 트랜잭션 ID로 고객의 카카오톡 인증(전자서명) 진행 상태를 조회합니다.

Query Parameters

QUERY

certTxId

필수String

인증 트랜잭션 ID입니다. 카카오가 인증 요청 시 발급합니다.

Returns

common

Object

공통 응답 영역입니다.

data

Object

상품 응답 영역입니다.

요청 예시

1curl -X GET "https://mars.ibapi.kr/api/comm/v1/center/cstalk/cert/status?certTxId=certTxIdSample" \
2 -H "Authorization: {ApiKey}"

응답 예시

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 "cert": {
12 "txId":"{certTxId}",
13 "sessionId": 1,
14 "signStatus":"COMPLETED",
15 "createdAt":"2026-09-10T10:00:00",
16 "viewedAt":"2026-09-10T10:00:30",
17 "completedAt":"2026-09-10T10:01:12",
18 "expiredAt":"2026-09-10T10:10:00"
19 }
20 }
21 }
22}

상담메시지 수신하기 (Webhook)

사용자 메시지 수신

POST{고객 Webhook URL}/cstalk/message

사용자 메시지 수신 Webhook입니다. 등록한 고객 Webhook URL로 사용자가 전송한 메시지 데이터를 전달합니다.

Body Parameters

{}JSON

msgKey

필수String

메시지 키입니다.

userKey

필수String

상담톡 사용자 키입니다.

senderKey

필수String

메시지를 수신한 발신프로필 키입니다.

serviceType

필수String

서비스 타입입니다.

msgType

필수String

메시지 타입입니다.

requestType

String

요청 타입입니다.

sendTime

필수String

전송 일시입니다. ISO 8601 형식으로 전달됩니다.

reportTime

필수String

리포트 일시입니다. ISO 8601 형식으로 전달됩니다.

kakaoTime

String

상담톡 서버에서 메시지를 전달한 일시입니다. 실제 사용자가 입력한 시각은 아닙니다.

sessionId

String

상담 세션 ID입니다.

content

String

하위 호환을 위해 유지되는 본문 필드입니다.

extra

String

카카오가 전달한 부가 정보입니다.

contents

Object Array

사용자가 전송한 메시지 데이터 배열입니다. 2026년 1월 이후 content 필드는 제공되지 않으므로 contents를 사용합니다.

attachment

String

사용자 메시지가 4,000자를 초과하는 경우 전체 메시지를 txt 파일 URL로 추가 전달하는 영역입니다.

Returns

code

String

Webhook 처리 결과 코드입니다.

result

String

Webhook 처리 결과 메시지입니다.

요청 예시

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}'

응답 예시

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

사용자 메타 정보 수신

POST{고객 Webhook URL}/cstalk/reference

사용자가 상담 연결을 요청한 시점의 메타 정보를 등록한 고객 Webhook URL로 전달합니다.

Body Parameters

{}JSON

msgKey

필수String

메시지 키입니다.

userKey

필수String

특정 카카오톡 사용자를 구분하는 키입니다. 카카오톡 채널별로 유효하며 대소문자를 구분합니다.

senderKey

필수String

메시지를 수신한 발신프로필 키입니다.

serviceType

필수String

서비스 타입입니다.

msgType

필수String

메시지 타입입니다.

requestType

필수String

요청 타입입니다.

sendTime

필수String

전송 일시입니다. ISO 8601 형식으로 전달됩니다.

reportTime

필수String

리포트 일시입니다. ISO 8601 형식으로 전달됩니다.

kakaoTime

String

상담톡 서버에서 메시지를 전달한 일시입니다. 실제 사용자가 입력한 시각은 아닙니다.

appUserId

Number

카카오톡 앱 사용자 ID입니다.

sessionId

String

상담 세션 아이디입니다. 상담 세션이 생성된 상태에서 상담원이 메시지를 발송할 수 있습니다.

reference

Object

고객사에서 설정한 현재 메타 정보입니다.

lastReference

Object

현재 메타 정보가 없는 경우 전달되는 가장 마지막 메타 정보입니다.

Returns

code

String

Webhook 처리 결과 코드입니다.

result

String

Webhook 처리 결과 메시지입니다.

요청 예시

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}'

응답 예시

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

세션 종료 수신

POST{고객 Webhook URL}/cstalk/expired_session

상담 세션이 종료되었을 때 등록한 고객 Webhook URL로 세션 종료 정보를 전달합니다.

Body Parameters

{}JSON

msgKey

필수String

메시지 키입니다.

userKey

필수String

상담톡 사용자 키입니다.

senderKey

필수String

메시지를 수신한 발신프로필 키입니다.

serviceType

필수String

서비스 타입입니다.

msgType

필수String

메시지 타입입니다.

requestType

필수String

요청 타입입니다.

sendTime

필수String

전송 일시입니다. ISO 8601 형식으로 전달됩니다.

reportTime

필수String

리포트 일시입니다. ISO 8601 형식으로 전달됩니다.

kakaoTime

String

상담톡 서버에서 메시지를 전달한 일시입니다. 실제 사용자가 입력한 시각은 아닙니다.

sessionId

String

종료된 상담 세션 아이디입니다.

Returns

code

String

Webhook 처리 결과 코드입니다.

result

String

Webhook 처리 결과 메시지입니다.

요청 예시

1curl -X POST "{고객 Webhook URL}/cstalk/expired_session" \
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":"SESSION",
10 "requestType":"expired_session",
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}'

응답 예시

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

읽음 정보 수신

POST{고객 Webhook URL}/cstalk/seen_info

사용자 읽음 정보를 등록한 고객 Webhook URL로 전달합니다.

Body Parameters

{}JSON

msgKey

필수String

메시지 키입니다.

userKey

필수String

상담톡 사용자 키입니다.

senderKey

필수String

메시지를 수신한 발신프로필 키입니다.

serviceType

필수String

서비스 타입입니다.

msgType

필수String

메시지 타입입니다.

requestType

필수String

요청 타입입니다.

sendTime

필수String

전송 일시입니다. ISO 8601 형식으로 전달됩니다.

reportTime

필수String

리포트 일시입니다. ISO 8601 형식으로 전달됩니다.

kakaoTime

String

상담톡 서버에서 메시지를 전달한 일시입니다. 실제 사용자가 입력한 시각은 아닙니다.

Returns

code

String

Webhook 처리 결과 코드입니다.

result

String

Webhook 처리 결과 메시지입니다.

요청 예시

1curl -X POST "{고객 Webhook URL}/cstalk/seen_info" \
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":"SEEN",
10 "requestType":"seen_info",
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}'

응답 예시

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

개인정보 수신

POST{고객 Webhook URL}/cstalk/personal_info

사용자 개인정보 수집 동의 후 전달되는 개인정보를 등록한 고객 Webhook URL로 전달합니다.

Body Parameters

{}JSON

msgKey

필수String

메시지 키입니다.

userKey

필수String

상담톡 사용자 키입니다.

senderKey

필수String

메시지를 수신한 발신프로필 키입니다.

serviceType

필수String

서비스 타입입니다.

msgType

필수String

메시지 타입입니다.

requestType

필수String

요청 타입입니다.

sendTime

필수String

전송 일시입니다. ISO 8601 형식으로 전달됩니다.

reportTime

필수String

리포트 일시입니다. ISO 8601 형식으로 전달됩니다.

kakaoTime

String

상담톡 서버에서 메시지를 전달한 일시입니다. 실제 사용자가 입력한 시각은 아닙니다.

sessionId

String

상담 세션 아이디입니다.

personalInfo

Object

사용자가 동의한 개인정보입니다.

Returns

code

String

Webhook 처리 결과 코드입니다.

result

String

Webhook 처리 결과 메시지입니다.

요청 예시

1curl -X POST "{고객 Webhook URL}/cstalk/personal_info" \
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":"PERSONAL",
10 "requestType":"personal_info",
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 "personalInfo": {
16 "phone_number":"0100000000",
17 "nickname":"홍길동"
18 }
19}'

응답 예시

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

본인인증 결과 수신

POST{고객 Webhook URL}/cstalk/cert_result

본인인증 결과 수신 Webhook입니다. KAKAO_CERT 말풍선으로 요청한 카카오톡 본인인증(전자서명)이 완료되면 등록된 Webhook URL로 결과가 전달됩니다.

Body Parameters

{}JSON

msgKey

필수String

메시지 키입니다.

userKey

필수String

사용자 키입니다.

senderKey

필수String

발신프로필 키입니다.

serviceType

필수String

서비스 타입입니다.

msgType

필수String

메시지 타입입니다.

requestType

필수String

요청 타입입니다. cert_result로 전달됩니다.

sendTime

필수String

수신 일시입니다. (ISO 8601, yyyy-MM-dd'T'HH:mm:ss.SSS).

reportTime

필수String

리포트 일시입니다. (ISO 8601, yyyy-MM-dd'T'HH:mm:ss.SSS).

kakaoTime

String

카카오 서버 수신 일시입니다.

sessionId

String

상담 세션 ID입니다.

certTxId

필수String

인증 트랜잭션 ID입니다. 인증 상태 조회 API의 certTxId와 같은 값입니다.

certResult

필수String

암호화된 본인인증 결과입니다. 복호화하면 이름·전화번호·생년월일·성별·내외국인·CI가 들어 있습니다.

Returns

code

String

Webhook 처리 결과 코드입니다.

result

String

Webhook 처리 결과 메시지입니다.

요청 예시

1curl -X POST "{고객 Webhook URL}/cstalk/cert_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":"KAKAO_CERT",
10 "requestType":"cert_result",
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 "certTxId":"{certTxId}",
16 "certResult":"amI1a0dQTVVRSm1YTk9BNW9tYWpXdz09"
17 }'

응답 예시

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

발송 결과 수신

POST{고객 Webhook URL}/cstalk/result

상담톡 메시지 전송 요청 결과를 등록한 고객 Webhook URL로 전달합니다.

Body Parameters

{}JSON

msgKey

필수String

메시지 키입니다.

userKey

필수String

상담톡 사용자 키입니다.

senderKey

필수String

메시지를 수신한 발신프로필 키입니다.

serviceType

필수String

서비스 타입입니다.

msgType

String

메시지 타입입니다.

requestType

필수String

요청 타입입니다. write, end, endwithbot 중 하나입니다.

sendTime

필수String

전송 일시입니다. ISO 8601 형식으로 전달됩니다.

reportTime

필수String

리포트 일시입니다. ISO 8601 형식으로 전달됩니다.

reportCode

String

발송 결과 코드입니다. 카카오 응답 코드를 비즈고 코드로 변환한 값입니다.

reportText

String

리포트 메시지입니다.

kakaoResCreatedAt

String

카카오 응답 생성 일시입니다. (ISO 8601).

ref

String

요청 시 전달한 참조 필드입니다.

Returns

code

String

Webhook 처리 결과 코드입니다.

result

String

Webhook 처리 결과 메시지입니다.

요청 예시

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}'

응답 예시

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

파일 업로드

이미지 업로드

POST/api/comm/v1/file/cstalk/image
샌드박스로 테스트하기

상담톡 이미지 파일을 업로드합니다. jpg, png, gif 형식을 지원하며 최대 5MB까지 등록할 수 있습니다.

Body Parameters

FORM-DATA

file

필수Binary

업로드할 이미지 파일입니다.

fileKey

String

업로드 파일을 식별하는 키입니다. 생략하면 서버가 자동으로 생성합니다.

imageName

String

업로드 파일의 이름입니다. 생략하면 확장자를 제외한 파일명을 사용합니다.

senderKey

필수String

카카오 비즈메시지 발신프로필 키입니다.

imageType

String

이미지 타입입니다. Rich 메시지 이미지 업로드 시 rich를 입력합니다.

Returns

common

Object

공통 응답 영역입니다.

data

Object

상품 응답 영역입니다.

요청 예시

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"

응답 예시

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}

파일 업로드

POST/api/comm/v1/file/cstalk
샌드박스로 테스트하기

상담톡 FILE·AUDIO·VIDEO 타입 첨부 파일을 업로드합니다.

Body Parameters

FORM-DATA

file

필수Binary

업로드할 파일 바이너리입니다.

fileKey

String

업로드 파일을 식별하는 키입니다. 생략하면 서버가 자동으로 생성합니다.

imageName

String

업로드 파일의 이름입니다. 생략하면 확장자를 제외한 파일명을 사용합니다.

senderKey

필수String

카카오 비즈메시지 발신프로필 키입니다.

fileType

String

파일 타입입니다. file: 일반 파일, audio: 오디오 파일, video: 비디오 파일입니다.

Returns

common

Object

공통 응답 영역입니다.

data

Object

상품 응답 영역입니다.

요청 예시

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"

응답 예시

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}

채널 관리하기

상담톡 등록

발신프로필을 상담톡에 등록합니다. 상담톡 권한 부여, 발신프로필 등록, 계정 연결이 차례로 진행되며, 각 단계의 결과를 data.steps로 돌려줍니다. 중간 단계가 실패하면 실패한 단계까지 담기므로 어느 단계에서 멈췄는지 확인할 수 있습니다.

POST/api/comm/v1/account/kakao/sender/cstalk
샌드박스로 테스트하기

발신프로필을 상담톡에 등록합니다. 상담톡 권한 부여, 발신프로필 등록, 계정 연결이 차례로 진행되며 각 단계의 결과를 data.steps 로 돌려줍니다. 실패하면 실패한 단계까지 담깁니다.

Body Parameters

senderKey

필수String

상담톡에 등록할 발신프로필 키입니다.

yellowId

필수String

카카오톡 채널 아이디입니다. (ex: @bizgo).

envType

필수String

이용 환경입니다.

webhookUrl

필수String

상담 메시지를 받을 웹훅 URL입니다.

csTalkActive

필수String

상담톡 활성화 여부입니다. (Y | N).

chatActive

필수String

채팅 활성화 여부입니다. (Y | N).

allow

필수String

허용 여부입니다. (Y | N).

committalCompany

String

상담 내용 위탁사명입니다.

Returns

common

Object

공통 응답 영역입니다.

data

Object

서비스 응답 영역입니다.

요청 예시

1curl -X POST "https://mars.ibapi.kr/api/comm/v1/account/kakao/sender/cstalk" \
2 -H "Content-Type: application/json" \
3 -H "Authorization: {ApiKey}" \
4 -d '{
5 "senderKey": "{senderKey}",
6 "yellowId": "{yellowId}",
7 "envType": "PRD",
8 "webhookUrl": "https://example.com/hook",
9 "csTalkActive": "Y",
10 "chatActive": "Y",
11 "allow": "Y",
12 "committalCompany": "{committalCompany}"
13}'

응답 예시

1{
2 "common": {
3 "authCode":"A000",
4 "authResult":"SUCCESS",
5 "infobankTrId":"M-260724133217180PRD26415"
6 },
7 "data": {
8 "code":"A000",
9 "result":"SUCCESS",
10 "resultMsg":"요청 성공",
11 "steps": [
12 {
13 "stepNo": 1,
14 "stepName":"V2 센더키 중복 확인",
15 "success": true,
16 "message":"성공"
17 },
18 {
19 "stepNo": 2,
20 "stepName":"상담톡 권한 부여",
21 "success": true,
22 "message":"성공"
23 },
24 {
25 "stepNo": 3,
26 "stepName":"센더키 등록",
27 "success": true,
28 "message":"성공"
29 },
30 {
31 "stepNo": 4,
32 "stepName":"계정 연결",
33 "success": true,
34 "message":"성공"
35 }
36 ]
37 }
38}

상담톡 수정

API 키로 등록한 상담톡의 웹훅 URL, 상담톡·채팅 활성화 여부 등을 수정합니다. 대상 발신프로필 키는 경로로 지정하며 바꿀 수 없습니다. envType은 등록한 환경과 같아야 합니다.

PUT/api/comm/v1/account/kakao/sender/cstalk/{senderKey}
샌드박스로 테스트하기

API 키에 등록된 상담톡의 설정(웹훅 URL, 상담톡·채팅 활성화 여부 등)을 수정합니다. 발신프로필 키 자체는 바꿀 수 없으며, 각 단계의 결과를 data.steps 로 돌려줍니다.

Path Parameters

senderKey

필수String

수정할 상담톡의 발신프로필 키입니다.

Body Parameters

yellowId

필수String

카카오톡 채널 아이디입니다. (ex: @bizgo).

envType

필수String

이용 환경입니다.

webhookUrl

필수String

상담 메시지를 받을 웹훅 URL입니다.

csTalkActive

필수String

상담톡 활성화 여부입니다. (Y | N).

chatActive

필수String

채팅 활성화 여부입니다. (Y | N).

allow

필수String

허용 여부입니다. (Y | N).

committalCompany

String

상담 내용 위탁사명입니다.

Returns

common

Object

공통 응답 영역입니다.

data

Object

서비스 응답 영역입니다.

요청 예시

1curl -X PUT "https://mars.ibapi.kr/api/comm/v1/account/kakao/sender/cstalk/{senderKey}" \
2 -H "Content-Type: application/json" \
3 -H "Authorization: {ApiKey}" \
4 -d '{
5 "yellowId": "{yellowId}",
6 "envType": "PRD",
7 "webhookUrl": "https://example.com/hook",
8 "csTalkActive": "Y",
9 "chatActive": "Y",
10 "allow": "Y",
11 "committalCompany": "{committalCompany}"
12}'

응답 예시

1{
2 "common": {
3 "authCode":"A000",
4 "authResult":"SUCCESS",
5 "infobankTrId":"M-260724133217180PRD26415"
6 },
7 "data": {
8 "code":"A000",
9 "result":"SUCCESS",
10 "resultMsg":"요청 성공",
11 "steps": [
12 {
13 "stepNo": 1,
14 "stepName":"상담톡 조회·소유 확인",
15 "success": true,
16 "message":"성공"
17 },
18 {
19 "stepNo": 2,
20 "stepName":"상담톡 수정",
21 "success": true,
22 "message":"성공"
23 },
24 {
25 "stepNo": 3,
26 "stepName":"계정 정보 수정",
27 "success": true,
28 "message":"성공"
29 }
30 ]
31 }
32}

상담톡 이용 활성화

POST/api/comm/v1/center/cstalk/sender/activate
샌드박스로 테스트하기

상담톡 이용을 활성화합니다.

Body Parameters

{}JSON

cstalk

필수Object

상담톡 요청 객체입니다.

Returns

common

Object

공통 응답 영역입니다.

data

Object

상품 응답 영역입니다.

요청 예시

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}'

응답 예시

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}

상담톡 이용 비활성화

POST/api/comm/v1/center/cstalk/sender/deactivate
샌드박스로 테스트하기

상담톡 이용을 비활성화합니다.

Body Parameters

{}JSON

cstalk

필수Object

상담톡 요청 객체입니다.

Returns

common

Object

공통 응답 영역입니다.

data

Object

상품 응답 영역입니다.

요청 예시

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}'

응답 예시

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}

채팅 기능 활성화

POST/api/comm/v1/center/cstalk/sender/chat/activate
샌드박스로 테스트하기

카카오톡 채널의 채팅 기능을 활성화합니다.

Body Parameters

{}JSON

cstalk

필수Object

상담톡 요청 객체입니다.

Returns

common

Object

공통 응답 영역입니다.

data

Object

상품 응답 영역입니다.

요청 예시

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}'

응답 예시

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}

채팅 기능 비활성화

POST/api/comm/v1/center/cstalk/sender/chat/deactivate
샌드박스로 테스트하기

카카오톡 채널의 채팅 기능을 비활성화합니다.

Body Parameters

{}JSON

cstalk

필수Object

상담톡 요청 객체입니다.

Returns

common

Object

공통 응답 영역입니다.

data

Object

상품 응답 영역입니다.

요청 예시

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}'

응답 예시

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}

상담시간 조회

GET/api/comm/v1/center/cstalk/consult/time
샌드박스로 테스트하기

상담 운영 시간을 조회합니다.

Query Parameters

QUERY

senderKey

필수String

카카오 비즈메시지 발신프로필 키입니다.

Returns

common

Object

공통 응답 영역입니다.

data

Object

상품 응답 영역입니다.

요청 예시

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

응답 예시

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}

상담시간 저장

POST/api/comm/v1/center/cstalk/consult/time
샌드박스로 테스트하기

카카오톡 채널의 상담시간을 저장합니다. 한 번 시간이 등록되면 수정만 가능하며, 상담톡 이용 여부를 해지하면 상담 시간은 삭제됩니다. 카카오톡 채널 홈에 상담시간이 노출되며, 설정된 상담 시간을 확인하려면 채팅 기능이 활성화된 상태여야 합니다.

Body Parameters

{}JSON

cstalk

필수Object

상담톡 요청 객체입니다.

Returns

common

Object

공통 응답 영역입니다.

data

Object

상품 응답 영역입니다.

요청 예시

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}'

응답 예시

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}

시스템 메시지 조회

GET/api/comm/v1/center/cstalk/system/message
샌드박스로 테스트하기

시스템 메시지 목록을 조회합니다.

Query Parameters

QUERY

senderKey

필수String

카카오 비즈메시지 발신프로필 키입니다.

id

String

시스템 메시지 ID입니다. 특정 메시지만 조회할 때 입력합니다.

Returns

common

Object

공통 응답 영역입니다.

data

Object

상품 응답 영역입니다.

요청 예시

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

응답 예시

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}

시스템 메시지 등록

POST/api/comm/v1/center/cstalk/system/message
샌드박스로 테스트하기

시스템 메시지를 등록합니다.

Body Parameters

{}JSON

cstalk

필수Object

상담톡 요청 객체입니다.

Returns

common

Object

공통 응답 영역입니다.

data

Object

상품 응답 영역입니다.

요청 예시

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}'

응답 예시

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/api/comm/v1/center/cstalk/system/message/senderKey/{senderKey}/id/{id}
샌드박스로 테스트하기

시스템 메시지를 삭제합니다.

Path Parameters

PATH

senderKey

필수String

발신프로필 키입니다.

id

필수String

삭제할 시스템 메시지 ID입니다.

Returns

common

Object

공통 응답 영역입니다.

data

Object

상품 응답 영역입니다.

요청 예시

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

응답 예시

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}

시스템 메시지 검수 요청

POST/api/comm/v1/center/cstalk/system/message/approval/request
샌드박스로 테스트하기

시스템 메시지 검수를 요청합니다.

Body Parameters

{}JSON

cstalk

필수Object

상담톡 요청 객체입니다.

Returns

common

Object

공통 응답 영역입니다.

data

Object

상품 응답 영역입니다.

요청 예시

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}'

응답 예시

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}

시스템 메시지 검수 취소

POST/api/comm/v1/center/cstalk/system/message/approval/cancel
샌드박스로 테스트하기

시스템 메시지 검수 요청을 취소합니다.

Body Parameters

{}JSON

cstalk

필수Object

상담톡 요청 객체입니다.

Returns

common

Object

공통 응답 영역입니다.

data

Object

상품 응답 영역입니다.

요청 예시

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}'

응답 예시

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}

상담 메시지 삭제

이미 발송된 상담톡 메시지를 삭제합니다. 삭제한 메시지는 복구할 수 없습니다.

POST/api/comm/v1/center/cstalk/chat/delete

이미 발송된 상담톡 메시지를 삭제합니다. 삭제한 메시지는 복구할 수 없습니다.

Body Parameters

{}JSON

cstalk

필수Object

상담톡 요청 객체입니다.

Returns

common

Object

공통 응답 영역입니다.

data

Object

상품 응답 영역입니다.

요청 예시

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

응답 예시

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}

상담 연결하기

PC/Mobile 페이지에서 상담 연결 버튼을 통해 상담을 요청할 수 있습니다.

PC에서 상담 연결 버튼을 통해 메타 정보를 전달하는 경우 요청 페이지는 새창 또는 팝업 형태로 호출해야 하며, 팝업의 최소 권장 사이즈는 1024 x 800입니다.

상담 연결 버튼 클릭 시 파트너사 페이지를 거쳐 카카오 로그인 페이지로 이동하는 경우, 파트너사 페이지 내에 아래 스크립트를 포함하면 권장 사이즈로 팝업창이 노출됩니다.

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

봇과 상담톡을 동시에 이용하는 프로필은 bot 파라미터를 이용해 봇 또는 상담톡으로 연결 방식을 제어할 수 있습니다.

버튼 연결 (POST)

POSThttps://bizmessage.kakao.com/chat/open
샌드박스로 테스트하기

카카오 상담 연결 URL을 POST 방식으로 직접 호출합니다. Content-Type은 application/x-www-form-urlencoded를 사용합니다.

Body Parameters

FORM-URLENCODED

uuid

필수String(40)

발신프로필키입니다. 카카오톡 채널 @아이디가 아니므로 주의해 주세요.

extra

String(1000)

상담톡 또는 봇 전환 시 사용자에게 전달할 메타 데이터입니다.

bot

String(5)

봇 연결은 true, 상담원 연결은 false(기본값), 유지 중인 세션 연결은 auto를 입력합니다.

event

String(100)

사용자가 봇으로 전환될 때 발생할 이벤트명입니다.

app_open_type

String

앱 실행 방식입니다. direct 또는 modal을 입력합니다.

Returns

redirect

Redirect

카카오톡 상담 연결 화면으로 이동합니다. 별도의 비즈고 API JSON 응답이 아닙니다.

요청 예시

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"

응답 예시

1카카오 상담 연결 URL 호출 후 카카오톡 상담 화면으로 이동합니다.
2비즈고 API JSON 응답이 아니라 카카오 URL 이동/응답으로 처리됩니다.

버튼 연결 (GET)

GEThttps://bizmessage.kakao.com/chat/open/{uuid}
샌드박스로 테스트하기

카카오 상담 연결 URL을 GET 방식으로 직접 호출합니다. uuid는 경로에 포함하고 나머지 값은 Query Parameter로 전달합니다.

Query Parameters

QUERY

uuid

필수String(40)

발신프로필키입니다. Path Parameter로 전달하며, 카카오톡 채널 @아이디가 아니므로 주의해 주세요.

extra

String(50)

상담톡 또는 봇 전환 시 사용자에게 전달할 메타 데이터입니다.

bot

String(5)

봇 연결은 true, 상담원 연결은 false(기본값), 유지 중인 세션 연결은 auto를 입력합니다.

event

String(100)

사용자가 봇으로 전환될 때 발생할 이벤트명입니다.

app_open_type

String

앱 실행 방식입니다. direct 또는 modal을 입력합니다.

Returns

redirect

Redirect

카카오톡 상담 연결 화면으로 이동합니다. 별도의 비즈고 API JSON 응답이 아닙니다.

요청 예시

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

응답 예시

1카카오 상담 연결 URL 호출 후 카카오톡 상담 화면으로 이동합니다.
2비즈고 API JSON 응답이 아니라 카카오 URL 이동/응답으로 처리됩니다.