NexvioAI n8n Integration

Complete guide for connecting NexvioAI to n8n, installing the community node, configuring triggers and actions, and automating your support workflows.

Prerequisites

Before you begin, ensure you have the following ready:

An n8n instance — n8n Cloud or self-hosted n8n (v1.x or later). Community nodes must be enabled on self-hosted instances.
A NexvioAI account — Sign up at app.nexvio.ai if you don't have one.
At least one active NexvioAI project — You need a project created and active in NexvioAI.
At least one NexvioAI agent — Required for the Send Message action and AI-powered replies.

Install the Nexvio Community Node

NexvioAI connects to n8n through the official community node package n8n-nodes-nexvio.

n8n Cloud

Open your n8n Cloud workspace.
Go to Settings → Community nodes.
Click Install a community node.
Enter n8n-nodes-nexvio and confirm the installation.
After installation, search for Nexvio when adding nodes to a workflow.

Self-hosted n8n

Ensure community nodes are enabled in your n8n instance configuration.
Install via the Community nodes UI (same steps as n8n Cloud), or run npm install n8n-nodes-nexvio in your n8n custom nodes directory if your setup uses manual installs.
Restart n8n if prompted, then search for Nexvio in the node picker.

Connecting NexvioAI to n8n

NexvioAI supports OAuth2 (recommended) and API key authentication. OAuth is the easiest way to connect from the n8n credentials screen.

Option A: OAuth2 (recommended)

In n8n, open Credentials and create a new Nexvio OAuth2 API credential.
Click Connect my account. You are redirected to NexvioAI to sign in.
Review the requested permissions (see Scopes & Permissions below).
Select the correct NexvioAI project if prompted, then click Approve.
Return to n8n — the credential should show as connected. Run a test on any Nexvio node to verify.

On n8n Cloud, OAuth works out of the box. If you use self-hosted n8n and see an invalid redirect error during OAuth, contact support@nexvio.ai with your n8n callback URL so it can be allowlisted for your workspace.

Option B: API key

In the NexvioAI Dashboard, go to Integrations and create or copy an API key (nex_...).
In n8n, create a Nexvio API credential and paste the API key.
Save and test the credential on a Nexvio node.

API keys grant full n8n integration access without OAuth redirects — useful for headless or server workflows.

Available Triggers

Nexvio trigger nodes fire when events happen in your NexvioAI project. Add a Nexvio Trigger node at the start of your workflow and select the event type.

Trigger	When it fires
Contact Created	A new contact is created in your NexvioAI project.
Ticket Created	A new support ticket is opened in your project.
Form Created	A new form is created in NexvioAI.
Form Submission Created	Someone submits data to one of your NexvioAI forms.

When you activate a workflow with a Nexvio trigger, n8n registers a webhook with NexvioAI automatically. Deactivating or deleting the workflow removes the webhook.

Available Actions

Add a Nexvio action node to send data to NexvioAI or invoke your AI agents.

Resource / Operation	What it does
Message → Send	Sends a message to a NexvioAI agent and returns the AI reply. Use a stable external conversation ID to continue the same chat across workflow runs.
Contact → Create	Creates or updates a contact by email address with name, phone, company, and other fields.
Ticket → Create	Opens a new support ticket with subject, priority, requester details, and optional tags.
Form → Create	Creates a new form in your NexvioAI project.
Form → Submit	Submits data to an existing NexvioAI form.
Agent → List	Lists agents in your project — used to populate the agent picker on Send Message nodes.

Keeping conversation context

When using Send Message, pass the same external_conversation_id on every run if you want the agent to remember prior messages (for example, telegram:123456789 or your CRM record ID). Leave it blank or enable Start New Session to begin a fresh chat.

Example Workflows

New ticket → Slack alert — Nexvio Trigger (Ticket Created) → Slack node to notify your team channel.
Form submission → CRM contact — Nexvio Trigger (Form Submission Created) → Nexvio Contact Create with mapped fields.
Inbound webhook → AI reply — Webhook node → Nexvio Send Message → HTTP Response or email node with the AI reply.
Scheduled digest — Schedule Trigger → Nexvio Send Message asking your agent to summarize open tickets → send result to Gmail or Notion.

Disconnecting

Option A: Disconnect from NexvioAI Dashboard

Go to the Integrations page in your NexvioAI Dashboard.
Find the n8n connection under Connected Platforms and click Disconnect.
OAuth tokens are revoked immediately and any n8n trigger webhooks for that connection are removed.

Option B: Disconnect from n8n

Open Credentials in n8n and delete the Nexvio credential.
Deactivate or delete workflows that use Nexvio trigger nodes so webhooks are cleaned up.

Your Data & Privacy

What data NexvioAI accesses via n8n

Your NexvioAI account email, name, and project information (for the connection label)
Contact, ticket, form, and conversation data from your project (to power triggers and actions)
Agent configuration for AI reply actions

What NexvioAI stores for the n8n connection

OAuth access and refresh tokens — stored as SHA-256 hashes; raw tokens are never persisted in plaintext
Webhook subscription URLs for active n8n trigger workflows
Connection metadata: client ID, email, project name, and granted scopes

What happens when you disconnect

All OAuth access and refresh tokens are immediately revoked
All webhook subscriptions for the n8n connection are deleted
Contact, ticket, and form data created through n8n actions remains in your NexvioAI project

Scopes & Permissions

During OAuth authorization, NexvioAI requests the following scopes:

Scope	Why NexvioAI needs it
`read:contacts`	To include contact data in trigger payloads
`write:contacts`	To create or update contacts from action nodes
`read:conversations`	To read conversation context for AI replies
`write:conversations`	To send messages and receive AI responses
`read:agents`	To list agents and load agent configuration
`write:agents`	To register and remove trigger webhooks with n8n
`read:forms` / `write:forms`	To create forms, submit form data, and fire form-related triggers
`write:tickets`	To create support tickets from workflow actions

Troubleshooting

Problem	Fix
OAuth fails with invalid redirect	n8n Cloud works automatically. For self-hosted n8n, contact support@nexvio.ai with your exact OAuth callback URL.
Credential test fails	Reconnect OAuth or verify your API key is active. Ensure you approved the correct NexvioAI project during consent.
Trigger does not fire	Confirm the workflow is active in n8n. Create a test event in NexvioAI (e.g. a new contact) and check n8n execution history.
Agent has no memory between runs	Reuse the same `external_conversation_id` on every Send Message call. Do not enable Start New Session unless you want a fresh chat.
Nexvio node not found	Install `n8n-nodes-nexvio` from Community nodes and restart n8n if required.

Need Help?

Email support@nexvio.ai or visit the n8n integration page for an overview of what you can automate with NexvioAI and n8n.