상담톡 「상담원 읽음 처리」 api 문의 — 답장 전에 고객 카톡의 '1'을 지우는 방법이 있나요?

안녕하세요. 상담톡을 자사 CRM과 API로 직접 연동해 쓰고 있습니다(웹훅 /cstalk/message·seen_info 등 등록, 발송 /api/comm/v1/cstalk/plain).

고객이 보낸 상담톡 메시지를 상담원이 CRM에서 읽어도 고객 카카오톡에는 ‘1’(안 읽음)이 그대로 남고, 저희가 답장을 보내야만 사라집니다.

이용문의로 여쭈었더니 「개발자센터의 읽음 정보 수신 API를 이용하면 답장 전에도 읽음 처리할 수 있다」는 답을 받았는데, 문서상 「읽음 정보 수신」(POST {고객 Webhook URL}/cstalk/seen_info)은 비즈고→고객사 웹훅(고객이 저희 메시지를 읽었다는 통보 · 세션 중·24시간 내·지연 있음 · 카카오 비즈니스 라운지 별도 신청)이고, 저희가 호출하는 API는 아닌 것으로 이해했습니다.

질문

  1. 「상담원이 읽었다」를 카카오에 전달해 고객 카톡의 '1’을 지우는 호출 API가 있습니까? 있다면 Method·URL·Body(userKey·senderKey·msgKey 등)와 샌드박스 지원 여부를 알려주세요.
  2. 없다면 카카오 상담톡 규격상 제공이 불가능한 것인지, 아니면 비즈고에서 추가 제공 계획이 있는지 궁금합니다.
  3. 현재 구조에서는 상담원 메시지 발송 시점에만 고객 쪽 '1’이 지워지는 것이 맞는지 확인 부탁드립니다.

감사합니다.

안녕하세요, 비즈고입니다 :blush:
상담톡 연동 구조와 질문을 꼼꼼하게 정리해 주셔서 감사합니다.

먼저 이전 이용문의에서 「읽음 정보 수신 API」로 안내드린 부분은 정확하지 않은 답변이었습니다. 혼란을 드려 죄송합니다 :folded_hands:
이해하신 대로 「읽음 정보 수신」(/cstalk/seen_info)은 고객이 상담원 메시지를 읽었을 때 고객사로 알려 드리는 웹훅입니다. 상담원이 고객 메시지를 읽었다는 것을 고객 카카오톡에 반영하는 기능이 아닙니다.

1. 고객 카톡의 ‘1’을 지우는 호출 API가 있나요?
현재 비즈고에는 해당 API가 없습니다.

2. 카카오 규격상 불가능한가요, 아니면 추가 계획이 있나요?
카카오에서 2026년 10월 2일부터 ‘상담 메시지 읽음 처리 API’ 를 새로 제공하기 시작했습니다. 이 API를 이용하면 답장을 보내기 전에도 고객 메시지를 읽음 처리할 수 있습니다.
비즈고도 이 기능을 지원하기 위해 준비하고 있습니다 :hammer_and_wrench: 제공 일정과 Method·URL·Body 규격, 샌드박스 지원 여부는 확정되는 대로 개발자센터 공지로 바로 안내드리겠습니다.

참고로, 카카오가 안내한 동작 방식은 다음과 같습니다.

  • 호출하면 그 시점까지 받은 고객 메시지의 ‘1’이 사라집니다. 고객 화면에는 ‘읽음’ 같은 별도 문구가 표시되지 않습니다.
  • 진행 중인 상담 세션이 있을 때만 호출할 수 있습니다.
  • 호출한 뒤에 고객이 보낸 메시지는 다시 ‘1’로 표시되므로, 필요하면 다시 호출하셔야 합니다.
  • 상담원이 메시지를 보내면 자동으로 읽음 처리되므로, 발송 직전에 따로 호출하실 필요는 없습니다.

3. 지금은 상담원 메시지를 보낼 때만 ‘1’이 지워지는 게 맞나요?
네, 맞습니다 :+1: 현재 비즈고 구조에서는 아래 두 경우에만 고객 쪽 ‘1’이 지워집니다.

  • 상담원 메시지를 보낼 때: 그 이전 고객 메시지 전체가 읽음 처리됩니다.
  • 상담 세션이 종료될 때: 모든 메시지가 읽음 처리됩니다.

기능이 제공되면 가장 먼저 안내드릴게요. 더 궁금하신 점이 있으면 편하게 문의해 주세요.
감사합니다.