Skip to content

plugin bots

github-actions[bot] edited this page Apr 26, 2026 · 2 revisions

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

Home


Getting Started


Commands


Features


Configuration


Plugins (87 + 10 monitoring)

Free (25)
Pro (62)
Planned (26)
  • plugin-audit
  • plugin-blog
  • plugin-checkout
  • plugin-commerce
  • plugin-drm
  • plugin-export
  • plugin-flow
  • plugin-import
  • plugin-ldap
  • plugin-mailgun
  • plugin-media
  • plugin-oauth-providers
  • plugin-pages
  • plugin-postmark
  • plugin-rate-limit
  • plugin-reports
  • plugin-saml
  • plugin-scheduler
  • plugin-sendgrid
  • plugin-sso
  • plugin-subscription
  • plugin-thumb
  • plugin-transcoder
  • plugin-twilio
  • plugin-waf
  • plugin-watermark

Guides


Architecture


Reference


Licensing


Security


Brand


Operations


Contributing


Changelog

Clone this wiki locally