Webhook 봇
채팅에서 @멘션으로 외부 봇 서버 호출
봇메시징공식
소개
외부에서 운영하는 봇 서버의 Webhook URL 과 Secret 을 등록하면 채팅에서 @봇이름 으로 호출할 수 있습니다. Tabple 는 HMAC 서명된 메시지를 봇 서버로 보내고 응답을 채팅에 게시하는 통로 역할만 합니다 — LLM·도구 권한·API 토큰은 발급하지 않습니다.
연결 방법
‘프로젝트에 설치’ 를 누르고 프로젝트를 고른 뒤, 아래 순서대로 받은 주소를 붙이면 끝이에요.
봇 서버에 JSON POST 를 받을 HTTPS 주소를 만들어요. 8초 안에 200 + 로 답하거나, 202 로 먼저 받고 나중에 callback_url 로 PUT 해요.
설치 화면에서 Secret 을 생성해 봇 서버에도 같은 값을 넣어요. 요청의 X-Tabple-Signature (HMAC-SHA256) 와 X-Tabple-Bot-ID 로 위조를 걸러요.
설치하면 봇이 프로젝트 채널에 들어와요. 채팅에서 @봇이름 으로 부르면 봇 서버의 응답이 그 채널에 게시돼요.
- Tabple 은 LLM·도구 권한·API 토큰을 봇에게 발급하지 않아요. 봇 서버가 자기 로직으로 답하고 Tabple 은 메시지 통로예요.
- 리다이렉트(3xx)는 따라가지 않아요 — 최종 URL 을 그대로 등록해요. 봇이 다른 봇을 멘션하면 무시돼요.