WTS ChatInstall

Overview

This node interacts with the "Panel" resource of the WTS Chat API, specifically supporting the operation to create an annotation file on a card within a panel. The "Create Annotation File" operation allows users to attach one or more files (specified by URLs) as annotations to a particular card identified by its Card ID.

Common scenarios where this node is beneficial include:

• Adding supplementary documents, images, or other file references to a project management card or task card in a CRM or workflow system.
• Automating the process of attaching multiple reference files to a card during data integration or synchronization workflows.
• Enhancing collaboration by programmatically adding relevant files to cards for team visibility.

Example use case:

• Automatically attaching invoice PDFs or contract documents to a sales opportunity card when certain triggers occur in your automation workflow.

Properties

Output

The output of this operation is a JSON object representing the result returned by the API after creating the annotation file(s). This typically includes details about the newly created annotation such as IDs, file metadata, and confirmation of attachment to the specified card.

No binary data output is produced by this operation.

Dependencies

• Requires an active connection to the WTS Chat API via an API key credential.
• The node uses the WtsCrmService.createAnnotationFile method internally to perform the API call.
• Proper configuration of the API base URL (https://api.wts.chat) and valid authentication credentials are necessary.

Troubleshooting

• Missing Card ID: If the Card ID property is empty or not provided, the node throws an error indicating that the CardId cannot be empty. Ensure you provide a valid Card ID.
• Invalid or unreachable File URLs: If the URLs provided in the File Urls collection are invalid or inaccessible, the API may reject the request or fail to attach files. Verify that URLs are correct and publicly accessible if required.
• API Authentication Errors: If the API key is missing, invalid, or expired, the node will throw authentication errors. Confirm that the API key credential is correctly set up in n8n.
• Network Issues: Connectivity problems between n8n and the WTS Chat API endpoint can cause timeouts or failures. Check network access and proxy settings if applicable.

Links and References

• WTS Chat API Documentation (general reference for API endpoints)
• n8n documentation on Creating Custom Nodes
• General best practices for handling file attachments in APIs