Schedule a recurring Viewtracker report with Atlassian Automation

Use this procedure to have the Viewtracker Agent deliver a report on a schedule, for example, a weekly list of the most viewed pages published to a Confluence page. A scheduled report also removes the waiting time for reports that cover large data sets.

Because a report can take longer than a single automation step allows, the setup uses two flows connected by a webhook. The first flow receives the finished report and delivers it. The second flow starts the report on your schedule.

Before you begin

• Required access: You can create flows in the Global Automation or in a Space's Automation.

• The Viewtracker Agent is available in your Confluence Cloud site.

Create the receiving flow

This flow takes the agent's response and writes it to the destination you choose.

1. In Automation, create a new flow.

2. Select the trigger Incoming webhook.

   

   Note: The webhook URL and secret appear only after you save the flow, and you can save a flow only after you add at least one action.
   

3. Add the action Use agent.

   

4. Select the agent Viewtracker - Analytics for Confluence Agent.

5. Enter the prompt Get the result for the task with the ID {{webhook.body.task.executionId}}.

6. Set the response reference to {{agentResponse}}.

7. Add a second action for the delivery and set the report as its content, for example:

   • Publish new page: Set the page body to {{agentResponse}}.

   • Send customized email: Set the email body to {{agentResponse}}.

   • Create a work item in Jira: Set the description to {{agentResponse}}.

     

8. Save and enable the flow.

9. Copy the webhook URL and the webhook secret.

Create the scheduling flow

This flow runs on your schedule and asks the agent for the report.

1. Create a second flow.

2. Select the trigger Scheduled and define the frequency, for example, the first day of the month at 9 am.

   

3. Add the action Use agent.

4. Select the agent Viewtracker - Analytics for Confluence Agent.

5. Enter the report request as the prompt, for example: "List the top 10 most viewed pages in the HR space for the last 7 days, to report on a page".

6. Add the webhook URL and the webhook secret from the receiving flow to the same prompt field. Example prompt:
   "List the top 10 most viewed pages in the HR space for the last 7 days, to report on a page. Webhook URL: https://automation.atlassian.com/..., Secret: your-secret-key"

7. Set the response reference to {{agentResponse}}.

   

8. Save and enable the flow.

9. Run a test and check the destination.

Write the prompt for an automation

In an automation, the agent cannot ask you for missing information. Name every parameter you care about: Space or content, date range, content type, sorting, number of results, and filters.