안녕하세요. 비즈고 상담톡 v3 Sandbox 웹훅 연동과 관련하여 문의드립니다.
Sandbox 환경에서 텍스트, 이미지, 파일 메시지를 각각 전송하여 /cstalk/message 웹훅의 실제 payload를 확인했습니다.
세 요청 모두 저희 서버까지 정상 도달했으나, 공식 문서상 필수 필드로 안내된 msgType이 포함되지 않았습니다. 또한 contents 구조가 메시지 종류에 따라 서로 다르게 전달되고 있어 정확한 계약 확인을 부탁드립니다.
확인된 요청 정보는 아래와 같습니다.
텍스트 메시지
-
수신 시각: 2026-06-26 17:52:48 KST
-
msgKey:
20260626~ -
serviceType:
CSTALK -
requestType:
message -
senderKey:
senderKey 존재 확인
실제 수신 payload:
{
"msgKey": "20260626\~",
"requestType": "message",
"serviceType": "CSTALK",
"senderKey": "senderKey 정상",
"userKey": "userKey 정상",
"reportTime": "2026-06-26T17:52:53.828+09:00",
"sendTime": "2026-06-26T17:52:48.769+09:00",
"contents": \[
"테스트"
\],
"kakaoTime": "2026-06-26T17:52:48.747+09:00"
}
이미지 메시지
이미지 메시지는 contents가 url, comment를 가진 객체 배열로 전달됐으며 마찬가지로 msgType은 없었습니다.
실제 수신 payload:
{
"msgKey": "20260629~",
"requestType": "message",
"serviceType": "CSTALK",
"senderKey": "senderKey 정상",
"userKey": "userKey 정상",
"sendTime": "2026-06-29T11:41:18.933+09:00",
"reportTime": "2026-06-29T11:41:18.935+09:00",
"kakaoTime": "2026-06-29T11:41:18.915+09:00",
"contents": [
{
"url": "https://talk.kakaocdn.net/.../~.jpg?...",
"comment": ""
}
]
}
파일 메시지
파일 메시지도 이미지와 동일하게 url, comment 객체 배열로 전달됐습니다. 별도의 파일명, 파일 크기, MIME 타입 및 msgType은 포함되지 않았으며 URL 확장자만 .pdf로 확인됐습니다.
실제 수신 payload:
{
"msgKey": "20260629~",
"requestType": "message",
"serviceType": "CSTALK",
"senderKey": "senderKey 정상",
"userKey": "userKey 정상",
"sendTime": "2026-06-29T11:42:52.005+09:00",
"reportTime": "2026-06-29T11:42:52.007+09:00",
"kakaoTime": "2026-06-29T11:42:51.984+09:00",
"contents": [
{
"url": "https://talk.kakaocdn.net/.../~.pdf?...",
"comment": ""
}
]
}
======
공식 문서상 /cstalk/message의 msgType은 필수 필드로 안내되어 있지만, 실제 Sandbox 요청에는 해당 필드가 포함되지 않았습니다.
-
Bizgo Developers:
https://developers.bizgo.io/api-sdk/api-reference/comm/kakao-counsel#%EC%82%AC%EC%9A%A9%EC%9E%90-%EB%A9%94%EC%8B%9C%EC%A7%80-%EC%88%98%EC%8B%A0 -
비즈고 API 개발가이드:
https://infobank-guide.gitbook.io/omni_api/comm/kakao/cstalk/chat-recv/message
======
번거로우시겠지만 아래 사항을 확인 부탁드립니다.
-
Sandbox 상담톡 v3
/cstalk/message에서msgType이 누락되는 것이 현재 정상 규격인지 -
운영 환경에서도
msgType이 동일하게 누락될 수 있는지 -
msgType이 없을 경우 텍스트·이미지·파일 등의 메시지 유형을 어떤 필드로 판별해야 하는지 -
문서에는
contents가 Object Array로 안내되어 있는데, 텍스트 메시지는 실제처럼 문자열 배열(["테스트"])로 전달되는 것이 맞는지. 텍스트 메시지의contents가 문자열 배열로 전달되는 것이 정상인지 -
가능하시다면 텍스트·이미지·파일·동영상·오디오 별 공식 실제 payload 예시를 제공받을 수 있는지 궁금합니다. 이미지·파일 메시지의
contents는 항상{url, comment}객체 배열로 전달되는지도 부탁드립니다. -
파일명, 파일 크기 및 MIME 타입을 제공받을 수 있는 별도 필드가 있는지
참고로 /reference, /expired_session, /result 웹훅은 동일한 Sandbox 환경에서 정상 수신 및 HTTP 200 응답을 확인했습니다.
감사합니다.
