Kanban Chatwoot

Integração Kanban com Chatwoot
Join our community

Actions8

Overview

This node integrates with Chatwoot's Kanban feature, allowing users to manage Kanban board items within their Chatwoot account. It supports multiple operations such as creating, listing, retrieving, updating, deleting, moving, and reordering Kanban items. This node is useful for automating workflows that involve task or ticket management in Chatwoot, enabling seamless synchronization between Chatwoot Kanban boards and other systems.

Practical examples:

  • Automatically list all active Kanban items filtered by priority or assigned user.
  • Create new Kanban items based on incoming customer requests.
  • Move Kanban items to different stages when certain conditions are met.
  • Reorder Kanban items programmatically to reflect changing priorities.

Properties

Name Meaning
Account ID The Chatwoot account identifier where the Kanban items reside (required).
Stage Filter Kanban items by their stage (used only in "List Items" operation).
Status Filter Kanban items by status; options: Active, Completed, Archived (default: Active).
Priority Filter Kanban items by priority; options: Low, Medium, High, Urgent (default: Low).
Assigned User ID Filter Kanban items by the assigned user's ID (used only in "List Items" operation).

Output

The output of this node is a JSON object representing the response from the Chatwoot API for the selected operation. For the "List Items" operation, it returns an array of Kanban items matching the specified filters. Each item includes details such as its ID, stage, status, priority, assigned user, and other relevant metadata.

If the operation involves a single item (e.g., get, create, update), the output JSON contains the data of that specific Kanban item.

This node does not output binary data.

Dependencies

  • Requires an API key credential for authenticating with the Chatwoot API.
  • The node expects the Chatwoot API domain and access token to be configured in the credentials.
  • Network connectivity to the Chatwoot instance is necessary.

Troubleshooting

  • Common issues:

    • Invalid or missing API credentials will cause authentication failures.
    • Incorrect Account ID or Item ID parameters may result in "not found" errors.
    • Filtering with invalid values might return empty results.
    • Network or permission issues on the Chatwoot side can cause request failures.

  • Error messages:

    • "Operation not supported: <operation>": Indicates an unsupported operation was requested; verify the operation name.
    • HTTP errors from the Chatwoot API (e.g., 401 Unauthorized, 404 Not Found) will be propagated; check credentials and IDs.
    • If continueOnFail is disabled, the node execution stops on the first error; enable it to process remaining items despite errors.

Links and References

Discussion