bots

bots — ɳSelf documentation.

Bots Plugin

Bot framework for chat, commands, subscriptions, and bot marketplace. Pro plugin.

Requires: Basic license tier or higher. nself license set nself_pro_...

Install

nself license set nself_pro_xxxxx...
nself plugin install bots

What It Does

A framework for building and deploying chat bots that integrate with the chat plugin. Define bot commands (slash commands), event subscriptions (react to messages, joins, reactions), and publish bots to a shared marketplace. Supports webhook-triggered bots and native Go bot handlers.

Configuration

Env Var	Default	Description
BOTS_PORT	3103	Bots service port
BOTS_WEBHOOK_TIMEOUT	5s	Webhook delivery timeout
BOTS_MARKETPLACE_ENABLED	true	Enable bot marketplace

Ports

Port	Purpose
3103	Bots REST API

Database Tables

9 tables added to your Postgres database:

• np_bots_bots: registered bot definitions
• np_bots_commands: slash command registrations
• np_bots_subscriptions: event subscriptions
• np_bots_webhooks: webhook delivery configs
• np_bots_marketplace: marketplace listings
• np_bots_installs: bot install records
• np_bots_tokens: bot authentication tokens
• np_bots_events: event delivery log
• np_bots_responses: bot response cache

Nginx Routes

Route	Target
/bots/	Bot management API
/bots/webhook/{bot_id}	Bot webhook receiver