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 updates an existing webhook in the ChatWoot system. It allows users to modify the URL where webhook events are sent and adjust the list of event subscriptions for that webhook. This is useful when you want to change the destination endpoint for webhook notifications or update which events trigger those notifications without creating a new webhook from scratch.
Practical examples include:
- Changing the webhook URL after migrating your receiving service to a new domain.
- Adding or removing event types you want to listen to, such as subscribing to new message events or unsubscribing from user activity events.
Properties
| Name | Meaning |
|---|---|
| Account Id | The numeric ID of the account to which the webhook belongs. |
| Webhook Id | The numeric ID of the webhook you want to update. |
| Url | The new URL where the webhook events should be sent. |
| Subscriptions | A JSON array specifying the events you want to subscribe to for this webhook. |
Output
The node outputs JSON data representing the updated webhook object returned by the ChatWoot API. This typically includes details such as the webhook's ID, URL, subscribed events, status, and timestamps. There is no indication that binary data is output by this node.
Dependencies
- Requires an API key credential for authenticating with the ChatWoot API.
- The base URL for the ChatWoot instance must be configured in the credentials.
- The node uses the ChatWoot REST API to perform the update operation.
Troubleshooting
- Invalid Account or Webhook ID: If the provided account or webhook IDs do not exist or are incorrect, the API will return an error. Verify these IDs before running the node.
- Malformed Subscriptions JSON: The subscriptions property expects valid JSON. Invalid JSON syntax will cause parsing errors. Ensure the JSON array is correctly formatted.
- Unauthorized Access: Missing or invalid API credentials will result in authentication errors. Confirm that the API key and base URL are correctly set in the node credentials.
- URL Validation: Providing an invalid URL format may cause the API to reject the update. Use a properly formatted URL starting with http:// or https://.
Links and References
- ChatWoot API Documentation (for detailed webhook API endpoints and payloads)
- Webhook Concepts (general understanding of webhooks)