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

# Asana Toolkit

> Interaja com projetos, tarefas e usuários do Asana a partir de um workflow.

O **Asana Toolkit** permite que seus workflows interajam com o Asana — recuperando projetos, tarefas, usuários e workspaces, além de criar e atualizar tarefas.

## Autenticação

Todas as ferramentas do Asana requerem uma conexão de conta do Asana. Cada ferramenta inclui um seletor **Asana Account** com duas opções:

| Opção                    | Descrição                                                                  |
| ------------------------ | -------------------------------------------------------------------------- |
| **Use my Asana account** | Usa sua conta pessoal conectada do Asana.                                  |
| **Use team account**     | Usa uma conta compartilhada do Asana da equipe configurada para o projeto. |

Se nenhuma conta estiver conectada, clique em **Connect Asana Account** para autenticar.

## Ferramentas

### Get Asana Projects

Recupera todos os projetos acessíveis pela conta do Asana conectada.

| Campo             | Obrigatório | Descrição                                          |
| ----------------- | ----------- | -------------------------------------------------- |
| **Asana Account** | Sim         | Selecione sua conta pessoal ou de equipe do Asana. |

### Get Asana Users

Recupera todos os usuários no workspace do Asana conectado.

| Campo             | Obrigatório | Descrição                                          |
| ----------------- | ----------- | -------------------------------------------------- |
| **Asana Account** | Sim         | Selecione sua conta pessoal ou de equipe do Asana. |

### Get Asana Workspaces

Recupera todos os workspaces acessíveis pela conta do Asana conectada.

| Campo             | Obrigatório | Descrição                                          |
| ----------------- | ----------- | -------------------------------------------------- |
| **Asana Account** | Sim         | Selecione sua conta pessoal ou de equipe do Asana. |

### Get Asana Custom Fields

Recupera as definições de campos personalizados configurados para um projeto específico do Asana.

| Campo             | Obrigatório | Descrição                                                                                                      |
| ----------------- | ----------- | -------------------------------------------------------------------------------------------------------------- |
| **Asana Account** | Sim         | Selecione sua conta pessoal ou de equipe do Asana.                                                             |
| **Project Id**    | Sim         | O ID do projeto de onde obter as definições de campos personalizados. Digite `@` para selecionar uma variável. |

### Get Asana Tasks

Recupera tarefas de um projeto específico do Asana com filtros opcionais para responsável, workspace e paginação.

| Campo             | Obrigatório | Descrição                                                                                                          |
| ----------------- | ----------- | ------------------------------------------------------------------------------------------------------------------ |
| **Asana Account** | Sim         | Selecione sua conta pessoal ou de equipe do Asana.                                                                 |
| **Project Id**    | Sim         | O ID do projeto de onde obter as tarefas. Digite `@` para selecionar uma variável.                                 |
| **Limit**         | Não         | Número máximo de tarefas a retornar por solicitação da API. O padrão é `50`.                                       |
| **Assignee**      | Não         | Filtrar tarefas por ID de usuário ou e-mail do responsável. O padrão é `null`.                                     |
| **Workspace**     | Não         | Filtrar tarefas por ID do workspace. Usa o workspace padrão se não fornecido. O padrão é `null`.                   |
| **Offset**        | Não         | Token de offset inicial para paginação. Geralmente não necessário, pois busca todas as páginas. O padrão é `null`. |

### Get Asana User Tasks

Recupera todas as tarefas atribuídas a um usuário específico no Asana.

| Campo             | Obrigatório | Descrição                                                                                                          |
| ----------------- | ----------- | ------------------------------------------------------------------------------------------------------------------ |
| **Asana Account** | Sim         | Selecione sua conta pessoal ou de equipe do Asana.                                                                 |
| **Assignee**      | Sim         | O ID de usuário ou endereço de e-mail para buscar tarefas. Digite `@` para selecionar uma variável.                |
| **Workspace**     | Não         | ID do workspace para pesquisar. Usa o workspace padrão se não fornecido. O padrão é `null`.                        |
| **Limit**         | Não         | Número máximo de tarefas a retornar por solicitação da API. O padrão é `50`.                                       |
| **Offset**        | Não         | Token de offset inicial para paginação. Geralmente não necessário, pois busca todas as páginas. O padrão é `null`. |

### Create Asana Task

Cria uma nova tarefa em um projeto específico do Asana.

| Campo             | Obrigatório | Descrição                                                                                                                                                                                         |
| ----------------- | ----------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Asana Account** | Sim         | Selecione sua conta pessoal ou de equipe do Asana.                                                                                                                                                |
| **Project Id**    | Sim         | O ID do projeto onde a tarefa será criada. Digite `@` para selecionar uma variável.                                                                                                               |
| **Name**          | Sim         | O nome/título da tarefa. Digite `@` para selecionar uma variável.                                                                                                                                 |
| **Notes**         | Não         | Descrição ou notas da tarefa. O padrão é `null`.                                                                                                                                                  |
| **Assignee**      | Não         | E-mail ou ID da pessoa para atribuir a tarefa. O padrão é `null`.                                                                                                                                 |
| **Due Date**      | Não         | Data de vencimento no formato ISO (`YYYY-MM-DD`) ou qualquer formato de data analisável. O padrão é `null`.                                                                                       |
| **Tags**          | Não         | Array de nomes de tags ou GIDs de tags para atribuir à tarefa. O padrão é `null`.                                                                                                                 |
| **Custom Fields** | Não         | Campos personalizados como um dicionário. Formato: `{"field_gid": "value"}` ou `{"field_name": "value"}`. Para campos de enumeração, use o GID ou nome da opção de enumeração. O padrão é `null`. |

### Update Asana Task

Atualiza uma tarefa existente do Asana pelo seu ID.

| Campo             | Obrigatório | Descrição                                                                                                                                |
| ----------------- | ----------- | ---------------------------------------------------------------------------------------------------------------------------------------- |
| **Asana Account** | Sim         | Selecione sua conta pessoal ou de equipe do Asana.                                                                                       |
| **Task Id**       | Sim         | O ID da tarefa a ser atualizada. Digite `@` para selecionar uma variável.                                                                |
| **Name**          | Não         | Novo nome/título para a tarefa. O padrão é `null`.                                                                                       |
| **Notes**         | Não         | Nova descrição ou notas para a tarefa. O padrão é `null`.                                                                                |
| **Completed**     | Não         | Marcar a tarefa como concluída (`true`) ou incompleta (`false`). O padrão é `null`.                                                      |
| **Custom Fields** | Não         | Campos personalizados a atualizar como um dicionário. Formato: `{"field_gid": "value"}` ou `{"field_name": "value"}`. O padrão é `null`. |
