How do I create an outgoing webhook?

This article explains step by step how you can create an outgoing webhook in Mopinion. We offer 2 options that can be used separately or together. Manually and automatically sent webhooks. The setup for both options is largely the same. In the instructions below we highlight the differences.

Automatically push feedback

Instructions

Step 1: New webhook

In the left-side main menu select Integrations Webhooks & Apps

Select the New Integration button.

Step 2: Select application

Select the correct application you want to connect to or use the JSON hook option to send a raw JSON object.

The JSON hook option can connect other applications that are not listed below. As most applications have specific format requirements for incoming data the use of a service like Zapier might be required in that case.

Step 3: API endpoint

Define the API Endpoint where you want the feedback to be sent. If you wish to use the same webhook for multiple endpoints you can add extra endpoints by selecting the + ENDPOINT button.

Endpoints can be obtained from the third-party applications you wish to send the feedback to. For instructions on how to retrieve an endpoint for a specific application please follow these links:

https://mopinion.atlassian.net/wiki/spaces/KB/pages/332136522

https://mopinion.atlassian.net/wiki/spaces/KB/pages/332103781

https://mopinion.atlassian.net/wiki/spaces/KB/pages/332136569

Step 4: Data source

Select for which form you want the webhook to send the feedback for by clicking on the dropdown Select a data source. There are 2 options:

  1. All data: the webhook will be triggered for all feedback received in the report.

  2. A specific form.

If a specific form is selected you can further specify what data should be sent:

  1. Send all data inside the feedback item.

  2. Send all data inside the feedback item with aliases.

  3. Send only specific data fields

1. Send all data inside the feedback item.

All feedback data (questions, answers, and metadata) will be included in the payload that is being sent.

 

2. Send all data inside the feedback item with aliases.

All feedback data (questions, answers, and metadata) will also be included in the payload that is being sent. However, you can rename the data fields in the payload by providing an alias.

 

3. Send only specific data fields

Only the data fields you add will be included in the payload. You can specify an alias or leave it blank to use the original data field name.

Step 5: Webhook trigger

There are 2 options for the webhook to be triggered:

  1. For all new feedback items

  2. When an item contains specific values

1. For all new feedback items

As soon as feedback is received the webhook will be fired.

 

2. When an item contains specific values

You can define which questions and specific answers the webhook should fire.

Select the question(s), the operator for the condition and the value for the condition:

If you require additional conditions that should be met select the + AND button to add one or more questions, operators, and values.

Step 6: Create integration

Give the webhook a name that is clear for you and others.

For example, you can summarize the trigger condition and application this webhook connects to in the name.

 

If you like to save the webhook, however, don’t want it to be active then uncheck the box Active.

Press the button CREATE WEBHOOK to save the webhook.

You will then see the new webhook on the overview page. If you want to make changes to the webhook select the pencil icon.

 

The data field names are not the same as the questions. If you like to include the literal question in de payload you should put the question in the alias field.

Video walkthrough

Manually push feedback

In addition to automatically pushing incoming feedback items directly to your integrated tools based on pre-specified conditions, you can also manually send individual feedback items to third-party tools such as Slack, Google Chat, and Jira straight from your Mopinion feedback inbox.

Instructions

Step 1: New integration

Go to your feedback inbox and choose the feedback item you want to push. Click on the ‘share’ icon and ‘Add new integration’ next.

 

Step 2: Integration type

Select your integration type. Choose 'Manually from the feedback inbox’ at the bottom of the pop-up.

 

Step 3: Automatically push feedback instructions

Follow the automatically push feedback instructions from above, starting from step 3.

Step 4: Done

Now your integration is available in the inbox to manually push specific or multiple feedback items.