Digitalsac Izing ProInstall

Overview

This node integrates with the Digitalsac API to perform various operations related to customer service and communication management. Specifically, the "Criar Tag" (Create Tag) operation allows users to create a new tag with a specified name and color in the Digitalsac system. Tags can be used to categorize or label tickets, contacts, or other entities within the platform, helping organize and filter data efficiently.

Practical scenarios for this node include:

• Automatically creating tags based on incoming ticket attributes to streamline workflow.
• Adding color-coded labels to tickets for priority or status indication.
• Managing tags programmatically as part of a larger automation process involving customer support.

Properties

Output

The node outputs an array of JSON objects, each representing the response from the Digitalsac API after attempting to create a tag. The JSON typically contains details about the newly created tag or error information if the creation failed.

Example output structure:

{
  "id": 123,
  "tag": "Example Tag",
  "color": "#2196F3",
  "createdAt": "2024-06-01T12:00:00Z"
}

If an error occurs, the output JSON will contain an error field describing the issue.

Dependencies

• Requires an API key credential for authenticating with the Digitalsac API.
• The node expects the base URL and token for the Digitalsac API to be configured in the credentials.
• No additional external dependencies are required beyond standard HTTP request capabilities.

Troubleshooting

• Invalid JSON Format: If you provide JSON input in other operations, ensure it is correctly formatted. For the "Criar Tag" operation, inputs are simple strings and colors, so this is less likely an issue here.
• API Authentication Errors: Ensure that the API key/token credentials are valid and have sufficient permissions to create tags.
• Invalid Color Format: The tag color must be a valid hexadecimal color string starting with #. Invalid formats may cause API errors.
• Empty Tag Name: Providing an empty or whitespace-only tag name might result in an error from the API.
• Network Issues: Connectivity problems with the Digitalsac API endpoint will cause request failures; verify network access and API availability.

Common error messages:

• "Formato de JSON inválido para Dados (JSON)" — Not applicable for this operation but indicates malformed JSON in other operations.
• Errors returned by the API will be included in the output under the error field.

Links and References

• Digitalsac API Documentation (example placeholder, replace with actual link if available)
• n8n Documentation on Creating Custom Nodes
• General info on Hexadecimal Color Codes