📖 Teams Digest for Jira — Documentation

What it does

Teams Digest for Jira sends scheduled summaries of Jira issues to a Microsoft Teams channel. You define a JQL query, a schedule, and a destination — the app takes care of the rest.

1. Connect a Microsoft Teams channel

Before creating a digest, you need a Workflow URL from the Teams channel where you want to receive it.

  1. Open the channel in Microsoft Teams where you want to receive digests.
  2. Click the three dots (···) next to the channel name and select Workflows.
  3. Search for and select the template "Post to a channel when a webhook request is received."
  4. Give the flow a recognizable name, e.g. Jira Teams Digest.
  5. Confirm the destination channel and authenticate with your Microsoft 365 account.
  6. Copy the URL Microsoft gives you (starts with https://prod-...logic.azure.com/... or a similar Power Automate domain).
This URL acts like a password — anyone who has it can post messages to your channel. Don't share it or commit it to a public repository.

2. Create your first digest

  1. In Jira, go to Settings → Apps → Teams Digest for Jira.
  2. Fill in a name, your JQL query, and paste the Teams Workflow URL from step 1.
  3. Use "Test JQL" to confirm your query returns the results you expect before saving.
  4. Choose a frequency (Daily or Weekly), your time zone, and one or more send windows.
  5. Save. Your digest is now active.

3. Understanding send windows

Each hour you select is an approximate delivery window, not an exact minute. This is a platform limitation of Atlassian Forge's scheduled triggers (they distribute execution across installations to balance load), not something specific to this app — it applies to all Forge apps that run on a schedule.

4. Time zones

Each digest has its own time zone, detected automatically from your browser but fully editable — useful if you're configuring a digest for another office or region. All send windows and days of the week are interpreted in that digest's time zone, not a fixed server clock.

5. Free vs. Pro plan

If your Pro subscription lapses, the system automatically pauses extra digests down to 1 (keeping the oldest one active) and reactivates them automatically if you resubscribe — nothing is deleted.

6. Managing digests

From the configuration screen you can edit, pause/activate, delete, or manually send a test for any digest at any time.

Need help?

Contact support@teamsdigestforjira.com. See also our Support & SLA Statement.

← Back