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

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

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

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

1. If you have a Zapier account, then you know the drill: click on Make a New Zap from the Zaps tab to get started.
   
2. From "Built-in apps", select Webhooks
3. Select Catch Hook
4. You don't need to specify anything in the fields screen, just click Continue.
5. Copy the webhook URL then click Ok, I did this

3. Create a webhook in Jira

1. 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.
2. Go to the Jira system dashboard (a), then select Jira Settings (b)
3. Select System
   
4. Scroll down the sidebar and select WebHooks
   
5. Click the Create a WebHook button located at the top right
6. Fill in the regular form details
7. Under Jira Software related events, check the Sprint → Closed checkbox☑️
8. 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".

1. Within Zapier, click on Add Action to start.
2. From the Choose an Action App select Webhooks
3. Select Custom Request and then click Save + Continue
4. 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.

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