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.

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 Workflows → Create Custom Workflow.

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

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.

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.

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

Select "Catch Hook"

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

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

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)

Select System

Scroll down the sidebar and select WebHooks

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

Fill in the regular form details

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

Finally, click the create button to finish up creating a webhook in 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.

From the Choose an Action App select Webhooks

Select Custom Request and then click Save + Continue

Configure the webhook as shown below

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.

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. 🎉