Sending survey responses to Slack via webhook workflows

SurveySparrow’s workflow feature lets you design workflows that can share survey responses to Slack. But if you’d like finer control over the details of your Slack messages, you can instead create a Slack webhook that forwards incoming responses. This gives you full flexibility over what appears in Slack while still using SurveySparrow’s workflow engine to trigger the message.

The steps below walk you through creating the webhook in Slack and then wiring it up inside a SurveySparrow workflow.

Note: Before creating the workflow, make sure that you’ve created all the necessary custom variables.

Part 1: Create the Slack webhook

1. Open Slack’s developer docs, then click on Manage Apps.

   

2. After the list of apps appears, click on Create New App.

   

3. Click on Blank app.

   

4. Click on Continue.

   

5. Enter an app name and then select the workspace in which it should be deployed in.

   

6. Click Create.

   

7. When the app is created, click on Incoming Webhooks under Features.

   

8. Switch on the toggle.

   

9. Click on Add New Webhook.

   

10. You’ll have to select the workspace and the channel within which the webhook has to act. Click on the respective drop-down menus for each and make your selection.

    

11. Click on Allow.

    

12. To copy the webhook URL, click Copy.

    

13. Next, click on Basic Information under the Settings panel.

    

14. Scroll past the basic information section and towards the display information section, where you can customize the look and feel of the app inside Slack. Click on Save Changes when done.

    

Part 2: Create the workflow in SurveySparrow

1. Now, it’s time to create a workflow. Head to your SurveySparrow account, and open the survey whose responses you want to send via Slack. Then click on the Configure section.

   

2. Click on Workflows, then click on New Workflow.

   

   

3. Next, set up the workflow. In this case, we want the workflow to trigger when a response is received.

   

4. We need the workflow to trigger based on conditions, so set them up. In this instance, we want the workflow to trigger only for specific responses to a question.

   

   

   

5. Next, set up the action - triggering a webhook.

   

   

6. When the webhook panel opens up, first paste in the webhook URL that you copied from Slack previously in the Endpoint field.

   

7. Next, in the Body field, you must enter a valid JSON payload. The body must be a JSON object that includes at least a "text" key.

   

   Apart from that, you can add all the response properties that you want to appear in the Slack alert, by clicking on the bracket icon, then choosing from the menu.

   

   

   
   

   

   This is what a sample payload would look like:

   

8. If you’d like to also push the question text in the alert, click on the toggle for it.

   

9. Click on Save to complete the action, then click on Save and Activate to finish creating the workflow.

   

   

Test the integration

1. Submit a test response to the survey, then check the Slack channel you selected for the webhook. You should see the message appear within a few seconds.

   

2. You can also review the SurveySparrow workflow logs to understand if the workflow fired at all and/or why it failed. If there’s any other error message apart from 200 OK, reach out to SurveySparrow support for assistance.

   

Troubleshooting