WTS Chat icon

WTS Chat

Get data from Wts API

Actions39

Overview

The "Create Annotation File" operation for the Panel resource in this n8n node allows users to attach one or more files as annotations to a specific card within a panel (such as a CRM board or kanban system). This is useful for adding supporting documents, images, or other file-based information directly to a card, enhancing collaboration and record-keeping.

Common scenarios:

  • Attaching contracts, invoices, or receipts to sales opportunity cards.
  • Adding design files or screenshots to project management tasks.
  • Storing reference documents alongside customer support tickets.

Practical example:
A sales manager wants to attach a signed contract PDF to a deal card in their CRM panel. Using this node operation, they can specify the card ID and provide the file URL(s), which will then be added as annotation(s) to the card.

Properties

Display Name Type Description
Card ID String The unique identifier of the card to which the file annotation(s) will be attached. Required.
File Urls Collection A list of file URLs to be attached as annotations. Each entry should contain:
- URL (String): The direct link to the file you want to attach. Multiple URLs can be provided.

Output

The output will be an array of objects, each with a json field containing the response from the API after creating the annotation file(s). The structure of the json object typically includes details about the created annotation(s), such as:

{
  "id": "annotation_id",
  "cardId": "card_id",
  "fileUrls": [
    "https://example.com/file1.pdf",
    "https://example.com/file2.png"
  ],
  "createdAt": "2024-06-01T12:34:56.789Z",
  // ...other metadata fields depending on the backend API
}
  • The exact fields may vary based on the WTS API's response.
  • If multiple files are attached, all URLs will be listed in the fileUrls array.

Dependencies

  • External Service: Requires access to the WTS API (https://api.wts.chat).
  • API Key: You must configure valid credentials (wtsApi) in n8n, including an API key.
  • n8n Configuration: Ensure the node has network access to the WTS API endpoint.

Troubleshooting

Common issues:

  • Missing Card ID: If the "Card ID" property is empty, the node will throw an error:
    "Fill in the CardId field. CardId cannot be empty."

    • Resolution: Provide a valid Card ID.

  • Invalid or Empty File URLs: If no file URLs are provided, the annotation will not be created as expected.

    • Resolution: Ensure at least one valid file URL is included in the "File Urls" collection.

  • Authentication Errors: If the API key is missing or invalid, authentication errors will occur.

    • Resolution: Check your n8n credentials configuration for the WTS API.

  • Network Issues: If n8n cannot reach the WTS API, the node will fail.

    • Resolution: Verify network connectivity and firewall settings.

Links and References

Discussion