Superchat connects to n8n via webhooks, allowing you to trigger workflows automatically based on events in Superchat — such as a new contact being created or a conversation being opened. This article covers the setup steps, a worked example, and common troubleshooting tips.
Before you begin
Make sure you have the following in place before starting:
An active Superchat account
A working n8n instance (cloud or self-hosted)
Basic familiarity with creating workflows and adding nodes in n8n
Connect Superchat to n8n
In n8n, create a new workflow and add a Webhook node as the trigger
Set the HTTP method to POST and copy the Test Webhook URL
In Superchat, navigate to Settings → Integrations → Webhooks and create a new webhook
Paste the n8n webhook URL into the URL field and select the event(s) you want to trigger the workflow
Back in n8n, click Listen for test event
Trigger the selected event in Superchat (for example, create a new contact) to send a test payload to n8n
Once n8n receives the payload, you will see the incoming data in the editor — your connection is working
Test URL vs production URL
n8n generates two separate URLs for every Webhook node — a test URL and a production URL.
The test URL only receives data while you have clicked Listen for test event in the n8n editor. It is for building and debugging only, and times out after 120 seconds.
The production URL is the one you should paste into Superchat once your workflow is ready. It only becomes active once you have saved and activated your workflow using the toggle in the top right of the n8n canvas. If your workflow is not activated, events from Superchat will not trigger anything.
What data does Superchat send?
When a webhook event fires, Superchat sends a JSON payload to n8n containing details about the event. For a full reference of the fields included for each event type, see the Superchat Webhook Object Model in the developer documentation.
To inspect a live payload during development, use the test URL, trigger an event in Superchat, and view the raw output directly in the n8n editor.
Worked example: add a new Superchat contact to Google Sheets
This example creates a new row in a Google Sheet every time a contact is created in Superchat.
Set up the Webhook node as described above and send a test event from Superchat so n8n has sample data to work with
Add a Google Sheets node and connect it to the Webhook node
Set the operation to Append Row
Select your target spreadsheet and sheet
Map the fields from the Superchat payload to the relevant columns — refer to the Webhook Object Model for the exact field names
Click Test step to verify a row is created correctly
Once confirmed, switch the Webhook node to the production URL, save the workflow, and activate it
Your workflow will now run automatically every time a new contact is created in Superchat.
Troubleshooting
The workflow is not triggering Check that your workflow is activated and that the production URL — not the test URL — is saved in Superchat.
Data is arriving but fields are empty Open the Executions panel in n8n (left-hand sidebar) to inspect the raw payload received. This shows exactly what Superchat sent and helps identify any mapping issues.
The test event is not being received Make sure you have clicked Listen for test event in n8n before triggering the event in Superchat. The test URL times out after 120 seconds — if it has expired, click it again before retrying.