Description
n8n-nodes-epicai
This node lets you interact with the Epic AI API. Epic AI is a platform for building individually configurable flow- and AI-driven chat, voice, and email bots. It allows you to manage contacts, conversations, messages, notes, variables, and statistics directly from your n8n workflows.
Installation
In n8n go to Settings → Community Nodes → Install and enter:
n8n-nodes-epicai
Credentials
1. In n8n go to Credentials → New
2. Search for Epic AI API
3. Enter your ChatCaptain API Key
You can find your API key in the ChatCaptain dashboard under Settings → API.
> Note: The Body (JSON) fields in this node show only the required parameters for each operation. Additional optional parameters are available — see the API documentation for the full reference.
Resources & Operations
Contact
| Operation | Description |
|—|—|
| Create Contact | Create a new contact |
| Delete Contact | Delete a contact |
| Get All Contacts | Retrieve all contacts |
| Get All Variables | Retrieve all variables of a contact |
| Get Contact | Retrieve a single contact |
| Get Variable | Retrieve a specific variable of a contact |
| Set / Update Variable | Set or update a variable of a contact |
| Update Contact | Update a contact |
Conversation
| Operation | Description |
|—|—|
| Create Conversation | Create a new conversation |
| Create Note | Add a note to a conversation |
| Delete Note | Remove a note from a conversation |
| Get All Conversations | Retrieve all conversations — optionally filter by contactId or channelId |
| Get All Messages | Retrieve all messages of a conversation |
| Get All Variables | Retrieve all variables of a conversation |
| Get Conversation | Retrieve a single conversation |
| Get Message | Retrieve a single message |
| Get Variable | Retrieve a specific variable |
| Send Message as Agent | Send a message as an agent (via inbox) |
| Send Message as User | Send a message as a user |
| Set / Update Variable | Set or update a conversation variable |
| Trigger Custom Event | Trigger a custom event in a conversation |
| Update Conversation | Update a conversation |
Variable
| Operation | Description |
|—|—|
| Create Global Variable | Create a new global chatbot variable |
| Delete Global Variable | Delete a global chatbot variable |
Statistic
| Operation | Description |
|—|—|
| Create Export | Start a statistics export for a given time range — returns an exportId |
| Get Export | Retrieve the status and download link of a statistics export |
Examples
Contact: Create a Contact
Use case: A new customer submits a sign-up form on your website. An n8n workflow receives the form data via webhook and automatically creates a contact in ChatCaptain — so the chatbot can immediately greet them by name and has their details on file.
Configure the node as follows:
| Field | Value |
|—|—|
| Resource | Contact |
| Operation | Create Contact |
| Chatbot ID | abc123 |
Body (JSON):
{
"name": "Jane Doe",
"language": "EN",
"email": "[email protected]",
"phoneNumber": "+4917612345678"
}
Expected result:
{
"id": "contact_xyz789",
"name": "Jane Doe",
"email": "[email protected]",
"phoneNumber": "+4917612345678",
"language": "EN"
}
—
Conversation: Send a Message as Agent
Use case: Your order management system detects that a shipment is delayed. An n8n workflow automatically sends a proactive message to the affected customer’s open conversation in ChatCaptain — so the customer is informed without a human agent having to intervene manually.
Configure the node as follows:
| Field | Value |
|—|—|
| Resource | Conversation |
| Operation | Send Message as Agent |
| Chatbot ID | abc123 |
| Conversation ID | conv_xyz789 |
Body (JSON):
{
"text": "We wanted to let you know that your order is slightly delayed. We expect delivery within 2 additional business days. Sorry for the inconvenience!"
}
Expected result:
{
"id": "msg_abc001",
"text": "We wanted to let you know that your order is slightly delayed. We expect delivery within 2 additional business days. Sorry for the inconvenience!",
"sender": "agent",
"created": "2026-04-24T10:00:00Z"
}
—
Variable: Set / Update a Conversation Variable
Use case: Customer data has changed in your ERP system (e.g. a new shipping address or updated loyalty tier). An n8n workflow picks up the change and updates the corresponding variable in the active ChatCaptain conversation — so the chatbot immediately has access to the latest data and can respond accordingly without the customer needing to repeat themselves.
Configure the node as follows:
| Field | Value |
|—|—|
| Resource | Conversation |
| Operation | Set / Update Variable |
| Chatbot ID | abc123 |
| Conversation ID | conv_xyz789 |
| Variable ID | var_def456 |
Body (JSON):
{
"value": "Gold"
}
Expected result:
{
"id": "var_def456",
"name": "loyalty_tier",
"value": "Gold"
}
—
Contact: Set / Update a Contact Variable
Use case: A customer completes a purchase in your online shop. An n8n workflow picks up the order event and updates a contact variable in ChatCaptain — for example the customer’s loyalty tier — so the chatbot can immediately reference the updated value in future conversations without the customer having to re-confirm their status.
Configure the node as follows:
| Field | Value |
|—|—|
| Resource | Contact |
| Operation | Set / Update Variable |
| Chatbot ID | abc123 |
| Contact ID | contact_xyz789 |
| Variable ID | var_def456 |
Body (JSON):
{
"value": "Gold"
}
Expected result:
{
"id": "var_def456",
"name": "loyalty_tier",
"value": "Gold"
}
—
Statistic: Export and Download Statistics
Use case: At the end of each month your operations team needs a CSV report of all chatbot statistics. An n8n workflow triggers on a schedule, starts the export, polls until it completes, and then passes the download link to a follow-up step (e.g. send via email or save to Google Drive).
Step 1 — Create Export:
| Field | Value |
|—|—|
| Resource | Statistic |
| Operation | Create Export |
| Chatbot ID | abc123 |
| From | 2025-01-01T00:00:00.000Z |
| To | 2025-01-31T23:59:59.999Z |
Expected result:
{
"exportId": "0512277ec44ddfa169ea2a7f645b5be5..."
}
Step 2 — Get Export (poll until status is completed):
| Field | Value |
|—|—|
| Resource | Statistic |
| Operation | Get Export |
| Chatbot ID | abc123 |
| Export ID | 0512277ec44ddfa169ea2a7f645b5be5... |
Expected result:
{
"status": "completed",
"downloadLink": "https://storage.googleapis.com/..."
}
API Documentation
https://api.chatcaptain.com/api
https://docs.chatcaptain.com/api-dokumentation
