Chatbot Manage Tool
chatbot_manageManage embeddable chatbots backed by FleetQ agents: create, update, delete, toggle status, manage widget tokens, list sessions, view analytics and learning entries.
Instructions
Embeddable chatbots backed by an existing FleetQ agent. Each instance issues per-widget tokens for embedding, tracks sessions, and exposes analytics + learning entries. Conversations consume team credits via the bound agent's provider.
Actions:
list / get (read) — list all or fetch one (chatbot_id).
create (write) — name, agent_id, config (theme, greeting, allowed_origins[]).
update (write) — chatbot_id + any creatable field.
delete (DESTRUCTIVE) — chatbot_id. Cascades — also revokes all widget tokens.
toggle_status (write) — chatbot_id. Flips active ↔ disabled.
token_create (write) — chatbot_id. Returns an embeddable widget token (display once).
token_revoke (DESTRUCTIVE) — chatbot_id, token_id. Invalidates a single widget instance.
session_list / analytics / learning_entries (read) — chatbot_id; optional date range.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| action | Yes | Action to perform: list, get, create, update, delete, toggle_status, token_create, token_revoke, session_list, analytics, learning_entries | |
| deadline_ms | No | Optional: max wall-clock time (ms) the tool may spend. If exceeded during the call, returns a DEADLINE_EXCEEDED error. Minimum 100 ms. Leave unset for no deadline. | |
| status | No | Filter by status: active, inactive, draft, suspended | |
| limit | No | Max results (default 20, max 100) | |
| id | Yes | Chatbot UUID or slug | |
| name | Yes | Chatbot display name | |
| type | Yes | Chatbot type | |
| system_prompt | Yes | System prompt for the backing agent | |
| provider | No | LLM provider (default: anthropic) | anthropic |
| model | No | LLM model (default: claude-haiku-4-5) | |
| description | No | Optional description | |
| welcome_message | No | Welcome message shown on first open | |
| confidence_threshold | No | Confidence threshold for escalation (0.0-1.0, default 0.7) | |
| human_escalation_enabled | No | Enable human escalation for low-confidence responses | |
| workflow_id | No | Optional workflow UUID to delegate message processing | |
| approval_timeout_hours | No | Hours before escalated approval expires (default 48) | |
| fallback_message | No | Fallback message for escalated responses | |
| widget_config | No | Widget config: {position, theme_color, title} | |
| chatbot_id | Yes | The chatbot UUID | |
| rotate_existing | No | If true, existing active tokens get a 48-hour expiry grace period before being invalidated. Default: false | |
| token_id | Yes | The chatbot token UUID (returned by chatbot_token_create) | |
| channel | No | Filter by channel: web_widget, api, telegram, slack | |
| days | No | Number of days to look back (default 30, max 90) |