카카오 상담톡 웹훅

---

Introduce

카카오 상담톡 웹훅은 자체 구축한 시스템에서 해피톡을 통한 카카오 상담톡을 사용시에 카카오 상담톡 웹훅에 대한 정보가 작성된 문서입니다.

API HOST

Division	HOST URL
개발	https://patch-kakao-api.happytalk.io
운영	https://kakao-api.happytalk.io

Auth Key Description

인증키 발급 방법

고객센터에서 발급 받은 HT-Client-Id값과 HT-Client-Secret값을 Header Parameter에 담아 인증 합니다.

API List

• 발신 프로필 :
  • 조회
  • 수정 :
    • 1대1 채팅 활성화
    • 1대1 채팅 비활성화
    • 수신 도메인 등록 및 수정
    • 수신 도메인 조회
• 상담 :
  • 버튼을 통한 상담 시작
  • 메시지 전송
  • 상담방 종료
  • 사용자 차단
  • 사용자 차단 해제
• 상담 정보 수신 :
  • 메타 정보 수신
  • 상담 메시지 수신
  • 세션 종료 정보 수신
• 파일 업로드 :
  • 이미지 업로드
  • 파일 업로드

Change History

History

2022

2022.08.20

최초 작성

2022.10.12

1. 전 페이지 내용 수정 및 구조 수정
    - API 문서 기준 규격 적용
    - 잘못된 내용 수정
    - UI 디자인 미반영 페이지 반영

2023

2023.01.25

1. 메시지 전송 API 문서 수정
    - 잘못된 내용 수정
    - 예시 추가

2023.02.22

1. 메시지 전송 API 문서 수정
    - 이미지 또는 파일 발송시 필독 사항 추가

2023.04.06

1. 카카오 상담톡 수신 API 스펙 변경에 따른 "카카오 상담톡 웹훅 API" 정보 수정
    - 상담 메시지 수신 문서 수정
      - Response Parameter에 "contents" 필드 추가

2023.05.11

1. 카카오 상담톡 메시지 전송 API request 예제 추가
    - 메시지 전송 API request 예제 추가
      - 파일 전송 예제 추가

2024

2024.01.31

1. 카카오 상담톡 웹훅 문서 수정
    - 전체 페이지 Request Parameter type 길이 정의
    - 메시지 전송 문서 내용 추가
      - supplement 내용 추가
      - Data Dictionary 내용 변경 및 추가
        - links_button_type 비즈폼 관련 내용 추가
        - supplement 내용 추가
        - quick_reply_type 내용 추가
      - 바로 연결 예시 추가
2. 카카오 상담톡 웹훅 문서 추가
    - 비즈폼 업로드 문서 추가

2025

2025.01.14

1. 카카오 상담톡 웹훅 문서 수정
    - 참조 문서 > API 코드 정의
     - 센터 API 응답 코드 최신화
    - 상담 정보 수신 > 상담 메시지 수신 > Sample 최신화
     - 이미지 수신 예시 최신화