채팅 API · SDK · llms.txt · 무료 · 한국어 문서
AI한테 시키면 바로 붙는 고성능 채팅
사람이 할 일은 가입하고 API 키 하나 받는 것까지. 앱 생성부터 채팅 연결까지 나머지는 AI가 합니다. 붙여 넣기만 하면 되는 예시 프롬프트도 준비해 뒀습니다.
$ npm install @kispi/chat
import { createChatClient } from '@kispi/chat'
const chat = createChatClient({ key: 'pk_3f9a1c7e5b', token })
await chat.connect()
const room = chat.roomByKey('lobby')
await room.subscribe()
room.on('messages', render)
await room.send({ text: '안녕하세요 👋' })
// 00 — LIVE
여기서 바로 말해 보세요
목업이 아니라 진짜 엔진입니다. 가입 없이 한마디 남기고, Slack처럼 스레드로 볼지 카톡처럼 답장으로 볼지 바꿔 보세요. 같은 방, 같은 데이터에 UI만 다릅니다.
라이브 데모 · 아무나 들어와 말해 보세요
같은 방, 같은 데이터 — UI만 바꿔 보세요
연결하는 중…
// 01 — IN PRODUCTION
이미 돌고 있는 곳
아래 서비스의 채팅은 이 엔진으로 동작합니다.
// 02 — USE CASES
어떤 채팅이든 됩니다
누구나 들어오는 공개방, 초대받은 사람만 들어오는 비공개방, 둘만의 대화, 운영자만 쓰는 채널. 서비스에 맞게 섞어 씁니다.
커뮤니티 오픈채팅
누구나 들어와 이야기하는 방. 지금 몇 명이 있는지도 함께 보여 줍니다.
- 공개 채팅방
- 접속 중 표시
1:1 상담 · DM
고객 상담, 중고거래, 매칭 앱처럼 둘만의 대화. 상대가 읽었는지도 압니다.
- 1:1 대화(DM)
- 읽음 표시
팀 메신저
슬랙처럼 초대받은 사람만 들어오는 방. 곁가지 대화는 스레드로 뺍니다.
- 비공개 채팅방
- 스레드
공지 · 소식 채널
텔레그램 채널처럼 운영자만 쓰고 모두가 읽습니다. 웹훅을 켜면 새 글이 서버로 전달되어 앱 알림으로 이어 보낼 수 있습니다.
- 채널
- 알림 연동
라이브 방송 채팅
같은 장면을 보며 한꺼번에 이야기하는 채팅. 욕설은 방에 닿기 전에 막을 수 있습니다.
- 이모지 반응
- 보내기 전 심사
게임 · 앱 인앱 채팅
길드 채팅, 파티 채팅, 매치 대기실. 쓰던 로그인에 그대로 붙습니다.
- 비공개 채팅방
- 멘션
// 03 — FEATURES
채팅에 필요한 것은 다 있습니다
-
읽음 표시 · 안 읽은 개수
누가 어디까지 읽었는지, 방마다 안 읽은 개수까지.
-
입력 중 표시
지금 누가 입력 중인지 방에서 바로 보여 줍니다.
-
이모지 반응
꾹 눌러 반응하고, 누가 무엇을 눌렀는지도 봅니다.
-
답장 · 스레드
메시지에 바로 답하거나 스레드로 따로 잇습니다.
-
사진 · 파일
메시지에 사진과 파일을 붙입니다. 파일은 쓰던 저장소에 그대로 둡니다.
-
멘션
@로 콕 집어 부르기.
-
접속 중 표시
지금 이 방에 누가 있는지 한눈에.
-
메시지 수정 · 삭제
오타는 고치고, 잘못 보낸 것은 지웁니다.
-
보내기 전에 걸러내기
before_publish 웹훅을 켜면 메시지가 방에 닿기 전에 그쪽 서버에 물어봅니다. 통과시킬지 고칠지 막을지는 그쪽 규칙이 정합니다.
-
알림 연동
웹훅을 켜면 새 메시지가 올 때마다 그쪽 서버로 알려 줍니다. 앱 푸시는 거기서 이어 보냅니다.
// 04 — SEQUENCE
쉽다고 가볍게 만들지 않았습니다
메시지마다 방 안에서 유일한 번호가 붙고, 모든 구독자가 같은 순서로 받습니다.
끊겼다 붙어도 놓친 것이 없습니다
터널에서 잠깐 끊겨도 괜찮습니다. 다시 연결되는 순간, 그 사이에 온 메시지를 SDK가 채워 넣습니다.
끊기기 전
다시 연결된 순간 · 빈자리 발견
자동으로 채운 뒤
순서가 꼬이지 않습니다
수백 명이 한꺼번에 보내도 모두의 화면에 같은 순서로 쌓입니다. 한 사람만 다르게 보는 일이 없습니다.
서버는 저희가 운영합니다
엔진, DB, 배포는 저희 쪽에 있습니다. 쓰는 쪽 코드는 첫 유저 열 명일 때와 같습니다.
가벼운 SDK
런타임 의존성 0개인 TypeScript SDK. 브라우저에서도 Node 서버에서도 그대로 동작합니다.
구조와 측정한 숫자, 못 잰 것은 아키텍처·벤치마크 문서에 적어 두었습니다.
// 05 — FIT
잘 맞는 경우, 안 맞는 경우
쓰기 전에 맞는지부터 확인하세요. 안 맞는 쪽이 서비스의 핵심이라면 다른 선택이 낫습니다.
잘 맞는 경우
- 웹 커뮤니티·콘텐츠 옆에 붙는 실시간 채팅.
- 사이드 프로젝트, MVP, 초기 스타트업.
- 웹 중심의 1:1 문의·거래 DM. 푸시는 웹훅으로 받아 FCM으로 이어 보냅니다.
- Socket.IO 서버를 직접 만들려던 팀.
안 맞는 경우
- 네이티브 모바일 앱이 먼저인 서비스. 네이티브 SDK도, 내장 푸시도 없습니다.
- 채팅이 매출의 핵심이라 SLA 보상이나 컴플라이언스가 필요한 서비스. 가동률은 보상 없는 운영 목표입니다.
- 의료·금융처럼 감사나 인증이 필요한 곳.
- 완성된 채팅 UI 키트를 바로 쓰고 싶은 경우. SDK는 화면을 주지 않고, 화면은 직접 그립니다.
// 06 — PLAN
무료이고, 언제든 떠날 수 있습니다
0원
Basic은 무료입니다. 카드도, 체험 기간도 없습니다.
요금으로 막는 동시접속·MAU 상한 없음
앱마다 안전 한도(유저당 동시 연결 10개 등)는 있지만, 요금이 사용량을 막지는 않습니다.
언제든 내보내기
콘솔 버튼 하나로 유저·방·메시지 전체를 NDJSON 파일로 받습니다. 데이터는 이용자의 것입니다.
// 07 — START
3단계면 끝
- 01
가입하고 계정 키 받기
이메일 코드로 가입하고 콘솔에서 계정 키(ck_)를 하나 받아 .env에 넣습니다. 사람이 할 일은 여기까지입니다.
- 02
AI에게 프롬프트 건네기
문서의 프롬프트를 복사해 붙여 넣습니다. AI가 llms.txt를 읽고 콘솔 API로 앱을 만들어 publishable key(pk_)와 secret key(sk_)를 .env에 채웁니다.
- 03
채팅이 붙습니다
AI가 서버에는 입장권 발급을, 화면에는 SDK 연결을 붙입니다. 로그인은 쓰던 그대로, 로그인이 없으면 게스트로 시작합니다.
$ npm install @kispi/chat
API 키 하나 받으면, 나머지는 AI가
사람이 할 일은 가입과 키 발급뿐. 앱 생성부터 채팅 연결까지 AI가 하고, 예시 프롬프트도 준비돼 있습니다.