Onboarding: Jira Ticketing Mode

This guide walks through the full onboarding wizard for teams that use Jira as a ticketing system. In this mode, Zero0 syncs work items between Jira and the Zero0 Board, letting you trigger AI execution on stories from your existing Jira backlog.

Step 1: Choose Your VCS Provider (Required)​

The first step asks you to select a version control provider. Zero0 supports three providers:

Provider	Connection Method	Description
GitHub	GitHub App	Connect to GitHub for repositories and pull requests
Bitbucket	OAuth	Connect via OAuth for Bitbucket Cloud workspaces
GitLab	OAuth	Connect via OAuth for GitLab.com groups and projects

Select your provider and click Continue. You can add more providers later from Settings → Integrations.

Step 2: Connect Your VCS Provider (Required)​

After selecting a provider, the wizard guides you through connecting it. Follow the instructions for your chosen provider below.

GitHub​

1. Click Connect to Git to open the GitHub authorization popup
2. Select the GitHub organization or user account to grant access to
3. Choose which repositories to grant access to (all or specific repos)
4. Once connected, the wizard shows your available repositories
5. Select at least one repository to use as an execution target — these are the repos the AI agent will work in
6. Click Continue

GitLab​

1. Click Connect to Git to open the GitLab authorization popup
2. Grant Zero0 access to your GitLab.com group
3. Once connected, the wizard displays your group name and lists your accessible projects
4. Select at least one project to use as an execution target
5. Click Continue

Bitbucket​

1. Click Connect to Git to open the Bitbucket authorization popup
2. Grant Zero0 access to your Bitbucket Cloud account
3. Once connected, enter your workspace slug — the first path segment of your repository URLs (e.g., for bitbucket.org/zero0ai/my-repo, the workspace slug is zero0ai)
4. Click Save to confirm the workspace
5. The wizard lists your accessible repositories — select at least one as an execution target
6. Click Continue

Step 3: Connect Jira​

There are two supported ways to connect Jira in the wizard. Which one you see depends on your account: new accounts see Install Zero0 for Jira & Confluence, and accounts already connected through OAuth see Connect Jira (OAuth) until Zero0 moves them to the app with you.

Option A: Install the Zero0 app​

This path has three steps and no webhook. You must be an Atlassian site admin to install the app.

1. In Zero0: click Install Zero0 for Jira & Confluence. Atlassian's install page opens in a new tab. Choose your site and tick Jira and Confluence together. Atlassian shows a yellow banner, "Only install apps from developers you trust. Before you install this app on your Atlassian site, please review app permissions and vendor details." This is Atlassian's standard notice for apps installed outside its Marketplace, and it is expected.
2. In Jira: open the app's Get started page and click Connect to Zero0. Click Get started on Atlassian's post-install screen if it shows one. Otherwise go to Jira Settings (⚙) → Apps → Manage apps → Zero0 → Get started.
3. In Zero0: the confirm screen asks Connect <site> to your Zero0 account? Check the site name and click Confirm.

The confirm screen may open in a new tab. Return to your Zero0 onboarding tab: the wizard detects the connection and moves on by itself. Because one install covers Jira and Confluence, Confluence is connected too.

After this path, skip to Step 5. There is no webhook step.

Once connected, Zero0 shows as the reporter of tasks it creates, and as the author of comments and status changes it makes. Tasks and comments created by people still show those people. If Zero0 lists projects it cannot access, add the atlassian-addons-project-access role back to the project's permission scheme. See Jira Integration for details.

Option B: Connect with OAuth​

Connect your Atlassian workspace with OAuth so Zero0 can sync with your Jira projects:

1. Click Connect Jira to open the OAuth authorization popup
2. Sign in to your Atlassian account and authorize Zero0
3. Once connected, the wizard displays your Jira domain (e.g., your-team.atlassian.net)
4. Click Continue

Step 4: Configure Jira Webhook (OAuth only)​

Accounts that installed the Zero0 app skip this step. For OAuth connections, this step sets up a webhook so Jira notifies Zero0 when work items change:

1. Navigate to Jira Settings → System → WebHooks (a direct link is provided)

2. Create a new webhook named Zero0

3. Copy the webhook URL from the wizard into Jira's URL field

4. Generate a webhook secret in the wizard and paste it into Jira

5. Enable the Issue checkboxes: Created, Updated, Deleted

   warning

   Jira lists many similar checkboxes on this page. Check only the three under the Issue section — leave every other checkbox unchecked.

6. Save the webhook in Jira, then click Continue

Step 5: Add Jira Statuses​

Zero0 uses custom statuses to track stories through the execution pipeline:

1. Navigate to your Jira Statuses page (a direct link is provided)
2. Add the following statuses with the In Progress category:
   • Enriched — story has been analyzed by AI
   • Product Approved — story spec approved by product owner
   • Ready For Dev — subtasks generated, ready for implementation
   • Validation — PRs created, awaiting review
3. Add workflow transitions so stories can move to these statuses
4. Click Continue

Step 6: Name Your Levels​

Zero0 organises work in four levels: initiative, epic, story and subtask. This step chooses what your account calls them in Zero0.

For a Jira account, the names start on the Jira preset: Initiative / Epic / Story / Subtask, which are Zero0' own names.

1. Keep the Jira preset, choose Azure DevOps (Agile), or edit the names to make your own
2. For each level, set the article (a or an), the singular and the plural
3. Click Continue. The names shown are saved, even if you didn't change them

Only admins can change the names. Other users see them read-only and can click Continue. You can change the names later in Settings → Level naming. See Naming Your Levels for the rules and for where the names are used.

Step 7: Connect Slack or Microsoft Teams (Optional)​

Zero0 messages people through one platform: Slack or Microsoft Teams. Choose the one your team uses; it enables notifications and interactive Q&A during story analysis.

Slack

1. Select Slack, then click Connect Slack to open the authorization popup
2. Select your Slack workspace and authorize Zero0
3. Once connected, the workspace name is displayed

Microsoft Teams

1. Select Microsoft Teams, then click Connect Microsoft Teams
2. Sign in with a Microsoft 365 administrator account and grant admin consent
3. Once connected, the tenant name is displayed. Zero0 switches messaging to Teams (if it doesn't, click Use Microsoft Teams)

Installing the Zero0 app in Teams happens afterwards: download the app package with Download Teams app in Settings → Integrations → Teams, then a Teams admin uploads it to your organization's app catalog in the Teams admin center → Teams apps → Manage apps → Upload new app (not as a personal custom app). See Step 2 of the Microsoft Teams guide.

This step is optional — click Skip for now if you prefer to set it up later. Without a messaging platform, Q&A interactions happen directly on the Board.

Completing Onboarding​

After finishing all steps, the wizard marks your onboarding as complete and redirects you to the Board — the main workspace where you'll create and manage stories.

Your onboarding progress is saved automatically, so if you close the wizard mid-way, you'll resume where you left off on your next sign-in.

Next Steps​

With your account configured, continue to Connecting Integrations for a deeper dive into each integration, or jump to Creating Your First AI Story to start using the platform.