> ## Documentation Index
> Fetch the complete documentation index at: https://www.bugzy.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Asana

> Connect Asana for automatic task creation when Bugzy triages product failures.

Asana integration enables automatic task creation for failures that Bugzy triages as product bugs. When tests fail and Bugzy determines the failure is a genuine product issue, it creates a task in your Asana project with full reproduction details.

## What Asana enables

* **Automatic task creation** — Triaged product failures are filed as Asana tasks without manual intervention
* **Duplicate detection** — Bugzy checks existing tasks before creating new ones to avoid duplicates
* **Rich bug reports** — Tasks include reproduction steps, error details, screenshots, and environment info
* **Priority mapping** — Task priority is set based on failure severity and impact

## Setup

<Steps>
  <Step title="Navigate to connections">
    Go to **Dashboard > Projects > \[Your Project] > Connections**.
  </Step>

  <Step title="Connect Asana">
    Click **Connect Asana**. This opens the OAuth flow managed by Nango.
  </Step>

  <Step title="Authorize access">
    Grant access to your Asana workspace.
  </Step>

  <Step title="Configure project mapping">
    After connecting, select the Asana workspace and project where tasks should be created.
  </Step>
</Steps>

## How task creation works

The task creation flow follows the same pattern as [Jira bug filing](/docs/integrations/jira#how-bug-filing-works):

1. **Test execution** — Bugzy runs tests and collects results
2. **Triage** — Bugzy analyzes failures, categorizing each as: product bug, test issue, or environment problem
3. **Duplicate check** — For product bugs, the agent searches existing Asana tasks to avoid duplicates
4. **Create task** — If no duplicate exists, a task is created with structured details
5. **Notify team** — If Slack/Teams is connected, the team is notified about the new task

### Task contents

Each filed Asana task includes:

| Field         | Content                                          |
| ------------- | ------------------------------------------------ |
| Name          | Concise description of the failure               |
| Description   | Detailed reproduction steps                      |
| Error details | Stack traces, error messages, assertion failures |
| Attachments   | Screenshots captured during test execution       |
| Tags          | `bugzy-automated`, test case ID                  |
| Priority      | Based on failure severity and impact             |

## Troubleshooting

**Tasks not being created** — Verify the Asana connection is active and the project mapping is configured. Check that the connected user has permission to create tasks in the target project.

**Duplicate tasks being filed** — The agent uses title and error signature matching for duplicate detection. If you see duplicates, ensure the project mapping is correct.

**"Forbidden" errors** — The OAuth token may lack required permissions. Disconnect and reconnect Asana from the project connections page to re-authorize.