Biz API 소개 및 사용법

Introduce

Biz API 는 자체 구축 챗봇을 가지고 있는 업체에서 채팅 상담을 사용하기 위하여 해피톡에서
제공하는 API 리스트 입니다. 방생성, 메세지 발신, 상담종료, 메세지 수신 등의 기능이 있습니다.

API HOST

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

Auth Key Description

인증키 발급 방법

디벨로퍼 센터에서 제공하는 API 이용을 위해서는 인증키 등의 정보가 필요하며, 해당 인증 정보는 사용 목적 확인 및 조건 협의 후 제공됩니다. 자세한 내용은 고객센터로 문의해주세요.

API List

상담
상담 정보 수신
- 상담방 종료 정보 수신
- 메시지 수신

Change History

History

2022

2022.08.20

최초 작성

2022.09.26

1. 전 페이지 내용 수정 및 구조 수정
    - API 문서 기준 규격 적용
    - 잘못된 내용 수정

2023

2023.03.23

1. Biz-API API 스펙 변경에 따른 문서 내용 수정
    - 상담방 생성 파라미터 정보 변경
        - is_room_create_force 파라미터 정보 추가
    - 상담 종료 파라미터 정보 추가
        - end_type 파라미터 정보 추가
    - 메시지 수신 문서 생성
    - 방종료 수신 문서 생성
    - 상담 가능/불가 상담원 인원수 문서 생성
    - 상담 대기 상담방 개수 문서 생성

2023.06.01

1. Biz-API 메시지 수신 문서 Example 수정
    - 메시지 수신 Example 상황별 데이터 수정

2024

2024.07.03

1. Biz-API 문서 수정
    - 상담 정보 수신 > 메시지 수신
     - API URL 정보 수정
    - 상담 정보 수신 > 상담방 종료 정보 수신
     - API URL 정보 수정

2025

2025.12.09

1. 신규 템플릿 추가, normal 메시지 필드 추가 관련 문서 수정
    - 2025-12-09 공지사항 페이지 추가 (V1/V2 템플릿 정책 안내)
    - Biz API > 상담 정보 수신 > 메시지 수신 문서 수정
        - template 타입 지원 메시지 예시 추가

2026

2026.01.26

1. Biz API > 기본 정보 Auth Key Description 교체