Omnichannel Automation CLI for OpenAI Codex

Automate customer conversations, CRM webhooks, and chatbot flows. Built for OpenAI Codex and developer agent environments to test, deploy, and monitor ChatbotX operations from the terminal.

Read the Docs Start for $0

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

Quick Start: Install & Run ChatbotX CLI with OpenAI Codex

Install ChatbotX CLI for OpenAI Codex coding sessions, terminal scripting, and automated pipelines.

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 contact and execute flow trigger
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 OpenAI Codex?

OpenAI Codex is the AI model architecture that translates natural language into code and terminal actions. It powers developer tools, automated terminal workflows, and code execution environments.

⌨️

Code-Level Execution

Codex understands CLI parameters, JSON payloads, and shell scripts. It composes precise ChatbotX API requests with zero syntax errors.

🧪

Automated Testing

Test chatbot flows, verify contact custom fields, and audit webhook deliveries directly from automated CI/CD and developer terminal test suites.

🛠️

Developer Tooling

Inspect error logs, query connected WhatsApp/Telegram integrations, and manage bot fields programmatically without touching a GUI.

How ChatbotX Works with OpenAI Codex

OpenAI Codex interacts directly with ChatbotX CLI in your terminal and IDE. It generates automation scripts, inspects API responses, and manages omnichannel flows with zero boilerplate.

Developer Session With Codex

Prompt Codex to verify ChatbotX integrations, test contact updates, and validate automated customer journeys directly from the terminal.

Interactive Session Simulation

Autonomous

$ codex "Check webhook error logs in ChatbotX, verify contact [email protected], and trigger flow_test"

Codex generating and executing commands:
  1. Inspecting error logs:
     $ chatbotx error-logs list --perPage 5
     -> Status: 200 OK. No critical webhook delivery failures.
     
  2. Resolving test contact:
     $ chatbotx contacts get email:[email protected]
     -> Found: Test User (ID: c_test_01)
     
  3. Triggering test flow:
     $ chatbotx contacts flow add email:[email protected] --flowId flow_test
     -> Flow flow_test triggered successfully on WhatsApp channel.
     
Done! Error logs clean and test flow executed successfully.

Also Works with Claude Code & OpenClaw

ChatbotX Agent is a CLI & MCP tool: it works with any AI agent runtime that can run shell commands, including Anthropic's Claude Code.

Claude Code

Anthropic Terminal Agent

Agentic coding tool by Anthropic that runs in your terminal. Discovers ChatbotX CLI commands, tags contacts, and executes automated customer sequences seamlessly.

Explore Integration Docs

OpenClaw

Personal AI Agent

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