Important: This documentation covers Yarn 1 (Classic).
For Yarn 2+ docs and migration guide, see yarnpkg.com.

Package detail

n8n-nodes-chat-data

chat-data-llc1.5kMIT1.0.6TypeScript support: included

Chatdata integration for n8n. Manage chatbots, send messages, and retrieve leads from your Chatdata account.

n8n-community-node-package, chatbots, chat-data, AI agents, conversations, customer support

readme

Banner image

n8n-nodes-chat-data

This is the official n8n integration for Chat Data. It provides nodes to interact with the ChatData platform, allowing you to manage chatbots, send messages, retrieve leads, and more.

Prerequisites

To use the ChatData integration, you must have:

  • A paid ChatData account. You can create an account at chat-data.com.
  • Your ChatData API key, which you can obtain from your account settings.

Installation

Follow these steps to install this node in your n8n instance:

npm install n8n-nodes-chat-data

For n8n desktop app/local installation:

n8n-node-dev --install n8n-nodes-chat-data

Node Reference

Chat Data

This node can be found in the 'Action' category in n8n.

Operations

The operations in this node are organized into the following categories:

Action
  • Send a Message: Send a chat message to a chatbot
  • Get Leads: Retrieve customer leads from a chatbot
  • Get Conversations: Retrieve conversation history from a chatbot
Chatbot
  • Create Chatbot: Set up a new AI-powered chatbot
  • Retrain Chatbot: Update a chatbot with new data
  • Update Base Prompt: Modify a chatbot's base prompt
  • Get Chatbot Training Status: Check the status of a chatbot's training
Other
  • Make API Call: Make a custom request to any Chat Data API endpoint

Chat Data Trigger

This node is used to receive real-time events from Chat Data via webhooks. You can find it in the 'Trigger' category in n8n.

Available Triggers

  • On New Message: Triggered when a new chat message is received
  • On Lead Submission: Triggered when a customer submits lead information

  • On Live Chat Escalation: Triggered when a chat is escalated to a human agent

  • After setting up the trigger, you'll see webhook registration details in the execution output

  • When a webhook event is received, the node logs detailed information about:
    • Raw webhook payload
    • Parsed event data
    • Event type matching
    • Chatbot ID verification

Note: If your webhook isn't triggering as expected, check the n8n logs for messages starting with "Webhook triggered" to see detailed information about incoming data.

Important: For webhook testing, ensure the chatbot_id in your trigger configuration matches the chatbot_id field in the incoming webhook payload.

Migration Notice

If you are upgrading from a previous version:

Triggers (webhook-based events) have been moved from the main Chat Data node to a new, dedicated node called Chat Data Trigger. Please update your workflows to use the new trigger node for webhook-based automations.

Authentication

This node requires an API Key for authentication. To set this up:

  1. Create an API key in your ChatData account:

    • Log in to your ChatData account
    • In the top right corner, click your Username > Account Settings
    • In the API Keys section, click Create a new secret key
    • Copy the API key value

  2. In n8n, create a new credential:

    • Choose "ChatDataApi" as the credential type
    • Enter your API key in the API Key field
    • Enter your Chat Data instance URL (usually https://app.chat-data.com)
    • Save the credential

Further Information

License

MIT