ChatWoot icon

ChatWoot

Interact with ChatWoot API

Actions113

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 event handling service.
  • Adding or removing event types you want to listen to, such as message received, conversation status changes, etc.

Properties

Name Meaning
Account Id The numeric ID of the ChatWoot account under which the webhook exists.
Webhook Id The numeric ID of the webhook you want to update.
Url The new URL where webhook events should be sent.
Subscriptions A JSON array specifying the event types 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, and other metadata confirming the update was successful.

No binary data output is involved.

Dependencies

  • Requires an API key credential for authenticating with the ChatWoot API.
  • Needs the base URL of the ChatWoot instance configured in credentials.
  • Depends on the ChatWoot REST API being accessible and operational.

Troubleshooting

  • Invalid Account or Webhook ID: If the provided IDs do not exist or belong to another user, the API will return an error. Verify the IDs before running the node.
  • Malformed Subscriptions JSON: The subscriptions property must be valid JSON. Errors parsing this field will cause the request to fail.
  • URL Validation: Ensure the URL is a valid and reachable endpoint; otherwise, webhook delivery will fail after update.
  • Authentication Errors: Check that the API key credential is correct and has sufficient permissions.
  • API Connectivity Issues: Network problems or incorrect base URL configuration can prevent the node from reaching the ChatWoot API.

Links and References

Discussion