Gestão de projetos
Asana no seu produto e nos seus agentes de IA, por uma API
O toolkit do Asana lista workspaces, times e projetos, e cria, lê, atualiza e exclui tarefas e seus comentários. Seu produto ou agente de IA os chama pelo Connect, que guarda a API key ou as credenciais OAuth e registra cada execução.
15 dias para testar. Sem cartão de crédito.
POST https://connect.reportei.com/api/tools/asana_create_project/execute
Authorization: Bearer <merchant token>
x-customer-token: <customer token>
Content-Type: application/json
Accept: application/json
{
"customer_toolkit": "<connection UUID>",
"arguments": {
"data": {}
}
}Como funciona
Do cliente conectado à primeira chamada no Asana.
- 1
O cliente conecta a conta
Seu sistema abre uma sessão do Connect para o toolkit e o cliente conecta a conta do Asana. Você recebe o id da conexão.
- 2
Seu produto chama a tool
Um POST em /api/tools/{tool}/execute com o id da conexão e os argumentos. Em caso de sucesso, o Connect preserva o status e o corpo da resposta do app.
- 3
O Connect cuida do resto
Guarda a credencial criptografada, renova tokens quando a conexão usa OAuth com suporte a renovação e registra as execuções numa trilha de auditoria consultável pela API.
Para que usar
O que o seu produto faz com o Asana.
Leve trabalho para o Asana
Um SaaS transforma um evento, como uma proposta aprovada, em uma tarefa no projeto certo do Asana do cliente.
Status nos dois sentidos
Uma ferramenta de agência lista as tarefas de um projeto e as conclui ou atualiza pelo próprio painel.
Agente de tarefas com comentários
Um agente de IA cria uma tarefa a partir de uma conversa, lê suas stories e adiciona um comentário com o próximo passo.
Tools
12 tools do Asana
- Listar workspacesGETLista os workspaces e organizações que o usuário pode ver. Use o gid de um item como workspace nas outras tools.
- Listar timesGETLista os times de uma organização que o usuário pode ver. Um projeto criado em uma organização precisa do gid de um deles como team.
- Listar projetosGETLista os projetos de um workspace. Só gid e name voltam, a menos que opt_fields peça mais. Envie limit para paginar.
- Criar projetoPOSTCria um projeto e o devolve. Os campos vão dentro de data, que precisa de name e workspace, mais team quando o workspace é uma organização.
- Atualizar projetoPUTAtualiza um projeto e o devolve. Só os campos enviados dentro de data mudam.
- Listar tarefasGETLista as tarefas de um projeto ou seção, ou as tarefas atribuídas a alguém em um workspace. Envie project, section, ou assignee junto com workspace.
- Obter tarefaGETDevolve o registro completo de uma tarefa: nome, notas, responsável, datas, conclusão, projetos e campos personalizados.
- Criar tarefaPOSTCria uma tarefa e a devolve. Os campos vão dentro de data, que precisa de workspace, projects ou parent; projects e parent já definem o workspace.
- Atualizar tarefaPUTAtualiza uma tarefa e a devolve. Só os campos enviados dentro de data mudam; completed true conclui a tarefa. Projetos e seguidores não mudam aqui.
- Excluir tarefaDELETEExclui uma tarefa. Ela vai para a lixeira do usuário e pode ser restaurada lá em até 30 dias.
Chave de API
O cliente cola a chave do app numa tela do Connect, ou o seu sistema envia a chave por POST /api/customer-toolkits, sem tela.
OAuth com o app do seu produto
Você cadastra o app OAuth do seu produto uma vez, em POST /api/merchants/credentials/asana, e o cliente autoriza a conta numa tela de consentimento. O Connect renova o token quando ele está para vencer.
Perguntas sobre o toolkit do Asana
Preciso implementar a API do Asana?
Não. O Connect já traz 12 tools do Asana descritas e prontas. Seu cliente conecta a conta e o seu sistema chama cada tool pelo mesmo endpoint, com o mesmo formato de requisição.
Como o cliente conecta a conta do Asana?
Pelo modo que o toolkit aceita: Chave de API, OAuth com o app do seu produto. O Connect guarda a credencial criptografada e nunca a devolve ao seu sistema.
Funciona com agentes de IA?
Sim. O input de cada tool é descrito em JSON Schema, que o seu agente usa direto como definição de tool. O agente escolhe a tool e os argumentos, e o seu sistema faz a chamada ao Connect.
Meu cliente precisa ter conta no Reportei?
Não. O cliente conecta a conta numa tela do Connect, ou o seu sistema envia a credencial pela API, e ele continua usando só o seu produto.
Veja o Connect aplicado ao seu produto.
Teste por 15 dias sem cartão, ou mostre seu cenário ao nosso time.
