chatbotx

n8n community nodes for the ChatbotX Public API and webhooks

Package Information

Released: 1 mo ago
Downloads: 0 weekly / 0 monthly
Latest Version: 0.1.4
Author: ChatbotXIO

Available Nodes

Documentation generating…

ChatbotX icon
ChatbotX
Manage contacts and call the ChatbotX Public API
ChatbotX Trigger - Watch Events icon
ChatbotX Trigger - Watch Events
Starts a workflow when a subscribed event occurs in ChatbotX
ChatbotX Trigger - Watch Flow Data icon
ChatbotX Trigger - Watch Flow Data
Starts a workflow when a ChatbotX flow step sends data to this trigger

Documentation

n8n-nodes-chatbotx

An n8n community node package for the ChatbotX Public API and webhooks.

n8n is a fair-code licensed workflow automation platform.

Installation
Credentials
Nodes
Compatibility
Resources

Installation

n8n Cloud / Settings > Community Nodes

Install n8n-nodes-chatbotx from Settings > Community Nodes in n8n.

Self-hosted (Docker)

Build the package (npm run build), then copy the resulting .tgz into your n8n container's custom nodes directory:

ID=$(docker compose ps -q n8n)
docker cp n8n-nodes-chatbotx-<version>.tgz "$ID:/tmp/node.tgz"
docker compose exec -u node n8n sh -lc 'mkdir -p /home/node/.n8n/nodes && cd /home/node/.n8n/nodes && npm install --omit=dev /tmp/node.tgz'
docker compose restart n8n

Refresh n8n (Ctrl + F5) and search for ChatbotX.

Credentials

  1. In ChatbotX, open Settings > Integrations > ChatbotX API Access Token.
  2. Create a ChatbotX API credential in n8n.
  3. Keep https://app.chatbotx.io/api for ChatbotX Cloud. For self-hosted ChatbotX, use https://your-domain/api.
  4. Paste the workspace API token and test the credential.

Nodes

ChatbotX (action node)

Two resources:

  • Contact: List, Get, Create, Update or Create, Delete, Find by Custom Field, Set Custom Fields, Delete Custom Field, Add Tags, Remove Tags, Send Message, Send Flow.
  • Custom: API Call — an arbitrary authorized call to any ChatbotX Public API endpoint (method + path + JSON body), for endpoints not covered by the actions above.

Contact identifiers accept ChatbotX's documented formats: id:11590944070189056, email:user@example.com, phone:+84908123456 (a bare ID, email, or E.164 phone number is also accepted).

ChatbotX Trigger - Watch Events

Starts a workflow whenever a subscribed system event occurs in the workspace (new contact, tag applied, custom field changed, conversation assigned, etc.), independent of any flow. The trigger automatically registers and unregisters its webhook URL with ChatbotX when the workflow is activated/deactivated.

Some events accept an optional Source ID filter (e.g. a specific tag or sequence). Leave it empty to match the event for any source.

ChatbotX Trigger - Watch Flow Data

Starts a workflow when a ChatbotX bot flow reaches a "Make" step configured with a matching Event Name. Like the events trigger, it registers/unregisters itself automatically.

Compatibility

Tested against n8n's programmatic node API (n8nNodesApiVersion: 1) and n8n-workflow 2.x. Supports ChatbotX Cloud and self-hosted installations.

Resources

License

MIT

Discussion