상담톡 api 스펙 문의

문의|Support
1

안녕하세요. 개발 진행 중 문서에 적힌 스펙과 상이한 부분이 확인되어 확인차 문의드립니다.

읽음 확인 웹훅 건

샌드박스에서 읽음 확인(seen_info) 콜백 콜백이 수신되고 있지 않은 것으로 확인됩니다.

혹시 샌드박스 환경에서는 해당 콜백이 구현되어 있지 않은 것인지 궁금합니다.

개인정보 수신 웹훅 phone_number 건

1. 위 개발 문서에서 personal_info 웹훅 경로 중 phone_number만 snake case로 명시되어 있습니다. 샌드박스에서 테스트 해본 결과 phoneNumber로 camel case로 오기는 하는데, 프로덕션에서도 동일하게 phoneNumber로 오는 것이 맞을지 확인 요청드립니다.

2. 전화번호가 예시에서는 010… 형식으로 되어 있는데, 실제로 샌드박스에서 수신된 내용은 +8210으로 되어 있습니다. 이 또한 프로덕션에서 동일하게 +8210으로 오는 것이 맞을지 확인 요청드립니다.

웹훅 Type 누락 건

아래 필드들이 API 문서와 다르게 수신되고 있습니다. 프로덕션에서도 API 문서대로 개발하여야 할지 아니면 실제로 샌드박스로부터 수신되는 사양으로 개발을 진행하면 될지 확인 요청드립니다.

가. reference 웹훅

  • 예상
    • msgType: “REFERENCE”
  • 실제
    • 필드 없음

나. expired_session 웹훅

  • 예상
    • “msgType”:“SESSION”
  • 실제
    • (필드 없음)

다. personal_info 웹훅

  • 예상
    • serviceType: “CSTALK”
    • msgType: “PERSONAL”
  • 실제
    • (필드 없음)

감사합니다.

2

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

문의 주신 3건 확인하여 회신드립니다. 확인 과정에서 문서와 실제 사양이 다른 부분이 여러 건 발견되어, 이용에 혼선을 드린 점 먼저 양해 부탁드립니다.

1. 읽음 확인(seen_info) 웹훅 지연

해당 웹훅은 카카오에서 실시간으로 내려주는 정보가 아니어서 전달까지 다소 시간이 소요될 수 있습니다. 카카오 측에서도 아래와 같이 안내하고 있으니 참고 부탁드립니다.

실시간으로 확인하는 정보가 아니기 때문에, 사용자가 채팅방을 열어 읽음 처리를 하였더라도 수신 도메인으로 전달되기까지 다소 시간이 걸릴 수 있습니다.

2. 개인정보 수신 웹훅

  • 필드명 phoneNumber (camelCase): 실제 전달되는 필드명이 맞으며, 프로덕션도 동일합니다. 규격서 표기가 잘못되어 수정하겠습니다.
  • 전화번호 형식: 당사에서는 전화번호 값을 별도로 가공하지 않고 카카오에서 받은 값을 그대로 전달드리고 있습니다. 현재 확인되는 값은 +8210… (E.164) 형식이며, 프로덕션에서도 동일합니다. 문서의 010… 예시는 부정확하여 함께 정정하겠습니다.

3. 웹훅 Type 필드 누락

세 건 모두 실제 수신되는 사양이 맞고 문서가 부정확한 경우이며, 프로덕션도 샌드박스와 동일하게 동작합니다.

  • reference 웹훅: msgType은 발송 메시지의 타입을 나타내는 필드이므로, 해당 웹훅에는 포함되지 않는 것이 맞습니다. 문서를 수정하겠습니다.
  • expired_session 웹훅: 위와 동일합니다.
  • personal_info 웹훅: serviceType은 전달되는 것이 맞아 추가 예정이며, msgType은 result/message 웹훅만 수신되는 타입으로 문서 수정하도록 하겠습니다.

세심하게 확인해 주신 덕분에 문서상 오류를 함께 정리할 수 있었습니다. 감사합니다 :folded_hands:
추가로 확인이 필요한 사항 있으시면 편하게 말씀 주세요!