카카오 상담톡 연동 문의

문의|Support
4

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

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

  1. reportCode (1000 vs 10000)
    정본(코드표·레퍼런스) 기준 10000이 맞습니다. 실수신값도 10000이므로 10000으로 보시면 되고, GitBook 본문 예시의 1000은 정본이 아닙니다. :folded_hands:

  2. 결과 웹훅 시각 필드명 (kakakoResCreatedAt)
    확인 결과 해당 필드명에 오타(kakako)가 있었습니다. 정상 필드명인 kakaoResCreatedAt로 수정해 반영할 예정입니다. 필드명이 변경되는 부분이라 반영 전 별도 공지드릴 예정이며, 그 전까지는 현재 내려가는 키(kakakoResCreatedAt) 기준으로 참고 부탁드립니다.

  3. committalCompany 필수 여부
    레퍼런스 기준 committalCompany는 "사전에 등록된 경우 생략 가능"입니다. 즉 위탁사명이 사전 등록되지 않은 상태에서는 필수이며, 받으신 A213은 사전 등록이 안 된 상태였기 때문입니다. 호출 시 committalCompany를 포함하시거나 사전 등록해 두시면 해결됩니다.

  4. 시스템메시지 등록 필드명
    등록 규격은 cstalk 객체 안에 messages(필수 배열) 구조가 정본입니다. systemMessages는 조회 응답에만 쓰이는 필드라 등록에 사용하면 A527이 나는 게 맞습니다. cstalk.messages로 보내주세요.

  5. 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은 샌드박스 환경 발신 대역이 맞고, 운영 대역과는 별개입니다. 운영 방화벽은 위 운영 목록 기준으로 설정 부탁드립니다.

  6. Sandbox 지원 범위
    샌드박스는 메시지 발송 및 수신 테스트 위주로 제공됩니다.
    발신프로필 조회 등 공통·조회 기능은 현재 샌드박스에서 지원하지 않아, 정상 발급된 senderKey라도 A821 또는 403이 발생할 수 있습니다. 해당 기능은 운영 환경에서 확인 부탁드립니다.

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