Documentation

Creating and configuring AI chatbots.

Creating a Bot

Navigate to Bots and click "Create Bot". You'll need to provide a name and a system prompt. The system prompt is the most important configuration — it defines your bot's personality, tone, scope, and behavior.

System Prompt

The system prompt is injected at the start of every AI conversation. Write it as instructions to the AI. Be specific about what the bot should and shouldn't do, its tone of voice, and how it should handle edge cases.

Include examples of ideal responses in your system prompt. The AI performs better when it has concrete examples to follow.

Model Selection

Choose from available LLM models on OpenRouter. Different models have different strengths — some are faster and cheaper, others are more capable at complex reasoning. The temperature setting (0.0–1.0) controls creativity: lower values give more consistent responses, higher values give more varied ones.

Greeting, Fallback & Escalation

Configure three special messages: the Greeting Message is sent when a new conversation starts, the Fallback Message is sent when the AI cannot generate a response, and the Escalation Prompt defines when the bot should hand off to a human agent.

Pausing and Resuming

You can pause a bot at any time. A paused bot will not respond to new messages — incoming messages are saved to the conversation history but the AI does not process or reply to them until the bot is resumed. This is useful for maintenance or when you want to temporarily take full manual control.

Giving a Bot Tools

Beyond chatting, a bot can take actions with tools. Neuron ships dozens of built-in tools — send images and documents, search the knowledge base, look up and save contacts, create polls, set reminders, escalate to a human, and more — which you switch on or off per bot in the bot's "Built-in Tools" tab. You can also add your own custom tools (HTTP APIs, webhooks, or MCP servers) in the "Tools" tab. See the Tools section for the full catalog and setup.

Scheduled Tasks

A bot can run autonomous tasks on a schedule — a one-off follow-up, a recurring check-in, or an interval-based nudge. Create and manage them in the bot's "Tasks" tab: give the task a title, an instruction (what the bot should do), and a schedule (once, recurring by cron, or every N minutes/hours). Each run executes the instruction and is logged with its output. The bot can also schedule tasks for itself mid-conversation when you enable the "Create Scheduled Task" built-in tool (off by default).

Multiple Numbers & Load Balancing

Assign a bot to more than one WhatsApp session so it can send and receive across several numbers. When multiple numbers are attached, Neuron load-balances outbound sends across them (round-robin, least-used, or random) with sticky per-contact affinity, so each contact keeps talking to the same number. Manage secondary numbers and the balancing strategy from the bot's detail page.

Silent Mode

Silent mode is a per-session setting. When a session is silent, the bot still runs the full pipeline (LLM and tools) but does not send a visible reply — useful for group moderation, where the bot watches and runs tools without posting chat messages. The assistant's output is still saved and visible in the dashboard.

Direct Messages & Groups

Two toggles control where a bot replies: process direct messages and process group messages — both are off by default, so turn on what you need. For groups, you can further restrict the bot to a whitelist of specific groups. Incoming messages are always saved either way; these toggles only control whether the AI responds. See Conversations for the full processing pipeline.

Learning & Reflections

Bots can learn from your team. When an admin or owner messages the bot, that message can be routed to a learning queue instead of a normal reply, where it is analyzed into suggested improvements — reflections — that you review and approve. Configure learning sources and review reflections from the bot's Reflections tab.

Personas & Voice

A persona captures a distinct writing voice a bot can speak in. Build personas under the Personas section and apply one to a bot so its replies keep a consistent tone and style. Personas are managed separately from the bot so the same voice can be reused across bots.

Bot Analytics

Each bot has an Analytics tab showing message volume, conversation counts, response times, and escalation rates. Use these metrics to monitor performance and identify areas for improvement.