Description
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-.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.
- n8n community nodes documentation
- ChatbotX API reference
Contact identifiers accept ChatbotX’s documented formats: id:11590944070189056, email:[email protected], 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
