Actions39
- Panel Actions
- Message Actions
- Chatbot Actions
- Contact Actions
- Sequence Actions
- Session Actions
Overview
This node operation updates a card in the Panel resource of the WTS Chat API. It allows users to modify various attributes of a card such as title, description, monetary amount, position, step ID, contact IDs, due date, tags, responsible user, session ID, metadata, and custom fields. This operation is useful for managing and organizing cards within a panel, enabling dynamic updates to card details based on workflow needs.
Use Case Examples
- Updating the title and description of a card to reflect new information.
- Changing the responsible user of a card to reassign tasks.
- Adding or removing tags and contacts associated with a card.
- Modifying custom fields and metadata to store additional structured information.
Properties
| Name | Meaning |
|---|---|
| Fields | Specifies which fields of the card to update, such as Title, Description, DueDate, etc. |
| Card ID | The unique identifier of the card to update. |
| Include Archived | Whether to include archived items in the update (only shown if 'Archived' field is selected). |
| Contacts ID | Collection of contact IDs to associate with the card (shown if 'ContactIds' field is selected). |
| Custom Fields | Custom fields to set on the card, each with a key and value (shown if 'CustomFields' field is selected). |
| Description | Description text for the card (shown if 'Description' field is selected). |
| Due Date | Due date and time for the card (shown if 'DueDate' field is selected). |
| Monetary Amount | Monetary amount value for the card (shown if 'MonetaryAmount' field is selected). |
| Position | Position index of the card within the panel (shown if 'Position' field is selected). |
| User Name or ID | Responsible user for the card, selectable from a list or by ID (shown if 'ResponsibleUserId' field is selected). |
| Step ID | Step ID within the panel to assign the card to (shown if 'StepId' field is selected). |
| Tag Names or IDs | Tags to associate with the card, selectable from a list or by IDs (shown if 'TagIds' field is selected). |
| Title | Title text for the card (shown if 'Title' field is selected). |
| Session ID | Session ID linked to the card (shown if 'SessionId' field is selected). |
| Metadata | Metadata key-value pairs to set on the card (shown if 'Metadata' field is selected). |
Output
JSON
cardId- The unique identifier of the updated card.fields- List of fields that were updated on the card.title- Updated title of the card.includeArchived- Flag indicating if archived items were included.description- Updated description of the card.monetaryAmount- Updated monetary amount of the card.position- Updated position of the card.stepId- Updated step ID of the card.dueDate- Updated due date of the card.updateCardTagId- Updated tags associated with the card.userId- Updated responsible user ID of the card.customFieldsObject- Updated custom fields as key-value pairs.metadataObject- Updated metadata as key-value pairs.arrayContactIds- Updated list of contact IDs associated with the card.
Dependencies
- WtsCrmService from WTS API for panel and card management
Troubleshooting
- Error 'Fill in CardID' indicates the card ID parameter is missing or empty; ensure the card ID is provided.
- Error 'Fill in Fields' indicates no fields were selected for update; select at least one field to update.
- API errors may occur if invalid field values are provided; validate inputs such as dates, IDs, and numbers before execution.
- Ensure API credentials are correctly configured to avoid authentication errors.
Links
- n8n Custom Nodes Documentation - General documentation on creating and using custom nodes in n8n.
- WTS Chat API Documentation - Official API documentation for WTS Chat, including panel and card management endpoints.