Chatwoot icon

Chatwoot

Interact with Chatwoot API

Overview

This node integrates with the Chatwoot API to manage various resources such as accounts, contacts, conversations, messages, inboxes, canned responses, webhooks, teams, and labels. Specifically, for the Canned Response - Delete operation, it allows users to delete a canned response by its numeric ID from their Chatwoot account.

This operation is useful in scenarios where you want to programmatically remove outdated or irrelevant canned responses from your Chatwoot instance, helping keep your automated replies clean and up-to-date.

Example use case:
You have an automation that periodically reviews canned responses and deletes those that are no longer needed or have been replaced, ensuring agents only see relevant quick replies.


Properties

Name Meaning
Canned Response ID The numeric ID of the canned response to delete.
Continue on Fail Whether the workflow should continue executing subsequent items if this delete operation fails.
Debug Logging Whether to output detailed request and debug information to the console for troubleshooting.

Output

The node outputs JSON data representing the result of the delete operation:

  • On successful deletion, the output JSON contains:
    {
      "success": true
    }
    
  • If the operation fails and Continue on Fail is enabled, the output will contain an error message in the JSON under an error key.

No binary data is produced by this operation.


Dependencies

  • Requires an API authentication token credential for Chatwoot with access to the target account.
  • The node uses HTTP requests to communicate with the Chatwoot REST API endpoints.
  • The base URL and account ID are obtained from the configured credentials.
  • No additional external dependencies beyond the Chatwoot API and n8n's HTTP request helper.

Troubleshooting

Common Issues

  • Invalid or missing Canned Response ID:
    Ensure the provided canned response ID exists and is correct; otherwise, the API will return an error.

  • Authentication errors:
    Verify that the API token credential is valid and has sufficient permissions to delete canned responses.

  • Network or connectivity issues:
    Check network access to the Chatwoot API endpoint.

Error Messages

  • Errors thrown by the HTTP request (e.g., 404 Not Found if the canned response does not exist) will be surfaced unless Continue on Fail is enabled.
  • Invalid or malformed input parameters may cause the node to throw errors before making the API call.
  • Enabling Debug Logging will print detailed request URLs, headers, and error stacks to the console, aiding diagnosis.

Links and References


Summary

This node's Canned Response - Delete operation provides a straightforward way to remove canned responses from Chatwoot via their numeric IDs. It supports optional debug logging and error handling controls to fit into robust automation workflows.

Discussion