Omnichannel Automation CLI for Paperclip

Automate customer operations across 30+ messaging channels. Built for Paperclip to coordinate AI agent teams for customer triage, support ticket resolution, and multi-channel broadcasts.

Read the Docs Paperclip Start for $0

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

Quick Start: Install & Deploy ChatbotX CLI with Paperclip

Install ChatbotX CLI for your Paperclip multi-agent teams for automated customer operations.

terminal: quick-start

bash / zsh

# 1. Install ChatbotX CLI globally
npm install -g chatbotx

# 2. Configure credentials in environment (Settings → Integrations → Workspace token)
export CHATBOTX_API_KEY="YOUR_WORKSPACE_TOKEN"
export CHATBOTX_API_URL="https://app.chatbotx.io/api"

# 3. Verify workspace access and list connected channels
chatbotx workspaces get
chatbotx channels list

# 4. Triage open conversations and update CRM tags
chatbotx conversations list --status open
chatbotx contacts tag add email:[email protected] --tagIds <tagId>

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 Paperclip?

Paperclip is an open-source orchestration framework for building 'zero-human companies' by hiring and managing teams of AI agents. It handles organization hierarchy, role assignment, budget management, and multi-agent coordination.

👥

Agent Teams

Manages teams of AI agents working collaboratively. Assign triage, support, and marketing agents to handle customer lifecycles together.

📊

Single Dashboard

Monitor all agents and tasks from one unified dashboard. Track customer ticket queues, response status, and agent performance in real time.

🔄

Multi-Agent Orchestration

Chain multi-agent workflows with approval gates and handoffs. Build sophisticated customer pipelines where agents collaborate on resolving customer tickets.

How ChatbotX Works with Paperclip

Paperclip coordinates specialized AI agents that execute ChatbotX CLI commands. A Triage Agent reads incoming conversations, an Escalation Agent tags VIP accounts, and a Resolution Agent triggers automated chatbot flows.

Multi-Agent Customer Pipeline

Paperclip agent teams collaborate on customer conversations: from initial inbox triage to tag assignment and flow dispatch.

Interactive Session Simulation

Autonomous

Paperclip Team: Processing customer inquiries across inboxes.

[Triage Agent]: Scanned unassigned conversations in ChatbotX.
  -> Command: chatbotx conversations list --status unassigned
  -> Found 1 billing inquiry from email:[email protected].

[Support Agent]: Evaluated customer history and account tier.
  -> Command: chatbotx contacts get email:[email protected]
  -> Contact matched: VIP enterprise client.
  -> Command: chatbotx contacts tag add email:[email protected] --tagIds tag_vip_billing

[Resolution Agent]: Dispatched priority billing resolution flow.
  -> Command: chatbotx contacts flow add email:[email protected] --flowId flow_billing_priority
  
All 3 agents completed tasks. Customer inquiry routed to priority queue.

Also Works with Claude Code & OpenClaw

ChatbotX Agent is a CLI & MCP tool: it works with any AI agent runtime that supports shell commands or MCP, including Claude Code and OpenClaw.

Claude Code

Terminal Coding Agent

Anthropic's terminal agent that completes development and automation tasks autonomously. Reads ChatbotX tool definitions and schedules content from natural language.

Explore Integration Docs

OpenClaw

Personal AI Agent

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