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, updating, retrieving, deleting, moving between stages, reordering, and listing items.

Common scenarios include automating task or issue tracking workflows by syncing Kanban items with Chatwoot accounts, managing customer support tasks visually, or integrating Kanban boards into broader automation pipelines.

For example, you can use this node to update the status or details of a Kanban item when a related customer conversation changes, or to reorder Kanban items based on priority updates from another system.

Properties

Name Meaning
Account ID The Chatwoot account identifier where Kanban items are managed.
Item ID The unique identifier of the Kanban item (used for get, update, delete, move operations).
Kanban Item Data JSON object containing the data fields for creating or updating a Kanban item.

Output

The node outputs the JSON response returned by the Chatwoot API for the requested operation. This typically includes the details of the Kanban item(s) affected or retrieved.

  • For single-item operations (create, get, update, delete, move), the output JSON contains the specific Kanban item data or confirmation.
  • For list operations, the output JSON is an array of Kanban items matching the query.
  • No binary data output is produced by this node.

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.
  • HTTP requests are made to Chatwoot's REST API endpoints under /api/v1/accounts/{account_id}/kanban_items.

Troubleshooting

  • Common issues:

    • Invalid or missing Account ID or Item ID will cause API errors.
    • Incorrect or expired API authentication token will result in authorization failures.
    • Malformed JSON in "Kanban Item Data" or other JSON inputs may cause request failures.
    • Using unsupported operations or missing required parameters triggers explicit errors.

  • Error messages:

    • "Operação não suportada: <operation>" indicates an invalid operation was selected.
    • API error messages from Chatwoot are passed through; check the message for details like "Not Found", "Unauthorized", or validation errors.

  • Resolutions:

    • Verify all required input properties are correctly set.
    • Ensure the API key credential is valid and has necessary permissions.
    • Validate JSON inputs before running the node.
    • Use the correct operation name matching the intended action.

Links and References

Discussion