Jira
Connect Jira to sync requirements and file issues.
Connect Jira so work doesn't stop at the ticket. Turn a ticket into a test, launch runs from Jira, and send verified results back — without leaving Jira.
Connect once in Settings, and you can:
- Turn a ticket into a test — import it into the workflow builder with a suggested goal.
- Trigger runs from Jira — tag a ticket, or ask the Slack assistant to test it.
- Send results back — verdict, verified issues, and replay links, written onto the ticket.
- File defects to Jira — push a Cofactor issue back as a Jira issue.
- Look up tickets from Slack — search connected Jira tickets in assistant threads.
- Keep statuses in sync — Cofactor updates connected issues through a webhook.
01Connect Jira
You need admin access in your Cofactor organization.
- Open Settings > Jira.
- Connect your Jira workspace and complete the OAuth flow.
- Confirm the connection validates, then save your Jira defaults.
Saving defaults also registers the status-sync webhook (when supported). The Status sync health indicator shows whether it's active.
Multiple properties? Set Tag-triggered ad-hoc test routing before relying on tags to launch runs, or Cofactor may skip those runs.
02Turn a Jira ticket into a test
Import a ticket into the workflow builder instead of retyping it.
- Open the workflow builder import flow and select Jira.
- Search by key, title, or details.
- Select the issue to pull in its details.
- Review the suggested goal and context, then continue into the builder.
03Launch a test from a Jira ticket
Two paths, no need to open Cofactor:
- Tag a ticket — apply your trigger tag and Cofactor launches an ad-hoc test. In a multi-property org, it runs in the property set under Tag-triggered ad-hoc test routing.
- Ask in Slack — tell the assistant to test a ticket; request, progress, and results stay in one thread.
To route tagged tickets by property: open Settings > Jira, set Tag-triggered ad-hoc test routing to the right property, save, then tag a ticket and confirm the run appears. Use this when several teams share one Jira integration.
04Send results back to Jira
When a Slack-triggered ad-hoc test tied to a ticket finishes, Cofactor writes the outcome onto the ticket. Depending on the run, it can show:
| Artifact | What appears on the ticket |
|---|---|
| Rich result comment | A formatted comment summarizing the verdict with links |
| Verified issue links | Clickable references to the related verified issue |
| Cofactor run link | A direct link to the completed run |
| Replay link | A direct link to the replay evidence |
| Replay attachment | A replay file or reference attached to the ticket |
05File a Cofactor issue back to Jira
When testing surfaces a defect, create a Jira issue from the Cofactor issue to hand it to your team — keeping testing output in the Jira process you already use.
06Look up Jira tickets from Slack
Pull ticket details into a conversation without switching tools.
- In a Slack assistant thread, ask for a ticket by key, title, or details.
- Review the results and continue with follow-ups about status, ownership, or related work.
07Keep Jira statuses in sync
When active, Cofactor keeps connected issues updated through a webhook. If sync degrades or stops:
- Open Settings > Jira and review Status sync health.
- If degraded or inactive, click Repair Sync.
- If repair doesn't work, click Re-register to recreate the webhook, then confirm it's active.
Use Repair Sync when the setup can still be fixed; use Re-register when the webhook is missing.
08Settings reference
| Setting | What it does |
|---|---|
| Connection validation | Confirms Cofactor can reach your Jira workspace |
| Default Jira settings | Saves the defaults Cofactor uses for connected work |
| Tag-triggered ad-hoc test routing | Which property receives tests from tagged tickets |
| Status sync health | Whether status sync is active, degraded, or inactive |
| Repair Sync | Restores sync without recreating the setup |
| Re-register | Recreates the webhook when sync is missing |
09Troubleshooting
| Problem | What to do |
|---|---|
| Can't find the issue to import | Confirm it exists in the connected project and you have access, then search by key or a sharper title. |
| Import error | Re-open the import flow, verify the connection, and retry. Revalidate the integration if it persists. |
| Reframing error after import | Import again; check the summary and description have enough detail. Add context in Jira if sparse. |
| Tagged tickets don't launch tests | Confirm Tag-triggered ad-hoc test routing points to the right property, save, and re-tag. |
| Tagged tickets run in the wrong property | Update the routing setting and re-test with a new tag. |
| Status sync degraded or inactive | Review sync health, click Repair Sync, then Re-register if needed. |
10Related
- Slack
- Ad-hoc testing — ticket-linked runs and writebacks
- Import Jira tickets into workflows
- Issues
- Flows