Sentiment

Open Source Surveys & Experience Management Solution

Overview

This n8n node acts as a trigger for events from the "Sentiment" open-source surveys and experience management platform. It listens for specific survey-related events (such as when a response is created, updated, or finished) and starts an n8n workflow when those events occur. This is useful for automating processes based on survey activity, such as sending notifications, updating databases, or integrating with other tools.

Practical examples:

  • Automatically send a thank-you email when a survey response is completed.
  • Trigger follow-up actions when a survey response is updated.
  • Log new survey responses to a CRM or analytics tool.

Properties

Name Meaning
Events The types of survey events that will trigger this workflow. Options:
- Response Created: Triggers when a new response is created for a survey (usually after the first question is answered).
- Response Updated: Triggers when a response is updated within a survey.
- Response Finished: Triggers when a response is marked as finished.
Survey The surveys that should trigger the workflow. You can select one or more surveys from a list or specify their IDs using an expression. Only these selected surveys will cause the workflow to run.

Output

The node outputs data received from the Sentiment webhook as JSON. The structure of the output depends on the payload sent by the Sentiment platform, but it typically contains information about the survey event (e.g., which survey, which response, event type, timestamps, etc.).

Example output (structure may vary):

[
  {
    "surveyId": "12345",
    "event": "responseCreated",
    "response": {
      "id": "abcde",
      "answers": { /* ... */ },
      "timestamp": "2024-06-01T12:34:56Z"
    }
  }
]

If the node receives binary data, it will be included in the output as a binary property, but this node is primarily designed for JSON payloads.

Dependencies

  • External Service: Requires access to a Sentiment instance (the surveys & experience management platform).
  • API Key: Needs valid credentials configured in n8n under the name sentimentApi.
  • n8n Configuration: No special environment variables required beyond standard credential setup.

Troubleshooting

  • Common Issues:

    • Webhook not triggering: Ensure the correct events and surveys are selected, and that the Sentiment platform can reach your n8n instance (check firewalls, public URLs, etc.).
    • Authentication errors: Make sure the sentimentApi credentials are correctly set up in n8n.
    • Invalid survey ID: Double-check that the survey IDs provided exist and are accessible.

  • Error Messages:

    • "Cannot create webhook": Usually means the API credentials are invalid or the Sentiment server cannot be reached.
    • "Webhook already exists": The webhook for the selected survey/events combination might already be registered; try deleting and recreating the webhook.
    • "Invalid payload": The incoming data does not match expected format; check the Sentiment platform's webhook configuration.

Links and References

Discussion