카카오 상담톡 연동 문의

kksbell · 7월 21, 2026, 2:31오전

**** (Sandbox 테스트 중)

전송 결과 reportCode 표기 불일치**
상담톡 전송결과(/cstalk/result) 페이지에는 성공 코드가 1000으로, 통합 코드표에는 10000으로 나옵니다. 실제 수신값은 10000이었는데, 어느 쪽이 정확한가요?

2. 결과 Webhook 응답 필드
성공 리포트에 reportText가 없고 kakakoResCreatedAt 필드가 포함되어 옵니다.

- reportText는 실패 시에만 오나요?

- kakakoResCreatedAt는 오타로 보이는데(정상은 kakao), 필드명이 확정된 것인지 / 항상 포함되는지?

3. 상담톡 활성화 committalCompany
문서에는 선택 파라미터인데, 없이 호출하면 A213(위탁사명 필수)이 납니다. 필수가 맞나요?

4. 시스템메시지 등록 필드명
문서 예시는 systemMessages인데 그대로 보내면 A527이 나고, messages로 보내야 통과했습니다. 필드명이 messages가 맞나요?

5. Webhook 발신 IP 대역
문서 안내 IP(211.115.98.154/155/205 등)에 없는 211.115.98.231에서 웹훅이 수신됐습니다. 방화벽 허용은 211.115.98.0/24 대역 전체로 잡아야 하나요? 발신 IP 전체 목록이 있을까요?

6. Sandbox 지원 범위
Sandbox에서 아래 두 API가 실패합니다. Sandbox 미지원인가요, 아니면 다른 원인인가요?

챗봇 대화내역 조회 → 403
발신프로필 조회(/v1/center/kakao/sender) → A821(정상 발급 키인데도 not found)

mira · 7월 21, 2026, 7:17오전

안녕하세요 비즈고를 이용해주셔서 감사합니다

답변을 드리기 앞서 확인해야되는 사항이 있어 질문드립니다.
현재 참고하시는 페이지가 어디 페이지인지 링크 요청 드려도 될까요?

확인부탁드립니다.
감사합니다.

kksbell · 7월 21, 2026, 8:02오전

1. 전송 결과 reportCode 표기 불일치 (1000 vs 10000)

1000 표기 확인 위치: https://infobank-guide.gitbook.io/omni-api-v2/comm/kakao/cstalk/chat-recv/result (전송 요청 결과 — 본문 예시)
10000 표기 확인 위치: https://infobank-guide.gitbook.io/omni-api-v2/comm/code (리포트 코드 표) 및 https://developers.bizgo.io/api-sdk/code
실제 Sandbox 수신값은 10000이었습니다.

2. 결과 Webhook 응답 필드 (reportText 부재 / kakakoResCreatedAt)

참고 페이지: https://infobank-guide.gitbook.io/omni-api-v2/comm/kakao/cstalk/chat-recv/result (필드 정의 표)
문서의 필드 표와 달리, 실수신(성공 건)에는 reportText가 없고 kakakoResCreatedAt가 포함되어 있었습니다.

3. 상담톡 활성화 committalCompany 필수 여부

참고 페이지: https://infobank-guide.gitbook.io/omni-api-v2/comm/kakao/cstalk/management/cstalk-active (상담톡 이용여부 관리)
문서상 선택으로 읽히나, 미포함 호출 시 A213 "상담톡을 사용하기 위해서는 반드시 위탁사명을 입력해야 합니다" 응답을 받았습니다.

4. 시스템메시지 등록 필드명 (systemMessages vs messages)

참고 페이지: https://infobank-guide.gitbook.io/omni-api-v2/comm/kakao/cstalk/management/system-message (시스템 메시지 관리 — 등록 요청 예시)
문서 예시의 systemMessages로 보내면 A527 Invalid or empty 'messages', messages로 보내면 통과했습니다.

5. Webhook 발신 IP 대역

참고 페이지: https://infobank-guide.gitbook.io/omni-api-v2/comm/kakao/cstalk/chat-recv/message (사용자 메시지 수신 — 방화벽 허용 IP 목록: 211.115.98.154 / .155 / .205, 3.37.214.83, 3.39.75.204, 43.200.251.230)
실제 수신은 목록에 없는 211.115.98.231에서 왔습니다 (User-Agent: ReactorNetty/1.1.20).

6. Sandbox 지원 범위

챗봇 대화내역 조회 참고 페이지: https://infobank-guide.gitbook.io/omni-api-v2/comm/kakao/cstalk/management/history → Sandbox 호출 시 HTTP 403
발신프로필 조회 참고 페이지: https://developers.bizgo.io/api-sdk/api-reference/comm/kakao-common (발신프로필 정보 조회 GET /v1/center/kakao/sender) → 정상 발급 senderKey인데도 A821 Requested data not found
Sandbox 안내 참고 페이지: https://infobank-guide.gitbook.io/omni-api-v2/base-uri

참고로 GitBook 가이드를 주로 참조했고, developers 레퍼런스와 교차 확인했습니다. 두 문서 간 또는 문서-실서버 간 차이가 있는 항목들이라, 어느 쪽이 정본인지 확인 부탁드립니다.

mira · 7월 21, 2026, 8:49오전

안녕하세요! 꼼꼼하게 확인해 주셔서 감사합니다. 항목별로 정리해 안내드립니다.

먼저, 문서 정본은 developers 레퍼런스(developers.bizgo.io)입니다. 이쪽을 기준으로 규격서를 지속 업데이트하고 있으며, GitBook 가이드와 다를 경우 레퍼런스를 기준으로 구현해 주세요.

reportCode (1000 vs 10000)
정본(코드표·레퍼런스) 기준 10000이 맞습니다. 실수신값도 10000이므로 10000으로 보시면 되고, GitBook 본문 예시의 1000은 정본이 아닙니다.
결과 웹훅 시각 필드명 (kakakoResCreatedAt)
확인 결과 해당 필드명에 오타(kakako)가 있었습니다. 정상 필드명인 kakaoResCreatedAt로 수정해 반영할 예정입니다. 필드명이 변경되는 부분이라 반영 전 별도 공지드릴 예정이며, 그 전까지는 현재 내려가는 키(kakakoResCreatedAt) 기준으로 참고 부탁드립니다.
committalCompany 필수 여부
레퍼런스 기준 committalCompany는 "사전에 등록된 경우 생략 가능"입니다. 즉 위탁사명이 사전 등록되지 않은 상태에서는 필수이며, 받으신 A213은 사전 등록이 안 된 상태였기 때문입니다. 호출 시 committalCompany를 포함하시거나 사전 등록해 두시면 해결됩니다.
시스템메시지 등록 필드명
등록 규격은 cstalk 객체 안에 messages(필수 배열) 구조가 정본입니다. systemMessages는 조회 응답에만 쓰이는 필드라 등록에 사용하면 A527이 나는 게 맞습니다. cstalk.messages로 보내주세요.
Webhook 발신 IP
환경별 허용 IP는 아래와 같습니다.
[운영 환경]
· 요청 방향(고객 서버 → 비즈고 API, PORT 443): 3.35.80.15, 43.203.83.174, 54.116.59.12
· 수신 방향(비즈고 Webhook → 고객 서버): 3.37.214.83, 3.39.75.204, 43.200.251.230, 211.115.98.154, 211.115.98.155, 211.115.98.205
[Sandbox 환경]
· 요청/수신 방향 모두: 211.115.98.231
테스트 중 확인하신 211.115.98.231은 샌드박스 환경 발신 대역이 맞고, 운영 대역과는 별개입니다. 운영 방화벽은 위 운영 목록 기준으로 설정 부탁드립니다.
Sandbox 지원 범위
샌드박스는 메시지 발송 및 수신 테스트 위주로 제공됩니다.
발신프로필 조회 등 공통·조회 기능은 현재 샌드박스에서 지원하지 않아, 정상 발급된 senderKey라도 A821 또는 403이 발생할 수 있습니다. 해당 기능은 운영 환경에서 확인 부탁드립니다.

좋은 리포트 다시 한번 감사드리며, 추가로 궁금하신 점 있으시면 편하게 남겨주세요!

kksbell · 7월 22, 2026, 4:03오전

안녕하세요.

문의 내용이 많았는데 빠르고 친절한 답변 감사합니다.

kksbell · 7월 22, 2026, 5:05오전

[문의] 상담톡 첨부파일 보관 기간 확인 요청

추가로 상담톡 첨부파일(사진/파일) 관련 아래 3가지 문의 드립니다.

고객 발신 첨부(수신): 고객이 상담톡으로 보낸 사진/파일은 talk.kakaocdn.net의 서명 URL(expires 포함)로 웹훅에 전달되는데, URL 유효기간이 약 21일로 보입니다. 공식 보관/유효 기간이 어떻게 되는지, 만료 후 동일 파일의 URL 재발급이 가능한지 확인 부탁드립니다.
기업 발신 첨부(발신): 파일 업로드 API(POST /v1/file/cstalk, /v1/file/cstalk/image)로 업로드한 파일(mud-kage.kakao.com URL)의 보관 기간과, 업로드 후 발송 가능 유효 기간(문서상 별도 명시가 없음)을 확인 부탁드립니다.
위 보관 기간 경과 후 파일이 삭제되는지, 삭제 전 별도 정책(연장 등)이 있는지 확인 부탁드립니다.

mira · 7월 22, 2026, 5:26오전

안녕하세요! 상담톡 첨부파일 보관 정책 관련 문의 주신 3가지 정리해 안내드립니다.

먼저 파일 종류별 보관 기간은 아래와 같습니다.
· 채팅에서 주고받은 이미지/동영상: 21일
· 일반 파일: 15일
· 템플릿으로 사용되는 이미지: 별도 보관 기간 없이 영구 보관

고객 발신 첨부(수신)
고객이 상담톡으로 보낸 이미지/동영상은 21일, 일반 파일은 15일간 보관됩니다. 관측하신 약 21일은 이미지/동영상 기준과 일치합니다. 서명 URL의 유효기간도 이 보관 기간과 연동되며, 보관 기간이 지나면 파일이 삭제되어 동일 파일의 URL 재발급은 어렵습니다. 따라서 보관 기간 내에 다운로드해 보관하시는 것을 권장드립니다.
기업 발신 첨부(발신)
업로드 API로 올리신 파일도 동일 정책이 적용됩니다. 이미지(/v1/file/cstalk/image)는 21일, 일반 파일(/v1/file/cstalk)은 15일 보관되며, 해당 기간 내에 발송하셔야 합니다.
즉 보관 기간이 곧 발송 가능 유효 기간이 되며, 경과 시 삭제됩니다.
보관 기간 경과 후 정책
보관 기간이 지나면 파일은 삭제됩니다. 템플릿으로 사용되는 이미지만 예외적으로 영구 보관되며, 그 외 파일에 대한 별도 연장 정책은 없습니다. 반복 사용이 필요한 이미지는 템플릿 등록을 활용하시는 방법도 있습니다.

추가로 궁금하신 점 있으시면 편하게 남겨주세요!

kksbell · 7월 22, 2026, 8:55오전

안녕하세요.

빠르고 친절한 답변 감사합니다.