Actions113
- Account Agent Bots Actions
- Agents Actions
- Canned Responses Actions
- Canned Response Actions
- Custom Attributes Actions
- Contacts Actions
- Contact Actions
- Automation Rule Actions
- Help Center Actions
- Conversations Actions
- Conversation Assignment Actions
- Conversation Labels Actions
- Inboxes Actions
- Messages Actions
- Integrations Actions
- Teams Actions
- Custom Filters Actions
- Webhooks Actions
- Reports Actions
- Accounts Actions
- Account Users Actions
- Agent Bots Actions
- Users Actions
- Inbox API Actions
- Contacts API Actions
- Conversations API Actions
- Messages API Actions
- CSAT Survey Page Actions
Overview
This node operation allows you to create a webhook subscription in the ChatWoot system. By creating a webhook, you can configure ChatWoot to send event notifications to a specified URL whenever certain events occur in your account. This is useful for integrating ChatWoot with other systems or automating workflows based on real-time events.
Common scenarios include:
- Receiving notifications about new messages or conversations.
- Triggering external processes when specific events happen in ChatWoot.
- Synchronizing data between ChatWoot and other platforms by reacting to webhook events.
For example, you might create a webhook that sends conversation updates to your CRM system or triggers alerts in a monitoring tool.
Properties
| Name | Meaning |
|---|---|
| Account Id | The numeric ID of the ChatWoot account where the webhook will be created. |
| Url | The destination URL where ChatWoot should send the event payloads when subscribed events occur. |
| Subscriptions | A JSON array specifying the list of event types you want to subscribe to for this webhook. |
Output
The node outputs JSON data representing the response from the ChatWoot API after creating the webhook. This typically includes details about the newly created webhook such as its ID, status, subscribed events, and the target URL.
No binary data output is involved in this operation.
Dependencies
- Requires an active connection to the ChatWoot API.
- Needs an API authentication token configured in the node credentials to authorize requests.
- The base URL for the ChatWoot instance must be set in the credentials.
Troubleshooting
- Invalid Account Id: If the provided account ID does not exist or is incorrect, the API will return an error. Verify the account ID before running the node.
- Invalid URL: Ensure the URL is reachable and correctly formatted; otherwise, webhook delivery will fail.
- Malformed Subscriptions JSON: The subscriptions property must be valid JSON representing an array of event names. Invalid JSON will cause request failure.
- Authentication Errors: Check that the API key or token is valid and has sufficient permissions to create webhooks.
- Network Issues: Connectivity problems between n8n and the ChatWoot server can cause timeouts or failures.