Smileback

Overview

This node integrates with the Smileback API to synchronize data related to various resources, including CSAT Companies. It fetches records from the Smileback service, supporting filtering by modification date to retrieve only recently updated entries. This is useful for keeping external systems or databases up-to-date with the latest customer satisfaction data.

A common scenario is syncing customer satisfaction company data (CSAT Companies) that have changed since a specific date, enabling incremental updates rather than full data reloads. For example, a user might run this node daily to import all companies updated in the last 24 hours into their CRM or analytics platform.

Properties

Output

The node outputs an array of JSON objects, each representing a single record fetched from the Smileback API for the selected resource. For the "CSAT Companies" resource, each JSON object corresponds to one company record as returned by the API.

The output structure is:

{
  "json": {
    // fields representing a CSAT Company record, e.g.:
    "id": "string",
    "name": "string",
    "modified_at": "ISO8601 timestamp",
    // ... other company-specific fields
  }
}

If the resource requested is not supported, the output will contain a JSON object with a message indicating the unsupported resource.

No binary data output is produced by this node.

Dependencies

• Requires an API key credential for authenticating with the Smileback API.
• The node performs OAuth2 password grant authentication using username, password, client ID, and client secret credentials.
• Network access to the Smileback API endpoint is necessary.
• No additional environment variables are required beyond the configured credentials.

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 appropriate permissions.
• Unsupported resource error: If the node outputs a message stating "Resource not supported," ensure that the resource parameter is set correctly to "csat-companies" for syncing CSAT Companies.
• Rate limiting or API errors: The node includes a small delay between paginated requests; if you encounter rate limit errors, consider increasing delays or checking API usage limits.
• Empty results: If no records are returned, confirm that the "Last Modified Since" date is set appropriately and that there are records modified after that date.

Links and References

• Smileback API documentation: https://docs.smileback.com/
• OAuth2 Password Grant flow overview: https://oauth.net/2/grant-types/password/