Jira Integration

What it does

  • Connect Jira so VDF Cloud can help with backlog refinement, user story creation, and productivity insights.

Adding the App

Recommended (OAuth 2.0):

  1. In VDF, go to Integrations → Jira → Connect via OAuth.
  2. Sign in with your Atlassian account and grant access to VDF.
  3. You’ll be redirected back to VDF. If prompted, pick your Project and Board.
  4. Status changes to Connected. You can reconnect or disconnect any time.

Legacy (API token):

  1. In VDF, go to Integrations → Jira → Connect with API Token.
  2. Enter your Jira Cloud URL (e.g., your‑site.atlassian.net), username/email, and API token.
  3. Select your Project and Board, then Complete Setup.

If you run into issues, see the Troubleshooting guide in this document.

Use in Chat

  • Story Generation: After generating a story, select Send to Jira to create an issue in your selected project/board.
  • Backlog Refinement tool: Choose Ask for direct questions or Agent to let VDF guide the flow.

Use on the Cockpit

  • When connected, your cockpit can show team velocity, cycle time, throughput, and flow efficiency.

Removing the App

There are two parts: disconnect in VDF and revoke/remove in Atlassian.

  • Disconnect in VDF (stops processing immediately):

    1. In VDF, go to Integrations → Jira → Disconnect.
    2. This clears active tokens on our side and stops new API calls.

  • Revoke/Remove in Atlassian (account/workspace):

    1. Log in to your Atlassian account (Jira Cloud).
    2. Go to Manage your apps/Connected apps (site admin) or your Atlassian account’s app authorizations.
    3. Find “VDF” (or your VDF app name) and revoke access/remove the app.

Potential implications of removal:

  • New actions (issue create/update, metrics) will no longer work from VDF.
  • Existing artifacts in VDF (generated stories, metrics snapshots) remain until deleted or per retention.
  • OAuth tokens and refresh tokens are invalidated or removed; VDF will cease all Jira API access.

Tips

  • If you don’t see Jira options in chat, connect Jira from Integrations and try again.
  • You can change your selected Project/Board at any time.

Troubleshooting

  • OAuth window closes but no connection — ensure pop‑ups are allowed, and that you returned to a URL containing ?oauth=jira at least once; then VDF removes it.
  • “state_invalid” or “access_denied” — start the flow from VDF Integrations and retry; if you cancelled consent, run Connect via OAuth again.
  • 401/unauthorized or expired — reconnect via OAuth to refresh tokens.
  • API token path fails — verify you’re using Jira Cloud and a valid API token for the correct site (ends with .atlassian.net).
  • Project/Board list empty — ensure your account has permission to view projects/boards on the selected site.

Examples and use cases

  • Create a user story from a plain request:
    • "Create a user story for: let users sign in with Google and show error messages for invalid credentials."
    • After review, select Send to Jira.
  • Clarify and improve acceptance criteria:
    • "Refine acceptance criteria for the story above. Make them testable and minimal."
  • Backlog triage and prioritization:
    • "Find issues with unclear descriptions and propose clarifying questions."
    • "Suggest a top‑10 backlog for next sprint given our recent priorities."
  • Sprint planning helpers:
    • "Summarize last sprint’s key risks and carry‑over work."
    • "Draft a sprint goal based on the top 5 backlog items."

Actions table

Task Where Notes
Create story Chat → Story Generation Then “Send to Jira”
Update issue Chat (Agent) Reference the key (e.g., ABC‑123)
Add comment/attachments Chat (Agent) Provide text/files
Backlog analysis Chat → Backlog Refinement Ask or Agent mode 
sequenceDiagram
  participant U as You
  participant V as VDF AI
  participant J as Jira
  U->>V: "Create a story for Google Sign‑In..."
  V-->>U: Draft story + acceptance criteria
  U->>V: Send to Jira
  V->>J: Create issue
  J-->>V: Issue key ABC‑123
  V-->>U: Confirm created ABC‑123

FAQ

  • Which authentication should I use? — OAuth 2.0 is recommended. API token is available as a fallback.
  • What permissions are needed? — Read/write on issues and metadata for the selected projects/boards.
  • How do I change the project or board? — Reopen Integrations → Jira and update your selection.
  • What happens to my data if I disconnect? — VDF stops calling Jira. Generated artifacts in VDF remain until you delete them or per retention.
  • How do I manage email notifications? — Manage your email preferences in your VDF profile; unsubscribe via the link in any email.

Contact Support

  • Email: support@vdf.ai
  • Hours: Mon–Fri, 09:00–18:00 UTC
  • First response SLA: Within 1 business day