실시간 웹 채팅 플랫폼 BlueTalk
BlueTalk(블루톡)은 그누보드·아미나 빌더를 포함한 어떤 웹사이트에도 간단한 스크립트 몇 줄만으로 붙여 쓸 수 있는 무료 실시간 웹 채팅 플랫폼입니다.
전체 채팅, 1:1 DM, 채널 채팅, 이미지·파일 전송, 운영자 권한 관리까지 모두 지원하며, 서비스 목적이나 사이트 규모에 상관 없이 자유롭게 사용할 수 있습니다.
BlueTalk는 웹사이트 어디에든 쉽게 붙일 수 있는 임베디드 채팅 솔루션입니다.
- 실시간 전체 채팅(글로벌 채널)
- 개별 방/채널 채팅
- 1:1 DM (쪽지처럼 사용하는 실시간 대화)
- 이미지, 파일 첨부 및 보기
- 운영자·관리자 제재 기능 (채팅금지, 채널생성 금지 등)
특히 그누보드/아미나 빌더와 잘 어울리도록 설계되어 있지만, PHP, Node, Python 등 어떤 백엔드 스택과도 연동할 수 있도록 API와 구조를 깔끔하게 분리해두었습니다.
BlueTalk는 크게 다음 3가지 요소로 이루어져 있습니다.
-
자바스크립트 위젯 (bluetalk.js)
귀하의 웹 페이지에 삽입되는 JS 파일로, 채팅 UI와 WebSocket 연결을 담당합니다. -
BlueTalk 중앙 서버 (Node.js)
사이트 정보, 사용자 정보, 채팅 로그, DM, 첨부파일, 제재 정보를 관리하는 서버입니다. -
귀하의 웹 서비스
그누보드/아미나, PHP, Node, Python 등으로 구현된 서비스로, 로그인/회원정보와user_key생성 등 인증 관련 로직을 담당합니다.
실제 요청 흐름은 대략 다음과 같습니다.
[1] 사용자 브라우저가 귀하의 웹 페이지에 접속
[2] 페이지에서 bluetalk.js를 로드하고 <div id="bluetalk"> 등을 준비
[3] 서버(PHP/Node/Python)가 로그인 정보를 바탕으로 user_id, nickname, user_key 생성
[4] JS에서 window.SITE_KEY, window.GLOBAL_* 에 값을 세팅하고 new BlueTalk()로 초기화
[5] 중앙 서버와 WebSocket 연결이 수립되고
이후 채팅 메시지·채널 정보·제재 정보 등이 실시간으로 주고받습니다.
인증 구조와 토큰 설계에 대한 자세한 내용은 인증 구조 문서에서 따로 설명합니다.
가장 단순한 예시는 대략 10줄 내외입니다.
아래는 site_key / user_id / nickname / user_key를 이미 서버에서 준비해두었다고 가정한 예제입니다.
<script src="https://bluetalk.kr/talk/bluetalk.js"></script>
<div id="bluetalk"></div>
<script>
window.SITE_KEY = "발급받은_site_key";
window.GLOBAL_USER_ID = "회원아이디_또는_PK";
window.GLOBAL_USER_KEY = "서버에서_생성한_user_key";
window.GLOBAL_NICKNAME = "표시할_닉네임";
const bt = new BlueTalk({
mode: 'global', // 전체 채팅
targetId: 'bluetalk'
});
bt.init();
</script>
위 코드는 현재 bluetalk.js 실제 구조와 100% 일치하는 예제입니다.
사이트별로는 PHP/Node/Python 등에서 user_key를 어떻게 생성할지 정도만 결정해 주시면 됩니다.
BlueTalk는 특히 다음과 같은 용도에 잘 어울립니다.
- 커뮤니티, 카페, 동호회 사이트의 실시간 수다방
- 게임/코인/주식 등 실시간 정보 공유가 중요한 사이트
- 1:1 상담과 공용 채팅을 동시에 운영하는 서비스
- 이벤트/라이브 방송 페이지 옆 실시간 채팅
- 여러 사이트를 운영하면서 한 곳에서 채팅 서버를 통합 관리하고 싶은 경우
당연히 꼭 위 사례가 아니더라도, “웹에서 실시간으로 사람들끼리 대화가 필요하다”면 어디든 붙여서 사용할 수 있습니다.
현재 BlueTalk는 다음과 같은 정책으로 제공됩니다.
- 기본 기능은 100% 무료로 제공됩니다.
- 상업적/비상업적 사이트 모두 사용 가능합니다.
- 특정 사이트 수 제한 없이 여러 사이트에서 동시에 사용하실 수 있습니다.
- 추후 유료 옵션(예: 별도 전용 서버, 커스텀 개발)이 추가될 수 있으나, 기본 실시간 채팅 기능 자체는 계속 무료 유지를 목표로 합니다.
자세한 라이선스/정책 변경 사항은 공지사항 게시판을 통해 안내드릴 예정입니다.
