상담톡 이용 활성화 A821 및 채팅 기능 활성화 A502 오류 확인 요청

문의|Support
1

안녕하세요.

상담톡 활성화 및 채팅 기능 활성화 API 호출 중 오류가 발생하여 확인 요청드립니다.

계정 정보는 아래와 같습니다.

  • 회사명: 자라다
  1. 상담톡 이용 활성화 API 실패

Endpoint:
POST /api/comm/v1/center/cstalk/sender/activate

Request body:
{
“cstalk”: {
“senderKey”: “”,
“committalCompany”: “자라다”
}
}

Response:
{
“common”: {
“authCode”: “A000”,
“authResult”: “SUCCESS”,
“infobankTrId”: “M-260707220233445PRD71028”
},
“data”: {
“code”: “A821”,
“result”: “Requested data not found”
}
}

committalCompany를 생략하거나 빈 문자열로 보내도 동일하게 A821 오류가 발생했습니다.

  1. 채팅 기능 활성화 API 실패

Endpoint:
POST /api/comm/v1/center/cstalk/sender/chat/activate

Request body:
{
“cstalk”: {
“senderKey”: “”
}
}

Response:
{
“common”: {
“authCode”: “A000”,
“authResult”: “SUCCESS”,
“infobankTrId”: “M-260707215821029PRD65506”
},
“data”: {
“code”: “A502”,
“result”: “Invalid or empty ‘senderKey’”
}
}

API 인증은 authCode A000 / SUCCESS로 성공하고 있습니다.
따라서 API key 인증 문제나 cstalk 필드 누락 문제는 아닌 것으로 보입니다.

확인 요청드립니다.

  1. 해당 senderKey가 현재 사용 중인 Mars API key 계정에 정상 매핑되어 있는지
  2. 영업담당자를 통해 등록 요청된 통합키와 현재 Authorization에 사용하는 통합키가 동일한지
  3. 해당 senderKey가 상담톡 이용 활성화 대상/registry에 등록되어 있는지
  4. 해당 senderKey에 상담톡 발신 권한 및 채팅 기능 활성화 권한이 부여되어 있는지
  5. Webhook 수신 도메인이 정상 등록되어 있는지

현재는 순서상 먼저 필요한 상담톡 이용 활성화 단계부터 A821로 실패하고 있어,
우선 해당 senderKey와 통합 API key 매핑 및 상담톡 registry 등록 상태 확인을 부탁드립니다.

참고용 실패 infobankTrId 목록

  1. 상담톡 이용 활성화
  • committalCompany 생략: M-260707220233212PRD55213
  • committalCompany 빈 문자열: M-260707220233337PRD71027
  • committalCompany “자라다”: M-260707220233445PRD71028
  • 이전 호출: M-260707215604649PRD64180
  • 이전 호출: M-260707215729580PRD65004
  1. 채팅 기능 활성화
  • M-260707215821029PRD65506
  • M-260707215729215PRD67507
  1. 발신프로필 조회
  • M-260707215729905PRD65007
2

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

해당 커뮤니티 채널은 오픈된 채널로써
작성해주신 내용중 외부노출로 보안위험이 있는 부분은 삭제하여 등록하였습니다.
참고 부탁드리며,

문의하신 내역에 대한 답변을 위하여 내부 확인 후 추가 답변을 드리도록 하겠습니다.

최대한 빠른 안내를 드릴 예정이나 내부 상황에 따라 답변이 지연될 수 있는 점 양해 부탁드립니다.

감사합니다.

3

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

전달주신 infobankTrId 기준으로 요청 내역을 확인했으며, 두 건 모두 원인이 확인되어 안내드립니다.

1. 상담톡 이용 활성화 API — A821 (Requested data not found)

사용하고 계신 발신프로필키는 샌드박스(CBT) 환경용 발신프로필키로 확인됩니다. 현재는 운영 환경 도메인(https://mars.ibapi.kr)으로 호출하고 계셔서, 운영 환경에서는 해당 발신프로필을 인식하지 못해 A821 오류가 발생하고 있습니다. committalCompany 값과는 무관한 문제이니 해당 부분은 신경 쓰지 않으셔도 됩니다.

2. 채팅 기능 활성화 API — A502 (Invalid or empty ‘senderKey’)

요청 내역 확인 결과, 위와 동일한 내용으로 확인됩니다.

조치 방법

두 API 모두 아래의 샌드박스 환경 도메인으로 요청해 주시기 바랍니다.

  • 샌드박스 환경: https://sandbox-mars.ibapi.kr

샌드박스 도메인으로 변경하시고, 등록 요청 주셨던 발신프로필키로 상담톡 이용 활성화 → 채팅 기능 활성화 순서대로 호출해 주시면 정상 처리되실 것으로 보입니다.

진행 후에도 오류가 발생하면 infobankTrId와 함께 다시 말씀 부탁드립니다. 감사합니다!

4

혹시 웹훅 url을 변경할 수 있는곳은 어디인가요?

지금 잘못된 주소로 들어오고 있어서 url 변경을 요청드리려고 합니다.
상담톡 Webhook URL 변경 위치를 확인하고 싶어 문의드립니다.

현재 저희 서버 로그를 확인해보니 Bizgo에서 아래와 같은 URL로 Webhook 요청이 들어오고 있습니다.

현재 등록된 Webhook URL에 이미 /cstalk/message가 포함되어 있고,
Bizgo에서 이벤트 suffix인 /cstalk/message를 한 번 더 붙여 호출하는 것으로 보입니다.

현재 잘못 등록된 것으로 보이는 URL:

https://chat.zaradacrm.com/webhooks/kakao_talk/{sender_key}/cstalk/message

변경 요청 URL:

https://chat.zaradacrm.com/webhooks/kakao_talk/{sender_key}

+ 추가적으로 유저 정보를 가져올 수 있는 API가 있을까요?

고객명이 웹훅으로 전송되지 않아서 여쭤봅니다.

5

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

1. Webhook URL 변경 관련

Webhook URL을 직접 변경하실 수 있는 페이지는 현재 별도로 제공하고 있지 않습니다. 변경이 필요하신 경우 영업 담당자님이나, 커뮤니티 또는 제 프로필을 통해 요청 주시면 도와드리겠습니다.

말씀 주신 내용 확인하여, 요청하신 주소로 Webhook URL 변경 완료했습니다.

  • 변경된 URL: https://chat.zaradacrm.com/webhooks/kakao_talk/{sender_key}

참고로 SANDBOX 환경의 경우 계정 동기화까지 1시간 정도 소요될 수 있으니, 변경 사항 반영까지 잠시 기다려 주시기 바랍니다.

2. 유저 정보 조회 API 관련

고객명 등 유저 정보를 조회할 수 있는 별도 API는 현재 카카오에서 제공하는 규격이 없어 지원되지 않는 점 양해 부탁드립니다.

다만 웹훅 이벤트 중 /reference 수신을 통해 상담을 요청한 사용자의 정보를 전달받으실 수 있으니, 해당 이벤트를 활용해 보시길 권장드립니다.

추가로 문의하실 내용 있으시면 언제든지 말씀 부탁드립니다. 감사합니다!