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 → Apps & integrations
In project settings, open the Apps & integrations tab, click Register bot directly, then 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 an image file up to 10MB, and the description is an optional 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. It must be at least 32 characters; click Generate for a random 32-byte value. Store the same value on your bot server.
Install from the marketplace
You can also pick the Webhook bot app with Add from marketplace in Apps & integrations. Enter just the bot name, server address (webhook URL), and secret, and the same kind of bot is registered and shows up under Installed apps too.
Turning off and removing
Under Installed apps, the switch turns a bot off for this project only, and Remove takes it out of this project. After removal, @botname mentions in chat stop working.
Calling a bot from chat
@botname mention
In a channel of a project where the bot is a member (private channels excluded), 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 one-on-one DM with a bot, just send a message — no mention needed. In a group DM that includes the bot, mention it with @botname to call it.
Call rules and limits
- A bot only responds in channels of projects it belongs to and in DMs it's part of — mentioning the same name in a project without that bot, in a private channel, or for a bot you've turned off in this project 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.