Fineguide AI User Guide

Appearance

n8n Integration ​

Connect FineGuide to n8n, a powerful workflow automation platform that lets your AI assistants trigger complex automations and connect with thousands of external services.

What is n8n? ​

n8n is an open-source workflow automation tool that allows you to connect various applications and services together. Think of it as a visual programming tool where you can create automated workflows without writing code.

Why integrate n8n with FineGuide?

  • Extend your assistant's capabilities — Your AI can trigger workflows that interact with CRMs, email services, databases, and more
  • Automate complex processes — Chain multiple actions together (e.g., create a ticket, send an email, update a spreadsheet)
  • Connect to 400+ services — Slack, Google Sheets, Salesforce, HubSpot, and many more
  • No coding required — Build workflows visually with drag-and-drop

Getting Started ​

Navigate to Settings → n8n Integration in your organization settings.

You have two options to connect n8n to FineGuide:

FineGuide can host and manage an n8n instance for you. This is the easiest way to get started.

Steps:

  1. Click "Get Started with n8n" on the n8n integration page
  2. Choose "🚀 Provision New Instance"
  3. Fill in the form:
FieldDescription
Admin EmailYour email for the n8n admin account
Admin PasswordA secure password (min 8 chars, must include uppercase, lowercase, and numbers)
  1. Accept the n8n Privacy Policy and Terms of Service
  2. Click "Setup n8n Instance"

What happens next:

  • FineGuide provisions a dedicated n8n instance for your organization
  • Your instance gets a unique subdomain: https://n8n-{id}.fineguide.ai/
  • You'll receive access within a few minutes
  • Click "Open n8n App" to access your instance directly from FineGuide
  • All updates, backups, and security are handled by FineGuide

Option 2: Connect an Existing Instance ​

Already using n8n? Connect your existing instance to FineGuide.

Prerequisites:

  • Your n8n instance must be accessible via HTTPS
  • You need an API token from your n8n instance

Getting your n8n API Token:

  1. Log into your n8n instance
  2. Go to Settings → API (or n8n API in older versions)
  3. Click "Create API Key" or copy an existing key
  4. Give it a descriptive name like "FineGuide Integration"

Connecting to FineGuide:

  1. Click "Get Started with n8n" on the n8n integration page
  2. Choose "🔗 Connect Existing Instance"
  3. Fill in the form:
FieldDescriptionExample
Instance URLThe full URL to your n8n instancehttps://n8n.yourcompany.com
API TokenYour n8n API keyn8n_api_...
  1. Click "Connect to n8n API"

FineGuide will validate the connection and display a success message if everything is configured correctly.

Managing Your Connection ​

Once connected, the n8n Integration page shows your connection status:

Connection Details ​

For managed instances, you'll see:

  • Instance status (Active/Inactive)
  • Instance URL (e.g., https://n8n-abc123def456.fineguide.ai/)
  • Creation date
  • "Open n8n App" button — One-click access to your n8n dashboard

For existing instances, you'll see:

  • Connection status
  • Instance URL
  • Last verified date

Available Actions ​

ActionDescription
RefreshRe-check the connection status
Update TokenChange the API token (for existing instances)
DisconnectRemove the n8n connection from FineGuide
Open n8n AppOpen your n8n dashboard (managed instances only)

Importing n8n Workflows as Actions ​

The real power of n8n integration comes from importing your workflows as Actions that your AI assistant can execute.

How It Works ​

  1. Create a workflow in n8n with a Webhook trigger
  2. Import that webhook into FineGuide as an Action
  3. Your AI assistant can now trigger the workflow during conversations

Step-by-Step Guide ​

1. Create a Webhook Workflow in n8n

In your n8n instance:

  1. Create a new workflow
  2. Add a Webhook node as the trigger
  3. Configure the webhook path (e.g., /create-ticket)
  4. Add the nodes for your automation (e.g., create Zendesk ticket, send Slack notification)
  5. Activate the workflow (important!)

2. Import the Webhook into FineGuide

In FineGuide:

  1. Go to your Assistant → Actions tab
  2. Click the "Import" dropdown
  3. Select "Import from n8n"
  4. A modal will show all your n8n workflows with webhook triggers
  5. Expand a workflow to see its individual webhooks
  6. Select the webhook you want to import
  7. Click "Import Webhook"

3. Configure the Action

After importing, the webhook becomes an Action:

  • Give it a descriptive name (e.g., "Create Support Ticket")
  • Add a description explaining what it does
  • Define the parameters the AI should collect from the user
  • Test the action to ensure it works

Example: Create Support Ticket ​

n8n Workflow:

Webhook (POST /support-ticket)
    ↓
Zendesk: Create Ticket
    ↓
Slack: Send Notification
    ↓
Respond to Webhook

Imported Action in FineGuide:

  • Name: Create Support Ticket
  • Description: Creates a support ticket in Zendesk and notifies the support team
  • Parameters: customer_email, issue_description, priority

User Interaction:

User: "I need help with my order"

Assistant: "I'd be happy to help! Let me create a support ticket for you. What's your email address?"

User: "[email protected]"

Assistant: "And can you describe the issue with your order?"

User: "My package hasn't arrived after 2 weeks"

[AI triggers the action, n8n workflow runs]

Assistant: "I've created a support ticket for you. Our team will reach out to [email protected] shortly. Your ticket number is #12345."

Best Practices ​

Workflow Design ​

  1. Always activate workflows — Inactive workflows won't respond to webhook calls
  2. Use descriptive webhook paths — /create-ticket is clearer than /webhook1
  3. Return useful responses — Configure your webhook to return confirmation data
  4. Handle errors gracefully — Add error handling in your n8n workflows

Security ​

  1. Use HTTPS — Your n8n instance should use SSL/TLS
  2. Rotate API tokens — Periodically update your API tokens
  3. Limit token permissions — Use tokens with minimal required permissions
  4. Keep n8n updated — Apply security patches regularly (managed instances do this automatically)

Performance ​

  1. Keep workflows fast — Long-running workflows may timeout
  2. Use async for heavy tasks — For complex automations, respond quickly and process in the background
  3. Monitor workflow executions — Check n8n's execution logs for failures

Troubleshooting ​

Connection Issues ​

ProblemSolution
"Failed to connect to n8n instance"Verify the URL is correct and accessible from the internet
"Invalid API token"Generate a new API token in n8n and update it in FineGuide
"Authentication failed"Ensure the API token has the required permissions
"Connection timeout"Check if your n8n instance is running and accessible

Webhook Import Issues ​

ProblemSolution
"No workflows found"Ensure you have workflows with Webhook triggers in n8n
"Workflow not showing"Make sure the workflow is saved (doesn't need to be active to appear)
"Import failed"Check that the webhook is properly configured in n8n

Action Execution Issues ​

ProblemSolution
"Action failed to execute"Verify the n8n workflow is active and the webhook is responding
"Timeout error"The workflow is taking too long; optimize it or increase timeouts
"Invalid response"Check the webhook response node in your n8n workflow

FAQ ​

Q: Do I need a paid n8n plan? A: No, n8n has a free tier and open-source option. FineGuide's managed instances are included in your subscription.

Q: Can I use multiple n8n instances? A: Currently, each organization can connect one n8n instance (either managed or external).

Q: What happens to my workflows if I disconnect? A: Your workflows in n8n remain intact. The imported Actions in FineGuide will stop working until you reconnect.

Q: Can the AI create new workflows? A: No, the AI can only trigger existing workflows. You design the workflows in n8n.

Next Steps ​