ChatWoot icon

ChatWoot

Interact with ChatWoot API

Actions100

Overview

This node allows you to delete an integration hook from a ChatWoot account using the ChatWoot API. It is useful in scenarios where you need to programmatically remove webhooks or integration hooks that are no longer needed, such as cleaning up after integrations, automating deprovisioning processes, or managing hooks across multiple accounts.

Practical examples:

  • Automatically removing obsolete webhook integrations when an account is closed.
  • Cleaning up test hooks after automated testing.
  • Managing and rotating integration hooks for security purposes.

Properties

Display Name Type Description
Account Id Number The numeric ID of the account.
Hook Id Number The numeric ID of the integration hook to delete.

Both properties are required to identify which integration hook should be deleted from which account.

Output

The output will be a JSON object reflecting the result of the deletion operation. Typically, this may include:

  • A success confirmation (e.g., { "success": true })
  • Or, if the API returns data about the deleted hook, relevant details.

No binary data is produced by this operation.

Dependencies

  • External Service: Requires access to a ChatWoot instance with API enabled.
  • API Key/Credentials: You must configure the chatwootApi credential in n8n, including the base URL (url) and authentication details.
  • n8n Configuration: Ensure the node has access to the necessary credentials and network connectivity to reach your ChatWoot server.

Troubleshooting

Common issues:

  • Invalid Account Id or Hook Id: If either ID is incorrect, the API may return a 404 error or similar message indicating the resource was not found.
  • Authentication Errors: If the chatwootApi credentials are missing or invalid, you may receive authentication/authorization errors.
  • Network Issues: Connectivity problems between n8n and the ChatWoot server can cause timeouts or connection errors.

Error messages and resolutions:

  • "Resource not found": Check that both Account Id and Hook Id are correct and exist in your ChatWoot instance.
  • "Unauthorized" or "Forbidden": Verify that your API credentials are valid and have permission to delete integration hooks.
  • "Connection timed out": Ensure n8n can reach the ChatWoot server (check firewall, VPN, etc.).

Links and References

Discussion