JIRA Sprint Retrospective

To integrate automated Sprint Retrospective surveys after every sprint that closes in Jira, you can do so by connecting Polly and Jira with Zapier in a few simple steps, with minimal coding or technical knowledge required.

Let's go over the steps below.

1. Creating an API token and setting up your workflow

First, go to https://app.polly.ai/api and create a new token with read/write access to Workflows.

create-token

Once you've created the token, you'll need to reveal and copy this token. The token will come into use while configuring your Zapier action.

Next comes the workflow setup. Go to WorkflowsCreate Custom Workflow.

Set up an API triggered workflow similar to the one below:

sprint-workflow-setup

Once the trigger is set up, you can select the appropriate Sprint Retrospective survey to send to your team — we have one available as a template, or you can use your own custom template. Find the workflow you created in your workflows list and note the ID specified in the description of the workflow.

workflow-id

2. Create a Webhook Zap in Zapier

If you have a Zapier account, then you know the drill: click on Make a New Zap from the Zaps tab to get started.

make-a-zap

From "Built-in apps", select "Webhooks"

zapier-webhook

Select "Catch Hook"

zapier-catch-hook

You don't need to specify anything in the fields screen, just click continue

set-up-zapier-webhook

Copy the webhook URL then click "OK, I did this"

send-request-to-webhook

3. Create a webhook in Jira

Once you've set up your Zap, next we'll need to create a webhook in Jira that will let Polly know every time your sprint has closed.

Go to the Jira system dashboard (a), then select Jira Settings (b)

jira-system

Select System

jira-system-webhook

Scroll down the sidebar and select WebHooks

jira-webhooks

Click the "Create a WebHook" button located at the top right

create-jira-webhook

Fill in the regular form details

webhook-forms

Under Jira Software related events, check the Sprint → Closed checkbox

webhook-sprint-close-1

Finally, click the create button to finish up creating a webhook in Jira.

create-webhook-jira

4. Call into Polly's API with the sprint closed event

You can now test the Zapier hook by closing a test sprint in Jira, or simply skip the testing part of Zapier and click Continue.

You'll see that the trigger has now been defined with the closed sprint in Jira, but now you need to set up the action that takes place whenever the trigger is hit. In this case, a sprint retrospective survey is the "action".

Within Zapier, click on Add Action to start.

add-zapier-action

From the Choose an Action App select Webhooks

zapier-webhook-action

Select Custom Request and then click Save + Continue

custom-request-zapier

Configure the webhook as shown below

form-input-zapier
json-header

The token field should be the one you generated in the first step and the ID should be the one that you captured after creating the workflow.

Save the Zap and turn it on.

finish-zap

You can test it at this step or you can skip it. Your workflow should be set up and will send whenever a sprint closes in Jira. 🎉