Kanban Chatwoot

Integração Kanban com Chatwoot
Join our community

Actions8

Overview

This node integrates Kanban board item management with Chatwoot accounts. It allows users to perform various operations on Kanban items within a specified Chatwoot account, such as creating, retrieving, updating, deleting, moving between stages, reordering, and listing items.

A common use case is automating task or issue tracking workflows by synchronizing Kanban items in Chatwoot with other systems or processes. For example, when a support ticket progresses through different stages, this node can move the corresponding Kanban item to reflect its current status automatically.

Specifically, the Move Item operation enables moving a Kanban item from one stage to another within a Chatwoot account, which is useful for workflow automation where item stages represent progress states.

Properties

Name Meaning
Account ID The unique identifier of the Chatwoot account where the Kanban item exists.
Item ID The unique identifier of the Kanban item to be moved. Required for operations including move.
Move Data JSON object containing data required to move the item to a different stage. This typically includes the target stage information.

Output

The output is a JSON object representing the response from the Chatwoot API after performing the move operation. It usually contains details about the updated Kanban item, reflecting its new stage and any other changes made by the move.

No binary data output is produced by this node.

Example output structure (simplified):

{
  "id": "123",
  "title": "Sample Kanban Item",
  "stage": "new_stage_id",
  "status": "active",
  ...
}

Dependencies

  • Requires an active Chatwoot account with API access.
  • Needs an API authentication token credential configured in n8n to authorize requests to the Chatwoot API.
  • The node uses HTTP requests to communicate with the Chatwoot API endpoints.

Troubleshooting

  • Common issues:

    • Invalid or missing Account ID or Item ID will cause API errors.
    • Incorrect or incomplete Move Data JSON may result in failure to move the item.
    • Authentication failures if the API token is invalid or expired.
    • Network connectivity issues preventing communication with the Chatwoot API.

  • Error messages:

    • "Operation not supported": Indicates an unsupported operation was requested; ensure "move" is selected.
    • API error messages returned from Chatwoot are passed through; check the message for details like "item not found" or "invalid stage".

  • Resolutions:

    • Verify all required fields are correctly set.
    • Confirm the API token has sufficient permissions.
    • Validate the Move Data JSON structure matches Chatwoot API expectations.
    • Use the "Continue On Fail" option to handle errors gracefully during batch processing.

Links and References

Discussion