n8n Integration
The n8n integration forwards Convor events to your self-hosted n8n workflow automation instance. When events happen in Convor (new conversations, messages, assi
The n8n integration forwards Convor events to your self-hosted n8n workflow automation instance. When events happen in Convor (new conversations, messages, assignments), an HTTP POST is sent to your n8n webhook. From there, you can build custom workflows to connect Convor to any service, automate tasks, or trigger notifications without writing code.
Prerequisites
- An n8n instance running and accessible from the internet
- A webhook URL from an n8n workflow
- Convor Growth plan or higher
Creating a Webhook in n8n
Open your n8n workflow editor. Add a Webhook node to your workflow. Set the HTTP Method to POST. n8n will generate a webhook URL. Copy this URL. Make sure your workflow is activated (toggle in the top-right corner), otherwise n8n will not process incoming requests.
# n8n webhook URL format
https://your-n8n-instance.com/webhook/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxxDashboard Configuration
In your Convor dashboard, open Integrations → n8n. Enter the webhook URL from your n8n workflow and choose which Convor events should be forwarded. Click Test Connection to send a sample event, then save.
{
"integration": "n8n",
"webhookUrl": "https://your-n8n-instance.com/webhook/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
"events": [
"new_conversation",
"new_message",
"conversation_closed",
"operator_assigned"
]
}Supported Events
| Event | Description | Payload Fields |
|---|---|---|
| new_conversation | A visitor starts a new conversation | conversation_id, visitor_id, page_url |
| new_message | A message is sent in a conversation | conversation_id, sender_type, content |
| conversation_closed | A conversation is marked as resolved | conversation_id, operator_id, resolution_time |
| operator_assigned | A conversation is assigned to an operator | conversation_id, operator_id, operator_name |
Features
| Feature | Description | Status |
|---|---|---|
| Event Forwarding | Send Convor events to n8n via HTTP POST webhooks | Supported |
| Custom Workflows | Build any automation in n8n based on Convor events | Supported |
| Self-hosted | No third-party service required, runs on your own infrastructure | Supported |
| No Auth Required | Webhook URLs are unique and don't need additional authentication | Supported |
Troubleshooting
Warning
If n8n is not receiving events, verify the workflow is activated in n8n. Inactive workflows do not process incoming webhook requests.
- Webhook URL format errors: The URL must be the full n8n webhook path including the unique UUID. Ensure there are no trailing slashes or typos
- n8n not receiving events: Check that the workflow is toggled to Active in the n8n editor. Inactive workflows silently drop incoming requests
- SSL issues: If your n8n instance uses a self-signed certificate, Convor will reject the connection. Use a valid SSL certificate or configure Convor to allow self-signed certs for your n8n domain
Czy ta strona była pomocna?