밤 11시 고객문의, 챗봇이대신 답하려면

입문자용© AIKOREACLUB

botpress/botpress

밤 11시 고객 문의, 챗봇이 대신 답하려면

우리 가게 자료(홈페이지, PDF, 표)를 넣고 지시문 몇 줄을 쓰면, AI가 그 자료로 손님 질문에 답하고 어려운 건 사람에게 넘기는 상담 챗봇을 화면에서 끌어다 놓아 만드는 서비스예요. 이 저장소는 그 서비스의 연동과 개발 도구 코드예요

★ 14,975챗봇 제작 클라우드 서비스 + 개발 도구(CLI·SDK) · MIT확인 2026-11-03

깃허브에서 보기 ↗틀린 점 알리기

작은 온라인 가게에 밤 11시에 문의가 와요. "어제 주문한 거 아직 안 왔는데 그냥 환불돼요?" 예전 챗봇은 [주문 조회] [배송 안내] 버튼만 보여 주고, 버튼 밖의 문장에는 "이해하지 못했어요"만 되풀이해요. 손님은 답을 못 받은 채 창을 닫고, 아침이면 같은 질문이 또 쌓여 있어요.봇프레스는 우리 가게의 환불 정책 PDF와 자주 묻는 질문 쪽을 넣고 지시문을 쓰면, AI가 그 자료를 찾아 답하고 사람이 필요한 순간엔 상담원에게 넘기는 챗봇을 만들게 해 줘요. 2016년에 시작한 저장소로 깃허브 별 14,975개를 받았어요(2026-11-03 확인).

버튼만 아는 챗봇에 손님이 말을 걸면

우리 가게 상담밤 11:04

메시지를 입력하세요

손님이 원하는 세 가지

손님은 버튼을 고르지 않고 문장으로 물어요. 그 문장을 받아 낼 수 있는지 봐요.

한 문장 속 두 질문 알아듣기배송이 늦은 이유와 환불 가능 여부를 한 번에
우리 가게 규칙으로 답하기환불 정책 문서에 적힌 대로
사람이 필요하면 넘기기지금까지의 대화를 요약해서 함께

예전 버튼형 챗봇과 공식 문서의 자율 노드·상담원 연결을 비교하려고 저희가 그린 예시예요. 가게, 정책, 대화는 지어낸 것이에요. 실제 답은 넣은 자료, 지시문, 고른 AI 모델에 따라 달라져요.

한눈에

무엇인가요

스튜디오에서 그림 그리듯 짜요. 봇프레스 스튜디오는 워크플로(봇이 밟는 순서), 노드(그 안의 한 단계), 카드(노드 안에서 하는 동작: 메시지 보내기, 정보 묻기, 표 쓰기, AI 작업)를 끌어다 놓아 챗봇을 만드는 화면이에요.자율 노드가 대화를 맡아요. 자율 노드(Autonomous Node)는 내가 쓴 지시문과 대화 흐름을 읽고, 무슨 말을 할지와 어떤 도구를 쓸지를 AI가 정하는 단계예요. 지식 찾기, 다른 워크플로로 넘어가기, 상담원 연결 같은 도구를 쥐여 줄 수 있어요.우리 자료로 답해요. 지식 베이스에 웹사이트, 문서(PDF, 워드, HTML, 텍스트, 마크다운, 한 파일 50MB까지), 표, 실시간 웹 검색, 직접 쓴 글, 노션·구글 드라이브 연동을 넣어요.한 번 만들어 여러 창구에 붙여요. 홈페이지 채팅창(웹챗)과 왓츠앱, 메신저, 인스타그램, 텔레그램, 슬랙 같은 연동으로 같은 봇을 내보내요.이 저장소에 있는 것. 챗봇을 만드는 스튜디오와 실행은 봇프레스 클라우드 서비스이고, 깃허브에는 그 서비스의 공개 연동 80여 개, 개발 도구(CLI, SDK, API 클라이언트), 코드로 만든 예시 봇이 들어 있어요.

함께 쓰는 도구 · 웹사이트 채팅창(웹챗) · 왓츠앱 · 메신저 · 인스타그램 · 텔레그램 · 슬랙 · 팀즈 · LINE · Zendesk · 허브스팟

이런 분께

같은 질문(배송, 환불, 영업시간, 예약)이 계속 들어오는 쇼핑몰, 학원, 병원, 숙소
코딩 없이 화면에서 상담 챗봇을 만들어 홈페이지나 메신저에 붙이고 싶은 분
우리 회사 시스템과 챗봇을 잇는 연동을 직접 만들어야 하는 개발자

어떻게 작동하나요

1. 지식을 넣어요. 홈페이지 주소를 넣으면 하위 쪽을 찾아 고르게 하고, 정한 주기(예: 매일)로 다시 읽게 할 수 있어요. 표를 넣을 때는 검색할 칸을 하나 이상 골라야 해요.2. 지시문을 써요. 공식 문서의 예시 틀은 정체(Identity), 범위(Scope), 답하는 말투(Response Style), 지시(Instructions) 네 덩어리예요. 지시문은 구체적일수록 좋지만, 길고 앞뒤가 안 맞으면 AI가 헷갈린다고 문서가 적어요. 제목과 목록으로 짧게 나누고, 인사, 다음 단계로 넘어갈 조건, 마무리 말까지 써 두라고 권해요.3. 에뮬레이터로 시험해요. 스튜디오 안 대화창에서 말을 걸어 보고, Inspect 창에서 자율 노드가 어떤 도구를 쓸 수 있었고 몇 번 돌았는지 봐요. 지시문을 잘못 읽었거나 도구가 안 불린 곳을 여기서 찾아요.4. 내보내요. Add to your website 를 누르면 스크립트 태그로 홈페이지에 붙이고, 리액트, 워드프레스, 윅스, 웹플로용 방법도 있어요. 다른 창구는 Integrate with a channel 로 연결해요.

할 수 있는 일

지식 베이스홈페이지 주소, PDF·워드 문서, 표, 실시간 웹 검색, 직접 쓴 글을 넣으면 그 안에서 답을 찾아요

자율 노드지시문대로 AI가 답하고, 필요하면 지식 찾기·상담원 연결 같은 도구를 스스로 골라 써요

표(Tables)주문, 예약처럼 봇이 쌓고 꺼내 보는 작은 데이터베이스예요. 지식 베이스에 이어 말로 물을 수도 있어요

에이전트대화 요약, 번역, 말투, 지켜야 할 정책, 이미지 읽기, 분석을 맡는 정해진 도우미를 켜요

상담원에게 넘기기사람이 필요한 순간 대화를 상담원에게 넘기고, 지금까지의 요약과 대화 기록을 함께 보내요

여러 창구에 내보내기웹챗을 홈페이지에 붙이거나 왓츠앱, 메신저, 텔레그램, 슬랙, 팀즈 같은 채널에 연결해요

바로 쓸 수 있나요

누구나 바로

필요한 것웹 브라우저와 botpress.com 가입. 연동이나 봇을 코드로 만들려면 Node.js, pnpm, git 이 필요해요

비용저장소 코드는 MIT로 무료예요. 클라우드는 무료 요금제(한 달 대화 100건, 봇 3개, 추가 구매 불가), Plus 월 150달러(연 결제, 대화 250건, AI 사용료 25달러 포함), Team 월 750달러(연 결제)부터예요(2026-11-03 가격 쪽 기준)

시작하기

가입
app.botpress.cloud 에서 가입해요. 무료 요금제로 봇 3개까지 만들 수 있어요.
봇 만들기
Start building 이나 Build my agent 를 누르고 화면 안내를 따라가요. 처음부터 직접 짜고 싶으면 Skip 을 누르고 따라 하기 안내를 봐요.
미리 보고 다듬기(선택)
봇을 미리 대화해 보고, 생김새는 웹챗 설정에서, 행동은 스튜디오에서 고쳐요.
내보내기
Add to your website 로 홈페이지 채팅창을 붙이거나, Integrate with a channel 로 다른 창구에 연결해요.
개발자라면: 연동 직접 만들기
봇프레스 CLI를 깔고 원하는 폴더에서 틀을 만들어요. 이 저장소를 포크하지 않아도 돼요. bp deploy 는 내 작업 공간에만 올리고, 모두에게 공개하려면 --visibility public 을 붙여요.
```
npm install -g @botpress/cli
bp init
bp deploy
```

처음 해 볼 한마디

당신은 [회사 이름]의 고객 상담 AI 에이전트예요. 답은 짧고 핵심만 말해요.

공식 문서에 실린 자율 노드 지시문 예시를 우리말로 옮겼어요. 자율 노드의 Instructions 칸에 넣고 범위와 말투를 덧붙여요.

상담 챗봇이 만들어지는 다섯 단계

Botpress Studio

봇프레스 스튜디오의 워크플로 화면: Follow-up-question, Summarize, Final-Question 같은 노드 상자가 선으로 이어지고, 상자마다 AI Task, Capture Info 같은 카드가 들어 있어요 — **실제 스튜디오 화면**README 맨 위에 실린 그림이에요. 노드 상자 안에 AI Task(AI 작업), Capture Info(정보 묻기), 변수 설정 같은 카드가 쌓이고, 상자끼리 선으로 이어져 대화 순서가 돼요.이미지: botpress/botpress README (MIT)

공식 문서의 스튜디오 화면 이름, 자율 노드 도구 이름, 지식 베이스 자료 종류를 바탕으로 저희가 그린 예시예요. 가게, 자료, 대화는 지어낸 것이에요. 실제 화면과 답은 봇프레스 버전, 넣은 자료, 고른 AI 모델에 따라 달라져요.

비슷한 도구

봇프레스는 손님 질문에 봇이 먼저 답하는 쪽, 챗우트는 상담원이 여러 창구의 문의를 한곳에서 받는 쪽, 하비는 우리가 먼저 연락하는 쪽이에요(각 README 기준).

고객 문의, 다섯 군데서 따로 답하고 있다면홈페이지, 메신저, 메일로 온 문의를 상담원이 한곳에서 받는 고객 응대 도구chatwoot/chatwoot

영업 메일, AI가 혼자 보내도 될까들어온 문의에 답하는 대신 새 고객에게 먼저 연락하는 영업 에이전트ethanplusai/harvey

주의할 점

이 저장소만으로는 내 서버에 챗봇을 세울 수 없어요. 스튜디오와 실행은 봇프레스 클라우드이고, 내 서버에 설치하던 옛 버전 v12 는 따로(botpress/v12) 있어요. 손님 대화와 넣은 자료가 클라우드를 거치니, 우리 개인정보 처리방침에 맡기는 곳으로 적어야 하는지 확인하세요.
자율 노드는 AI가 답을 지어 쓰는 방식이라, 지식에 없는 말을 할 수 있어요. 환불, 가격, 의료·법률처럼 틀리면 안 되는 답은 에뮬레이터로 여러 번 물어보고, 모르면 사람에게 넘기라는 지시를 넣어 두세요. 문서는 GPT-4.1 정도 성능의 모델을 권하고, 작은 모델은 도구 설명을 잘라 먹을 수 있다고 적어요.
옛 HITL 에이전트(상담원 연결)는 새 계정에서 쓸 수 없어요. 공식 문서는 HITL 플러그인을 쓰라고 안내해요.
만든 연동을 --visibility public 으로 공개하면 그 버전은 다시 고칠 수 없다고 README가 적어요.
무료 요금제는 한 달 대화 100건을 넘기면 추가 구매가 안 돼요. 실제 손님을 받기 전에 요금제를 확인하세요.

낯선 말

챗봇·AI 에이전트 · 사람 대신 대화로 질문에 답하거나 일을 처리하는 프로그램이에요
워크플로·노드·카드 · 봇이 밟는 순서, 그 안의 한 단계, 그 단계에서 하는 동작이에요
지식 베이스 · 봇이 답을 찾아보는 자료 모음이에요
자율 노드 · 지시문을 읽고 AI가 스스로 답과 도구를 고르는 단계예요
HITL · Human in the loop. 봇이 대화 중에 사람 상담원에게 넘기는 기능이에요
웹챗 · 홈페이지 구석에 뜨는 채팅창이에요
연동(인티그레이션) · 왓츠앱, 허브스팟처럼 다른 서비스와 봇을 잇는 부품이에요

AI 답은 참고 자료예요. 법·세금·돈·건강처럼 삶에 큰 영향을 주는 일에서는 AI 답이 정답이 될 수 없어요. 최종 판단은 전문가나 공식 기관에서 확인하세요.