Actions7
Overview
The node "TANSS Tickets" integrates with the TANSS API to manage ticketing operations. Specifically, for the Create Comment operation, it allows users to add comments to existing tickets within the TANSS system. This is useful in scenarios where additional information, updates, or internal notes need to be appended to a ticket during its lifecycle.
Practical examples include:
- Adding a public comment to inform stakeholders about progress.
- Adding an internal comment visible only to support staff for internal communication.
- Documenting troubleshooting steps or decisions related to a ticket.
Properties
| Name | Meaning |
|---|---|
| API Token | API token obtained from the TANSS API login; used for authenticating requests. |
| Ticket ID | The unique identifier of the ticket to which the comment will be added. |
| Comment Title | The title or subject line of the comment being created. |
| Comment Content | The main content/body text of the comment. |
| Internal | Boolean flag indicating whether the comment is internal (true) or public (false). |
Output
The node outputs JSON data representing the response from the TANSS API after creating the comment. This typically includes details of the newly created comment such as its ID, title, content, visibility (internal/public), timestamps, and any other metadata returned by the API.
No binary data output is involved in this operation.
Dependencies
- Requires an active connection to the TANSS API.
- Needs a valid API token credential for authentication.
- The base URL for the TANSS API is provided via credentials configured in n8n.
- Network access to the TANSS API endpoint must be available.
Troubleshooting
- Missing or invalid API token: The node will fail if the API token is not provided or invalid. Ensure the token is correctly entered and has sufficient permissions.
- Invalid Ticket ID: If the specified ticket ID does not exist, the API will return an error. Verify the ticket ID before running the node.
- Empty comment fields: Both the comment title and content should be provided; otherwise, the API might reject the request or create incomplete comments.
- API errors: Any failure in the HTTP request (e.g., network issues, server errors) will result in an error message like
Failed to execute createComment: <error message>. Check connectivity and API status. - Permission issues: If the API token lacks permission to add comments, the operation will fail. Confirm user rights in the TANSS system.
Links and References
- TANSS API Documentation (Replace with actual URL if available)
- n8n Documentation on Creating Custom Nodes
- General REST API best practices for error handling and authentication.