Omnichannel CLI for Autonomous AI Agents
Automate customer conversations and messaging workflows across 30+ networks. Built for AI agents like Claude Code, OpenClaw, and terminal LLMs to manage contacts, trigger flows, and query CRM state from the command line.
Please make sure there is always a human in the loop.
Quick Start: Install & Set Up ChatbotX Agent in Seconds
Add the ChatbotX skill to your favorite AI agent runtime or execute commands directly from your terminal.
# 1. Install CLI globally or add skill to your AI agent
npm install -g chatbotx
# or: npx skills add sunghajung43/chatbotx
# 2. Configure Workspace Token (Settings → Integrations → Workspace token)
chatbotx config set --apiKey "YOUR_WORKSPACE_TOKEN" --apiUrl "https://app.chatbotx.io/api"
# 3. Verify workspace access and list active channels
chatbotx workspaces get
chatbotx channels list
# 4. Resolve contact and trigger an automated flow
chatbotx contacts get email:[email protected]
chatbotx contacts flow add email:[email protected] --flowId <flowId>Built for Autonomous AI Workflows
Engineered from the ground up to give LLMs and autonomous agents reliable customer conversation & CRM execution capabilities.
AI Agent & MCP Ready
Every command returns clean, structured JSON. Designed for LLMs, function calling, and MCP tools with zero token cost overhead.
Omnichannel Messaging
Manage WhatsApp, Telegram, Messenger, Zalo, Instagram, SMS, and WebChat from a single unified command-line tool.
Contact CRM & Resolvers
Resolve, create, and update contacts seamlessly by email, international phone number (+84...), or internal workspace identifier.
Tags & Custom Fields
Dynamically tag contacts, query custom attributes, and maintain synchronized CRM state directly through automation scripts.
Chatbot Flows & Sequences
Trigger interactive multi-step chatbot flows, auto-reply rules, and drip sequences programmatically based on agent logic.
Broadcasts & Inbox Triage
Monitor live open conversations, list target broadcast audiences, and dispatch bulk campaigns with full delivery audit logs.
How ChatbotX Agent CLI Operates
A clear 3-step lifecycle for AI agents to discover, compose, and monitor campaigns.
Discover Workspace
The agent queries connected messaging channels, tags, and custom fields to understand workspace configuration.
chatbotx channels list
chatbotx tags list
chatbotx custom-fields listContacts & Flows
Resolve contacts by email or phone, assign segmentation tags, and trigger personalized chatbot flows automatically.
# Resolve contact and attach tag
chatbotx contacts get email:[email protected]
chatbotx contacts tag add email:[email protected] --tagIds tag_vip
# Trigger automated flow
chatbotx contacts flow add email:[email protected] --flowId flow_onboardingInbox & Broadcasts
Monitor open customer conversations across channels, inspect broadcasts, and manage multi-channel dispatches.
# List active unassigned conversations
chatbotx conversations list --status unassigned
# Inspect scheduled broadcasts
chatbotx broadcasts listOne Command, Every Channel
Sync CRM contacts, add dynamic tags, and trigger multi-channel flows across WhatsApp, Telegram, and Messenger with simple shell scripts.
# 1. Look up contact by phone or email
chatbotx contacts get phone:+84708123123
# 2. Add VIP segmentation tag
chatbotx contacts tag add phone:+84708123123 --tagIds tag_vip_client
# 3. Update customer custom field
chatbotx contacts custom-field add phone:+84708123123 cf_tier --value "Gold"
# 4. Trigger automated welcome flow or send direct notification
chatbotx contacts flow add phone:+84708123123 --flowId flow_spring_promo
chatbotx contacts message send phone:+84708123123 --text "Your VIP status has been activated!"
# 5. Batch-tag segmented leads from a list
for email in [email protected] [email protected] [email protected]; do
chatbotx contacts tag add email:$email --tagIds tag_lead_qualified
doneFirst-Class Support for Agent Runtimes
Whether running OpenClaw locally or prompting Claude Code in your terminal, ChatbotX integrates effortlessly.
OpenClaw
Skill-Based Agent Runtime
OpenClaw automatically discovers ChatbotX via the bundled SKILL.md. Run heartbeat cron jobs or trigger customer flows directly from WhatsApp, Telegram, or terminal.
{
"heartbeat": [
{
"cron": "*/15 * * * *",
"prompt": "Check chatbotx conversations list --status unassigned. If new chats found, notify on-call team."
},
{
"cron": "0 9 * * 1-5",
"prompt": "Trigger flow_followup for all contacts with tag_pending_quote in ChatbotX."
}
]
}Claude Code
Anthropic Terminal Agent
Claude Code reads ChatbotX tool definitions, checks workspace channels, resolves contacts, and triggers flows from natural language prompts.
> Find [email protected] in ChatbotX, tag them as VIP, and trigger the priority support flow
Claude runs autonomously:
chatbotx contacts get email:[email protected]
chatbotx contacts tag add email:[email protected] --tagIds tag_vip
chatbotx contacts flow add email:[email protected] --flowId flow_priority_support
Execution complete: Contact tagged and routed to Priority Support flow.Standardized SKILL.md Architecture
Auto-discovered by OpenClaw, Codex, and modern LLM skill frameworks.
---
name: chatbotx
description: Omnichannel customer conversation and CRM automation CLI for ChatbotX Workspace API
metadata:
requirements:
env:
- CHATBOTX_API_KEY
- CHATBOTX_API_URL
binaries:
- chatbotx
---
# Available Commands
- chatbotx workspaces get # Verify workspace access
- chatbotx contacts get <identifier> # Resolve contact (email, phone, id)
- chatbotx contacts tag add <id> --tagIds # Add segmentation tags
- chatbotx contacts flow add <id> --flowId # Trigger automated chatbot flow
- chatbotx conversations list # Query live inbox conversations
- chatbotx broadcasts list # Manage multi-channel broadcastsCommand Reference Matrix
Complete list of CLI commands available to your autonomous agents and scripts.
Supported Platforms & Channels
Connect your channels in ChatbotX once, then automate customer conversations to any of them via CLI or agent.
AI Agent CLI
Frequently Asked
Questions
