SmilebackInstall

Overview

This node integrates with the Smileback API to synchronize data related to various resources, including CSAT Agents. Specifically, for the "CSAT Agents" resource and the "Sync" operation, it retrieves records of customer satisfaction agents from the Smileback platform. It supports fetching only those records modified after a specified date and time, enabling incremental synchronization.

Common scenarios where this node is beneficial include:

• Keeping an external database or CRM system updated with the latest CSAT agent information.
• Automating reporting workflows that require up-to-date agent data.
• Integrating Smileback CSAT agent data into broader customer experience analytics pipelines.

For example, a user can configure the node to fetch all CSAT agents modified since the last sync date, ensuring only new or updated records are processed downstream.

Properties

Output

The node outputs an array of JSON objects, each representing a single CSAT Agent record retrieved from the Smileback API. The structure of each JSON object corresponds directly to the fields returned by the Smileback /csat-agents endpoint.

If no records are found or if the resource is unsupported, the output will contain a JSON object with a message indicating the issue.

No binary data output is produced by this node.

Dependencies

• Requires an API key credential for authenticating with the Smileback API. This includes username, password, client ID, and client secret.
• The node makes HTTP requests to the Smileback API endpoints, specifically using OAuth2 token-based authentication.
• The base URL for the API is configurable via credentials.
• The node respects API rate limits by introducing a short delay between paginated requests.

Troubleshooting

• Authentication errors: If the node fails to obtain an access token, verify that the provided API credentials (username, password, client ID, client secret) are correct and have sufficient permissions.
• Empty results: Ensure the "Last Modified Since" date is set correctly; if too restrictive, no records may be returned.
• Unsupported resource message: If the node outputs a message stating "Resource not supported," confirm that the resource parameter is set exactly to "CSAT Agents" for this operation.
• API rate limiting: The node includes a small delay between paginated requests, but excessive data volume might still trigger rate limits. Consider reducing the frequency of syncs or filtering data more narrowly.

Links and References

• Smileback API Documentation (general reference for API endpoints and authentication)
• OAuth2 Authentication overview (for understanding token retrieval process)