Omnichannel Automation CLI for Claude Cowork

Connect Anthropic's desktop AI agent to ChatbotX. Manage customer contacts, assign tags, trigger chatbot flows, and monitor live conversations across WhatsApp, Telegram, and Messenger directly from your desktop.

Read the Docs Start for $0

Please make sure there is always a human in the loop.

Quick Start: Install & Set Up ChatbotX CLI for Claude Cowork

Install the ChatbotX CLI, configure your workspace credentials, and run omnichannel commands directly from your desktop.

terminal: quick-start

bash / zsh

# 1. Install ChatbotX CLI globally or add skill
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 customer contact and trigger automated flow
chatbotx contacts get email:[email protected]
chatbotx contacts flow add email:[email protected] --flowId <flowId>

Built for Automation

Engineered specifically for autonomous agents, background workers, and terminal execution pipelines.

AI Agent & MCP Ready

Every command returns 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 It Works

Simple three-step cycle for autonomous discovery, contact execution, and inbox triage.

Discover Workspace

List connected messaging channels, tags, and custom fields to introspect workspace configuration.

chatbotx channels list

# Query tags and fields
chatbotx tags list
chatbotx custom-fields list

Contacts & Flows

Resolve contact details by email or phone, attach segmentation tags, and launch automated chatbot flows.

# Resolve contact and 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_welcome

Inbox & Broadcasts

Monitor open customer conversations across channels, inspect broadcasts, and manage multi-channel dispatches.

# List active unassigned conversations
chatbotx conversations list --status unassigned

# Inspect broadcasts
chatbotx broadcasts list

One Command, Every Channel

Sync CRM contacts, add dynamic tags, and trigger multi-channel flows across WhatsApp, Telegram, and Messenger with simple shell scripts.

examples / multi-platform-broadcast.sh

batch script

# 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
done

What is Claude Cowork?

Claude Cowork is Anthropic's agentic AI tool for knowledge workers. It runs on your desktop, connects to local files and apps like Google Drive, Gmail, and DocuSign, and completes multi-step tasks autonomously, including managing customer relationships in ChatbotX.

💻

Desktop Native

Claude Cowork runs directly on your desktop, connecting to local files and apps. No complex cloud infrastructure needed to manage customer inquiries and trigger chatbot flows.

🔗

App Integrations

Connects to Google Drive, Gmail, CRM spreadsheets, and local databases. Pull customer data from existing tools and sync directly into ChatbotX contacts.

🤖

Autonomous CRM Tasks

Claude Cowork completes multi-step workflows independently. Instruct it to resolve customer details, tag VIP accounts, and dispatch onboarding sequences.

How ChatbotX Works with Claude Cowork

Claude Cowork executes ChatbotX CLI commands directly from your desktop terminal. It parses structured JSON output to resolve contacts, add tags, and trigger flows autonomously.

Manage Customer Workflows From Desktop

Tell Claude Cowork what customer action to take: it connects to ChatbotX, resolves contact identifiers, updates custom fields, and launches flows without you opening a browser.

Interactive Session Simulation

Autonomous

You: Look up contact [email protected] in ChatbotX, add the 'enterprise-lead' tag, and trigger our onboarding flow.

Claude Cowork: I'll handle that.
  1. Found contact via ChatbotX API: John Doe (ID: c_88319)
  2. Verified tag: 'enterprise-lead' (tag_9012)
  3. Added tag: chatbotx contacts tag add email:[email protected] --tagIds tag_9012
  4. Triggered flow: chatbotx contacts flow add email:[email protected] --flowId flow_onboarding
  
Enterprise lead tagged and onboarding flow dispatched successfully.

Also Works with OpenClaw & Claude Code

ChatbotX Agent is a flexible CLI & MCP tool: it works with any AI agent runtime that supports shell execution or Model Context Protocol.

OpenClaw

Personal AI Agent

Lightweight personal AI agent that connects to WhatsApp, Telegram, and terminal workflows. Supports ChatbotX via skill definitions for automated customer support.

Explore Integration Docs

Claude Code

Terminal Coding Agent

Anthropic's terminal agent that completes development and automation tasks autonomously. Reads ChatbotX tool definitions and executes customer operations via CLI.