> ## Documentation Index
> Fetch the complete documentation index at: https://docs.knotie-ai.pro/llms.txt
> Use this file to discover all available pages before exploring further.

# N8N chat agents

> Create chat agents powered by N8N workflows and embed them as widgets for customers.

## What N8N Chat Agents are

N8N Chat Agents let you create a chat assistant that runs on an N8N workflow.

Use cases:

* Website chat support
* Lead qualification
* FAQ + routing

## Where to find it

1. Open **AI Agents** (in the main sidebar).
2. Expand the **Chat Agents** sub-group.
3. Click the **N8N Chat Agents** card.

## Create a chat agent

1. Click **Create Chat Agent** (the create button on the page).
2. Fill in **Agent Name** and (optionally) a **Description**.
3. Choose the **Customer** (required).
4. Pick an **Integration Mode**. The modal currently offers two:
   * **Proxy Mode** — labelled **ENABLED**; "Direct integration with enhanced analytics". This is the only mode you can select today, and it uses the N8N Official Widget by default.
   * **Knotie Chat Node** — labelled **UPCOMING**; "Custom N8N node with advanced features". Not yet selectable.
5. Paste your **N8N Webhook URL** (your N8N Chat Trigger webhook) and note the **Webhook Secret** / Basic Auth credentials shown in the modal.
6. Optionally set a **Billing Mode** (Per Conversation, Per Message Exchange, Per 10 Messages, or Per Minute) and **Status**, then save.

<Note>
  **Proxy Mode is currently the only enabled integration mode** — Knotie Chat Node shows an **UPCOMING** badge and can't be picked yet. If you need the custom-node integration, check back later or contact Knotie support for availability.
</Note>

## Connect your webhook

If your agent uses a webhook URL:

* Copy the webhook URL from the agent settings.
* Paste it into your N8N workflow trigger.

## Generate a widget

Many teams embed chat agents as widgets.

1. Open the agent actions.
2. Choose the widget option.
3. Copy the embed snippet.

## Edit or delete

Use the actions menu to:

* Edit agent settings
* Delete an agent

## Troubleshooting

* **Create is blocked by plan limits**
  * Upgrade prompts can appear if you hit plan limits.

## Screenshots

<img src="https://mintcdn.com/kno2getherlabsltd/OcV0TG48maU0R4kd/images/Screenshot2025-12-28at02.10.39.png?fit=max&auto=format&n=OcV0TG48maU0R4kd&q=85&s=7c9e816dcf9c55a47b173b8e8a220239" alt="N8N Chat Agents empty state with Custom Node Mode and Proxy Mode setup cards and Create Your First Chat Agent button" width="1440" height="900" data-path="images/Screenshot2025-12-28at02.10.39.png" />

<img src="https://mintcdn.com/kno2getherlabsltd/WryrjG4tbrylo6dR/images/Screenshot2025-12-28at02.10.51.png?fit=max&auto=format&n=WryrjG4tbrylo6dR&q=85&s=1612ca8c94ca4ee420d5848d2b2f0b34" alt="Create N8N Chat Agent modal with Basic Information fields (Agent Name, Description, Customer), Integration Configuration (Proxy Mode enabled / Knotie Chat Node coming soon), and Widget settings" width="3024" height="1460" data-path="images/Screenshot2025-12-28at02.10.51.png" />