n8n Workflow Integration - AgentFlow Documentation

Overview

Connect your n8n workflows to AgentFlow to automate complex business processes. Trigger workflows from chat conversations, process data automatically, and receive structured responses.

Prerequisites

n8n Account

Self-hosted or n8n Cloud account

Webhook Access

Ability to create webhook nodes

API Key

n8n API key (optional, for authentication)

AgentFlow Admin

Admin access to AgentFlow

Step 1: Setup n8n Workflow

Create a New Workflow

Log in to your n8n instance
Click New Workflow
Name it: AgentFlow Chat Automation

Add Webhook Trigger

Click + to add a node
Search for Webhook
Configure the webhook:
- Method: POST
- Path: /agentflow-trigger
- Authentication: None (or API Key)
- Response Mode: Wait for Response
Copy the webhook URL (e.g., https://your-n8n-instance.com/webhook/abc123)

The webhook URL is your endpoint for AgentFlow integration.

Build Your Automation

Add nodes to process the incoming message:

Parse Input

Add a Set node to extract message data:

{
  "user_message": "{{ $json.trigger_data.message_content }}",
  "user_id": "{{ $json.trigger_data.user_id }}",
  "timestamp": "{{ $json.trigger_data.timestamp }}"
}

Process Data

Add business logic nodes:

HTTP Request - Call external APIs
Code - Custom JavaScript/Python
Database - Query/update data
AI - OpenAI, Anthropic nodes

Format Response

Add a Set node for the response:

{
  "data": {
    "execution_result": "{{ $json.processedData }}",
    "status": "success",
    "metadata": {
      "workflow_id": "{{ $workflow.id }}",
      "execution_id": "{{ $execution.id }}"
    }
  }
}

Return Response

Connect to Respond to Webhook node

Set response body to your formatted data
HTTP Status: 200

Example Workflow: Customer Support

Save and Activate

Click Save (Ctrl+S)
Toggle Active to enable the workflow
Note your webhook URL

Step 2: Create AI Connection in AgentFlow

Manual Setup

Go to Admin Dashboard → AI Models
Click Add Model
Fill in details:
- Name: n8n Customer Support Workflow
- Model ID: n8n-workflow-executor
- Description: Automated customer support via n8n
Configure API:
- Endpoint: https://your-n8n-instance.com/webhook/abc123
- Method: POST

Add headers (if using authentication):

{
  "n8n-api-key": "{{n8n_api_key}}",
  "Content-Type": "application/json",
  "User-Agent": "ChatPlatform/1.0"
}

Request schema:

{
  "workflow_id": "{{workflow_id}}",
  "trigger_data": {
    "message": "{{message}}",
    "user_id": "{{user_id}}",
    "timestamp": "{{timestamp}}"
  },
  "execution_mode": "trigger",
  "wait_for_completion": true,
  "timeout": 300
}

Response path: data.execution_result
Click Save

Step 3: Import via YAML Configuration

YAML Template

Create n8n-workflow-config.yaml:

name: "n8n Workflow Automation"
model_id: "n8n-workflow-executor"
description: "Execute n8n workflows via webhook triggers for automated task processing"
endpoint: "https://your-n8n-instance.com/webhook/{{workflow_id}}"
method: "POST"

headers:
  n8n-api-key: "{{n8n_api_key}}"
  Content-Type: "application/json"
  User-Agent: "ChatPlatform/1.0"

request_schema:
  workflow_id: "{{workflow_id}}"
  trigger_data:
    message: "{{message}}"
    user_id: "{{user_id}}"
    timestamp: "{{timestamp}}"
  execution_mode: "trigger"
  wait_for_completion: true
  timeout: 300

response_path: "data.execution_result"

message_format:
  preset: "custom"
  mapping:
    role:
      source: "role"
      target: "trigger_data.user_role"
      transform: "lowercase"
    content:
      source: "content"
      target: "trigger_data.message_content"
      transform: "none"
    timestamp:
      source: "timestamp"
      target: "trigger_data.timestamp"
      transform: "iso8601"
  customFields:
    - name: "workflow_metadata"
      value:
        platform: "n8n"
        version: "1.0"
        execution_type: "webhook"
      type: "object"
    - name: "retry_config"
      value:
        max_retries: 3
        retry_delay: 1000
        exponential_backoff: true
      type: "object"

suggestion_prompts:
  - "Create a workflow to process customer support tickets"
  - "Set up automated data synchronization between systems"
  - "Build a workflow for invoice processing and approval"
  - "Create an automated lead scoring workflow"
  - "Set up a workflow for social media content scheduling"

Import Process

Replace {{workflow_id}} with your actual webhook path
Go to Admin Dashboard → AI Models
Click Import Model
Upload n8n-workflow-config.yaml
Enter your n8n credentials
Click Import

Step 4: Assign to Group

Navigate to Admin Dashboard → Groups
Select target group (e.g., “Support Team”)
Click Manage Models
Enable n8n Workflow Automation
Set usage permissions:
- Can Execute: Yes
- Can View Logs: Yes
- Rate Limit: 100 requests/hour
Click Save

Step 5: Use in Chat

Trigger Workflow from Chat

Open Chat Interface
Start a New Conversation
Select n8n Workflow model
Send a message to trigger the workflow

Example Interactions

I need help with my billing issue. My last invoice shows duplicate charges for the Pro plan.

Response Handling

The workflow response appears as a chat message:

{
  "status": "success",
  "result": {
    "ticket_id": "SUP-12345",
    "assigned_to": "billing_team",
    "priority": "high",
    "eta": "2 hours"
  }
}

Advanced Workflows

Multi-Step Processing

Data Validation

// n8n Code node
const input = $input.item.json;

if (!input.message || !input.user_id) {
  throw new Error('Missing required fields');
}

return {
  validated: true,
  data: input
};

AI Analysis

Add OpenAI node:

Model: GPT-4
Prompt: Analyze: {{ $json.message }}
Extract: insights, sentiment, intent

Database Operations

INSERT INTO support_tickets (user_id, message, analysis, created_at)
VALUES (
  '{{ $json.user_id }}',
  '{{ $json.message }}',
  '{{ $json.ai_analysis }}',
  NOW()
)
RETURNING id;

External Integration

Call Slack, email, or other services with results

Conditional Logic

// Switch node condition
const sentiment = $json.sentiment;

if (sentiment === 'negative') {
  return [{ json: { route: 'urgent' } }];
} else if (sentiment === 'neutral') {
  return [{ json: { route: 'standard' } }];
} else {
  return [{ json: { route: 'low_priority' } }];
}

Error Handling

// Error trigger node
if ($json.error) {
  return {
    status: 'error',
    message: $json.error.message,
    retry_available: true
  };
}

Workflow Templates

1. Customer Support Automation

Nodes:
Webhook Trigger
Extract Message Data
Sentiment Analysis (OpenAI)
Check Knowledge Base (Database)
If No Match → Escalate to Human
If Match → Send Auto-Response
Create Ticket (if needed)
Respond to Webhook

2. Lead Qualification

Nodes:
Webhook Trigger
Parse Lead Data
Enrich with Clearbit
Score Lead (Custom Logic)
Update CRM (Salesforce)
If Score > 80 → Alert Sales
Respond with Score

3. Invoice Processing

Nodes:
Webhook Trigger
Extract Invoice Details
Validate Against Orders (Database)
Calculate Amounts
Generate PDF (n8n)
Send Email (SendGrid)
Update Billing System
Respond with Status

n8n Cloud vs Self-Hosted

n8n Cloud Setup

Sign up at n8n.cloud
Create workflow
Webhook URL: https://yourname.app.n8n.cloud/webhook/...
Built-in authentication
Automatic scaling

Self-Hosted Setup

Deploy n8n

# Docker
docker run -it --rm \
  --name n8n \
  -p 5678:5678 \
  -v ~/.n8n:/home/node/.n8n \
  n8nio/n8n

Configure Reverse Proxy

server {
  listen 443 ssl;
  server_name n8n.yourdomain.com;

  location / {
    proxy_pass http://localhost:5678;
    proxy_set_header Host $host;
  }
}

Setup Authentication

Environment variables:

N8N_BASIC_AUTH_ACTIVE=true
N8N_BASIC_AUTH_USER=admin
N8N_BASIC_AUTH_PASSWORD=secure_password

Get Webhook URL

Use: https://n8n.yourdomain.com/webhook/...

Troubleshooting

Webhook Timeout

Symptoms: Requests timeout after 30 secondsSolutions:

Increase timeout in AgentFlow config: timeout: 300
Use async execution in n8n
Optimize workflow performance

Authentication Errors

Symptoms: 401 Unauthorized responsesSolutions:

Verify API key is correct
Check header format: n8n-api-key
Ensure webhook authentication matches

Response Not Received

Symptoms: Empty or malformed responsesSolutions:

Check response path: data.execution_result
Verify “Respond to Webhook” node
Test workflow manually in n8n

Workflow Not Triggering

Symptoms: Webhook receives request but workflow doesn’t executeSolutions:

Ensure workflow is Active
Check webhook node configuration
Review n8n execution logs

Monitoring & Debugging

n8n Execution Logs

Go to Executions in n8n
Filter by workflow
View detailed execution data
Check error messages

AgentFlow Analytics

Navigate to Analytics Dashboard
Select n8n Workflow model
Monitor:
- Success rate
- Response times
- Error patterns

Webhook Testing

# Test webhook directly
curl -X POST https://your-n8n-instance.com/webhook/abc123 \
  -H "Content-Type: application/json" \
  -d '{
    "trigger_data": {
      "message": "test message",
      "user_id": "test-user",
      "timestamp": "2024-01-15T10:30:00Z"
    }
  }'

Best Practices

Error Handling

Always include error handling nodes and fallback responses

Timeout Management

Set appropriate timeouts for long-running processes

Data Validation

Validate all incoming data before processing

Security

Use API keys and HTTPS for all webhooks

Logging

Log executions for debugging and compliance

Testing

Test workflows thoroughly before production

Next Steps

Make.com Integration

Alternative automation platform

Cloud Functions

Serverless processing

Relay Workflows

Business process automation

Analytics

Monitor workflow performance

AI Providers

Workflow Automation

Advanced Integrations

​Overview

​Prerequisites

n8n Account

Webhook Access

API Key

AgentFlow Admin

​Step 1: Setup n8n Workflow

​Create a New Workflow

​Add Webhook Trigger

​Build Your Automation

​Example Workflow: Customer Support

​Save and Activate

​Step 2: Create AI Connection in AgentFlow

​Manual Setup

​Step 3: Import via YAML Configuration

​YAML Template

​Import Process

​Step 4: Assign to Group

​Step 5: Use in Chat

​Trigger Workflow from Chat

​Example Interactions

​Response Handling

​Advanced Workflows

​Multi-Step Processing

​Conditional Logic

​Error Handling

​Workflow Templates

​1. Customer Support Automation

​2. Lead Qualification

​3. Invoice Processing

​n8n Cloud vs Self-Hosted

​n8n Cloud Setup

​Self-Hosted Setup

​Troubleshooting

​Monitoring & Debugging

​n8n Execution Logs

​AgentFlow Analytics

​Webhook Testing

​Best Practices

Error Handling

Timeout Management

Data Validation

Security

Logging

Testing

​Next Steps

Make.com Integration

Cloud Functions

Relay Workflows

Analytics

Overview

Prerequisites

Step 1: Setup n8n Workflow

Create a New Workflow

Add Webhook Trigger

Build Your Automation

Example Workflow: Customer Support

Save and Activate

Step 2: Create AI Connection in AgentFlow

Manual Setup

Step 3: Import via YAML Configuration

YAML Template

Import Process

Step 4: Assign to Group

Step 5: Use in Chat

Trigger Workflow from Chat

Example Interactions

Response Handling

Advanced Workflows

Multi-Step Processing

Conditional Logic

Error Handling

Workflow Templates

1. Customer Support Automation

2. Lead Qualification

3. Invoice Processing

n8n Cloud vs Self-Hosted

n8n Cloud Setup

Self-Hosted Setup

Troubleshooting

Monitoring & Debugging

n8n Execution Logs

AgentFlow Analytics

Webhook Testing

Best Practices

Next Steps