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
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 be used to create a connection to other applications 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:
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:
All data: the webhook will be triggered for all feedback received in the report.
A specific form.
If a specific form is selected you can further specify what data should be sent:
Send all data inside the feedback item.
Send all data inside the feedback item with aliases.
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:
For all new feedback items
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.
If your form consists of multiple pages the webhook can be fired multiple times if the respondent takes a substantial amount of time to complete the form.
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.
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.