SmileBack Trigger

Overview

This node acts as a trigger that activates when new SmileBack reviews are received. It periodically polls the SmileBack API to fetch recent reviews, making it useful for workflows that need to react to customer feedback in real time or near-real time. For example, it can be used to automatically notify support teams of new reviews, analyze customer sentiment, or update CRM records based on incoming ratings.

Properties

Output

The node outputs an array of review objects under the json field. Each object represents a single review and includes at least the following fields:

• rating: The numeric rating given in the review.
• last_modified: The timestamp indicating when the review was last modified.

The output contains all reviews retrieved from the SmileBack API since the last poll, filtered according to the "Include Unrated" setting.

Dependencies

• Requires an API key credential with username, password, client ID, client secret, and base URL to authenticate with the SmileBack API.
• Uses OAuth2 password grant flow to obtain an access token before fetching reviews.
• Relies on the n8n HTTP request helper to communicate with the SmileBack API.
• Uses UTC timestamps to track the last polling time and only fetch reviews modified since then.

Troubleshooting

• Missing Credentials: If any required credential fields (username, password, client ID, client secret, base URL) are missing, the node will throw an error indicating which credential is missing.
• Failed Token Retrieval: If the OAuth2 token request fails or returns no access token, the node throws an error suggesting to check credentials.
• Empty or Invalid API Response: If the API response is empty or does not contain the expected results array, an error is thrown indicating invalid response format.
• Missing Review Fields: If any review in the results lacks required fields like rating or last_modified, the node throws an error specifying the missing field.
• General Errors: Other errors during execution are wrapped and reported as node operation errors with descriptive messages.

To resolve these issues, verify that all credentials are correctly configured, ensure the SmileBack API is accessible, and confirm that the API response structure matches expectations.

Links and References

• SmileBack API documentation (for authentication and reviews endpoint): https://smileback.com/api (example placeholder, replace with actual if known)