Actions9
Overview
The "TANSS Support" node manages support entries and appointments via the TANSS API. It enables users to retrieve, search, create, update, analyze, and upload signatures for support records. This node is useful in scenarios where organizations want to automate or integrate their support ticket management and reporting workflows with the TANSS system.
For example, a company could use this node to:
- Fetch filtered lists of support tickets within a specific timeframe.
- Search support entries by customer name, content, or type.
- Create new support entries automatically from other systems.
- Update existing support records with new information.
- Analyze support data grouped by type, employee, company, or month to generate reports.
- Upload digital signatures related to support entries.
Properties
| Name | Meaning |
|---|---|
| API Token | API token obtained from TANSS authentication, required for all operations. |
| Analyse-Optionen | Options for analyzing support entries: includes start date, end date, and grouping method. |
Details of Analyse-Optionen sub-properties (only shown when operation is "Support analysieren"):
| Name | Meaning |
|---|---|
| Zeitraum von (dateFrom) | Start date/time for the analysis period. |
| Zeitraum bis (dateTo) | End date/time for the analysis period. |
| Gruppierung (groupBy) | Grouping criteria for analysis; options are: Nach Typ (type), Nach Mitarbeiter (employee), Nach Unternehmen (company), Nach Monat (month). |
Output
The node outputs JSON data representing the response from the TANSS API for the selected operation. The structure depends on the operation performed but generally includes support entry details, lists, or analysis results.
- For "Support analysieren", the output JSON contains aggregated analysis data of support entries grouped as specified.
- No binary data output is produced by this node.
Dependencies
- Requires an active TANSS API endpoint URL configured in credentials.
- Requires an API token credential for authenticating requests to the TANSS API.
- Uses HTTP requests to communicate with the TANSS backend API.
Troubleshooting
- Missing Credentials: If no API credentials are found, the node throws an error "Keine Anmeldedaten gefunden!" Ensure that the API token and base URL are correctly configured.
- Required Parameters Missing: Some operations require mandatory parameters (e.g., customer name for searching by customer, support type ID for searching by type). Omitting these will cause errors indicating the missing parameter.
- Invalid Operation: Selecting an unsupported operation will result in an error stating the operation is not recognized.
- API Request Failures: Network issues or invalid tokens can cause request failures. The node reports errors with messages like "Fehler beim Ausführen von [operation]: [error message]". Verify network connectivity and token validity.
- Date Format: Date inputs are converted to timestamps internally. Ensure date/time inputs are valid ISO strings or compatible formats.
Links and References
- TANSS API Documentation (not provided here, but refer to your TANSS API docs for detailed endpoints and data structures)
- n8n HTTP Request Node documentation for understanding how HTTP calls work in n8n: https://docs.n8n.io/nodes/n8n-nodes-base.httpRequest/