채팅 봇 연결하기
직접 만든 봇 서버의 Webhook URL을 등록하면 채팅에서 @봇이름으로 호출하고 응답을 받을 수 있습니다.
봇은 어떻게 동작하나요
Tabple 봇은 Discord·텔레그램 봇과 같은 Webhook 방식입니다. 채팅에서 봇을 @멘션하면 Tabple가 등록된 Webhook URL로 메시지를 전달하고, 봇 서버가 보낸 응답을 그대로 채팅에 게시합니다. Tabple는 메시지를 주고받는 통로 역할만 하며, LLM·API 토큰·도구 호출 권한을 봇에게 제공하지 않습니다. 답변을 만드는 로직(자체 LLM 포함)은 전적으로 봇 서버의 몫입니다.
봇 등록하기
프로젝트 설정 → 앱 & 연동
프로젝트 설정의 '앱 & 연동' 탭에서 '봇 직접 등록'을 누르고 '봇 등록' 버튼을 누릅니다. 등록·제거 권한은 프로젝트 Owner/Admin에게만 있습니다.
이름과 아바타
이름은 채팅에서 @ 뒤에 입력하는 호출명입니다 (영문/숫자/한글/_/- 2~30자). 아바타는 10MB 이하의 이미지 파일을 올릴 수 있고, 설명은 팀원에게 보이는 짧은 안내문입니다 (선택).
Webhook URL 입력
봇 서버가 메시지를 받을 주소입니다. 보안을 위해 HTTPS 공인 도메인만 허용됩니다.
Secret 생성
Tabple가 보내는 요청에 HMAC 서명을 붙일 때 사용하는 비밀 키입니다. 32자 이상이어야 하며, '생성' 버튼으로 32바이트 무작위 값을 만들 수 있습니다. 같은 값을 봇 서버에도 저장하세요.
마켓에서 설치하기
'앱 & 연동'의 '마켓에서 추가'로 마켓의 'Webhook 봇' 앱을 골라도 됩니다. 봇 이름·서버 주소(Webhook URL)·Secret 세 가지만 입력하면 같은 봇이 등록되고, '설치된 앱'에도 함께 나타납니다.
끄기와 제거
'설치된 앱'에서 스위치로 이 프로젝트에서만 봇을 잠시 끌 수 있고, '제거'를 누르면 이 프로젝트에서 빠집니다. 제거하면 채팅의 @봇이름 멘션이 더 이상 동작하지 않습니다.
채팅에서 호출하기
@봇이름 멘션
봇이 멤버로 있는 프로젝트의 채널(비공개 채널 제외)에서 @봇이름 질문 내용 형태로 멘션하면 봇이 호출됩니다. 멘션 부분을 제외한 나머지 텍스트가 봇 서버로 전달됩니다.
응답 확인
봇이 응답을 준비하는 동안 타이핑 표시가 나타나고, 응답이 도착하면 BOT 배지가 붙은 메시지로 게시됩니다. 봇 서버에 문제가 있으면 '봇 응답 실패' 메시지로 원인을 알려줍니다.
1:1 DM
봇과의 1:1 DM에서는 멘션 없이 메시지만 보내도 봇이 호출됩니다. 봇이 들어 있는 그룹 DM에서는 @봇이름으로 멘션해야 호출됩니다.
호출 규칙과 한도
- 봇은 자신이 멤버로 등록된 프로젝트의 채널과 자신이 참여한 DM에서만 반응합니다 — 봇이 없는 프로젝트, 비공개 채널, 이 프로젝트에서 꺼 둔 봇은 같은 이름을 멘션해도 호출되지 않습니다.
- 봇이 보낸 메시지에 포함된 멘션은 무시됩니다 (봇 → 봇 체인 차단). 봇이 자기 자신을 멘션하는 경우도 마찬가지입니다.
- 봇별 한도 — 분당 10회 / 시간당 200회
- 호출자별 한도 — 분당 20회 / 일 1,000회
- 프로젝트별 한도 — 분당 30회 / 일 5,000회
- 한도를 초과한 호출은 응답 없이 기록만 남습니다. 잠시 후 다시 시도하세요.
보안 정책
- Tabple는 봇에게 LLM·API 토큰·도구 호출 권한을 발급하지 않습니다. 봇 서버가 자체 로직과 자체 LLM으로 동작합니다.
- 모든 호출 요청은 등록한 Secret으로 HMAC-SHA256 서명되어 발송됩니다 — 봇 서버가 위조 요청을 구분할 수 있습니다.
- 봇 응답 본문은 일반 메시지와 같은 4,000자 제한이 적용되며, 첨부는 HTTPS 주소만 최대 8개까지 표시됩니다.
- 봇 서버 구현 방법(서명 검증·비동기 응답)은 다음 가이드 'Webhook 봇 서버 만들기'에서 다룹니다.