Jira Integration
Overview
The Jira integration syncs your Jira issues with Flaio sessions, enabling status mapping and automatic progress tracking.
Setup
- Go to Organization Settings > Integrations > Jira.
- Click Connect Jira to start the OAuth flow.
- Authorize Flaio to access your Jira instance.
- Select the Jira projects you want to sync.
Features
Project Mapping
Map Jira projects to your Flaio teams. This scopes issue syncing so that each team only sees relevant issues.
Status Mapping
Configure how Jira issue statuses map to Flaio session states. For example:
| Jira Status | Flaio State |
|---|---|
| To Do | Not Started |
| In Progress | Active |
| Done | Completed |
Status mappings use status names, allowing them to work across different Jira workflows.
Webhooks
Flaio registers a webhook with your Jira instance to receive real-time updates when issues change. This keeps Flaio sessions in sync with your Jira board.
Comment Sync
Comments added to a Flaio session can be synced back to the corresponding Jira issue, keeping all context in one place.
Troubleshooting
- OAuth fails — ensure you have admin access to the Jira project
- Status mapping issues — verify that your Jira workflow status names match the configured mappings
- Webhook not working — check that the webhook URL is reachable from your Jira instance