N8n

n8n Setup

The SurveyTale n8n node is currently only available in the n8n self-hosted version as a community node. To install it go to "Settings" -> "Community Nodes" and install @surveytale/n8n-nodes-surveytale.

n8n allows you to build flexible workflows focused on deep data integration. And with sharable templates and a user-friendly UI, the less technical people on your team can collaborate on them too. Unlike other tools, complexity is not a limitation. So you can build whatever you want — without stressing over budget. Hook up SurveyTale with n8n and you can send your data to 350+ other apps. Here is how to do it.

Step 1: Setup your survey incl. questionId for every question

Nailed down your survey? Any changes in the survey cause additional work in the n8n node. It makes sense to first settle on the survey you want to run and then get to setting up n8n.

When setting up the node your life will be easier when you change the questionIds of your survey questions. You can only do so before you publish your survey.

(IMAGE)

In every question card in the Advanced Settings you find the Question ID field. Update it so that you'll recognize the response tied to this question.

Already published? Duplicate survey You can only update the questionId when the survey was not yet

published. Already published it? Just duplicate it to update the questionIds.

Step 2: Setup your n8n workflow

Go to n8n.io and create a new workflow. Search for “SurveyTale” to get started:

(IMAGE)

Step 3: Connect SurveyTale with n8n

Now, you have to connect n8n with SurveyTale via an API Key:

(IMAGE)

Click on Create New Credentail button to add your host and API Key

(IMAGE)

Now you need an API key. Please refer to the API Key Setup page to learn how to create one.

Once you copied it in the API Key field, hit Save button to test the connection and save the credentials.

(IMAGE)

Step 4: Select Event

Next, you can choose the event you want to trigger the node on. You can select multiple events:

(IMAGE)

Here, we are adding Response Finished as an event, which will trigger when the survey has been filled out.

Step 5: Select Survey

Next, you can choose from all the surveys you have created in this environment. You can select multiple surveys:

(IMAGE)

Here, we are selecting two surveys.

(IMAGE)

Step 6: Test your trigger

In order to set up n8n you'll need a test response in the selected survey. This allows you to select the individual values of each response in your workflow. If you have SurveyTale running locally and you want to set up an an app or a website survey, you can use our Demo App to trigger a survey and submit a response.

(IMAGE)

Next, click on Listen for event button.

(IMAGE)

Then, go to the survey which you selected. Fill it out, and wait for the particular event to trigger (in this case it's Response Finished). Once the event is triggered you will see the response that you filled out in the survey.

(IMAGE)

Now you have all the data you need at hand. The next steps depend on what you want to do with it. In this tutorial, we will send submissions to a discord channel:

Step 7: Add discord to your workflow

Click on the plus and search Discord.

(IMAGE)

Fill in the Webhook URL and the Content that you want to receive in the respective discord channel. Next, click on Execute Node button to test the node.

(IMAGE)

Once the execution is successful, you'll receive the content in the discord channel.

(IMAGE