Actions8
Overview
This node integrates with the TANSS ticketing system API to manage tickets and their related data. Specifically, the "Kommentar erstellen" (Create Comment) operation allows users to add comments to existing tickets in TANSS. This is useful for support teams or project managers who want to document updates, internal notes, or public remarks on a ticket.
Typical use cases include:
- Adding progress updates or clarifications to a support ticket.
- Logging internal discussions or decisions without exposing them publicly.
- Collaborating within a team by annotating tickets with relevant information.
For example, after receiving a customer query, a support agent can use this node to append a comment summarizing the investigation steps taken.
Properties
| Name | Meaning |
|---|---|
| API Token | API token obtained from TANSS authentication, used to authorize 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 if 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, creation timestamp, and visibility status (internal/public).
No binary data output is produced by this operation.
Example output structure (simplified):
{
"id": 12345,
"title": "Comment Title",
"content": "Comment Content",
"internal": true,
"createdAt": "2024-06-01T12:34:56Z",
"ticketId": 67890
}
Dependencies
- Requires an active TANSS API endpoint URL configured in credentials.
- Needs a valid API token credential for authenticating requests.
- The node uses HTTP requests to communicate with the TANSS backend API.
Troubleshooting
- Missing or invalid API token: The node will fail if the API token is not provided or incorrect. Ensure the token is current and has appropriate permissions.
- Invalid Ticket-ID: If the specified ticket does not exist or the ID is wrong, 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: Network issues or server errors from the TANSS API will cause the node to throw errors with messages like
Fehler beim Ausführen von createComment: <error message>. Check connectivity and API status. - Permission issues: If the API token lacks rights to add comments, the operation will fail. Confirm user permissions in TANSS.
Links and References
- TANSS API Documentation (for tickets and comments): [Link not provided in source]
- n8n HTTP Request Node documentation: https://docs.n8n.io/nodes/n8n-nodes-base.httpRequest/
- General n8n credential management: https://docs.n8n.io/nodes/credentials/
If you need summaries for other operations or resources, please provide their names.