BlueTalk 개발자 센터 > BlueTalk::블루톡 무료 실시간 채팅 위젯 · 1:1 DM

BlueTalk 개발자 센터 > BlueTalk::블루톡 무료 실시간 채팅 위젯 · 1:1 DM · 웹 채팅 연동

BlueTalk 개발자 센터 API 문서 · 이벤트 포맷 · 연동 예제를 한 곳에서

이 개발자 센터에서는 BlueTalk(블루톡)를 웹사이트에 연동하기 위한 API 구조, 인증 방식, WebSocket 이벤트, REST 엔드포인트, 에러 코드를 정리합니다.
처음 오셨다면 아래 순서대로 문서를 읽어 보시는 것을 추천합니다.

시작하기 전에

BlueTalk 개발 문서는 크게 두 축으로 나뉩니다.

① 설치·연동 가이드
실제 사이트에서 블루톡을 “어디에, 어떻게 코드 넣을지”에 대한 문서입니다.
(빠른 시작, 그누보드/아미나 연동, 기타 언어 연동 등)
② API 레퍼런스
블루톡 서버가 제공하는 WebSocket 이벤트, REST API, 에러 코드 등 보다 기술적인 내용을 다룹니다.

API 문서 목록

API 개요
BlueTalk의 전체 구조(REST + WebSocket + JS SDK)를 한눈에 정리한 문서입니다.
인증 구조 (site_key / user_key / 도메인)
site_key 발급, 도메인 1:1 매칭, user_id와 user_key를 어떻게 생성하고 검증하는지 설명합니다.

WebSocket 이벤트 목록
connect, chat:message, dm:message, channel:join, presence:update 등 실시간 이벤트와 JSON 포맷을 정리합니다.
REST API 엔드포인트
/auth/verify, /files/upload 등 HTTP 기반 API의 경로, 파라미터, 응답 예시를 설명합니다.
에러 코드 · 응답 포맷
공통 에러 응답 형식과 주요 에러 코드(예: INVALID_SITE_KEY, DOMAIN_MISMATCH)를 정리합니다.