Converting feedback as Workplace posts or Jira issues via webhook
This guide helps administrators configure outgoing webhooks to be triggered every time feedback is saved.
Page Feedback for Confluence supports webhooks that are delivered to the following platforms:
Workplace
Atlassian
Webhooks are only triggered when a user selects a reason. If a user only provides a sentiment, the webhook will not be triggered.
Creating a webhook via Workplace integration
You need to be a group administrator to perform these steps.
In Workplace, select a group.
Select More from the navigation bar > select Integrations.
Click Create bot in the Create publishing bot category.
Upload a logo, create a name, and provide a short description for your publishing bot. Then, click Create.
Click Copy URL to copy your webhook URL.
Then, tick I understand and click the Done button to complete the setup on Workplace.
In Confluence, go to any space > click Space Settings > under Integrations, click Page Feedback Webhooks.
Click Add Webhook, enter a webhook into the Label field, and paste the copied link from Step 5 into the Webhook URL field. Then, click Save.
You have successfully created an endpoint from your Confluence space to your Workplace group.
A post will be made in your Workplace group when a user provides feedback in a Confluence space.
Creating a webhook via Jira automation
You need to be a Jira administrator or a project administrator to perform these steps.
In Jira, select a JSM project.
Click Project Settings > Automation > click the Create rule button to start creating the automation rule.
In the Create a Trigger section, search and select the Incoming webhook option.
Click Copy URL to copy the automation webhook URL.
Next, select the “No issues from the webhook” option from the Execute this automation rule with section. Then, click Save.
For the New component section, select THEN: Add an action.
Search and select the Create issue option.
Enter the following for the Create issue section:
Project - select a project.
Issue type - select an issue type.
Summary - enter the following in the Summary field:
CODE{{webhookData.summary}}
Description - enter the following in the Description field:
CODEFeedback for {{webhookData.title}}: {{webhookData.link}} Sentiment: {{webhookData.sentiment.emoji}} {{webhookData.sentiment.label}} Reason: {{webhookData.reason.label}} Created at: {{webhookData.createdAt}} by {{webhookData.reporter}} Page version: {{webhookData.version}}
Choose other fields to set up if you want to. Then, click Save.
Name your automation and set the permission access to edit the rule. Next, click Turn it on to activate the automation.
In Confluence, go to any space > click Space Settings > under Integrations, click Page Feedback Webhooks.
Click Add Webhook, enter a webhook into the Label field, and paste the copied link from Step 4 into the Webhook URL field. Then, click Save.
You have successfully created an endpoint from your Confluence space to your Jira project.
An issue will be created in your Jira group when a user provides feedback in a Confluence space.
Disabling and deleting webhooks
By default, any webhook added to the page has the ENABLED status.
Go to a space > Click Space Settings > under Integrations, click Page Feedback Webhooks.
Under Endpoints, click the three-dot menu > click the following options from the dropdown:
Disable - the endpoint has a DISABLED status and can be enabled again. (The text changes to Enable if the endpoint is disabled.)
Delete - the endpoint is deleted and cannot be recovered.