Connect a chat bot
Register your own bot server's webhook URL and you can call it from chat with @botname and get a reply.
How bots work
Tabple bots use the same webhook approach as Discord and Telegram bots. When you @mention a bot in chat, Tabple forwards the message to the registered webhook URL and posts the bot server's reply to the chat as is. Tabple only acts as the channel for those messages — it gives bots no LLM, no API tokens, and no tool-call permissions. The logic that produces the answer, including any LLM of its own, is entirely up to the bot server.
Register a bot
Project settings → Bots
In the Bots section of project settings, click Register bot. Only a project Owner or Admin can register or remove bots.
Name and avatar
The name is what you type after @ in chat (letters, numbers, Korean characters, _ or -, 2 to 30 characters). The avatar can be a PNG or JPG up to 10MB, and the description is a short note your teammates see.
Enter the webhook URL
This is where the bot server receives messages. For security, only HTTPS addresses on public domains are allowed.
Generate a secret
This is the key Tabple uses to add an HMAC signature to the requests it sends. Click Generate for a random 32-byte value, and store the same value on your bot server.
Calling a bot from chat
@botname mention
In a channel of a project where the bot is a member, mention it as @botname your question to call it. Everything except the mention is forwarded to the bot server.
Check the reply
A typing indicator appears while the bot prepares its reply, and the reply is posted as a message with a BOT badge. If something is wrong with the bot server, a bot-response-failed message explains why.
One-on-one DM
In a DM with a bot, just send a message — no mention needed.
Call rules and limits
- A bot only responds in channels of projects it belongs to — mentioning the same name in a project without that bot does nothing.
- Mentions inside a message a bot sent are ignored (no bot-to-bot chains). The same goes for a bot mentioning itself.
- Per bot — 10 per minute / 200 per hour
- Per caller — 20 per minute / 1,000 per day
- Per project — 30 per minute / 5,000 per day
- Calls over the limit are recorded but get no reply. Try again in a moment.
Security policy
- Tabple issues no LLM, API tokens, or tool-call permissions to bots. The bot server runs on its own logic and its own LLM.
- Every call is signed with HMAC-SHA256 using the secret you registered, so the bot server can tell forged requests apart.
- A bot reply has the same 4,000-character limit as a regular message, and up to 8 attachments are shown — HTTPS URLs only.
- Implementing the bot server, including signature verification and async replies, is covered in the next guide, Build a webhook bot server.