Gestão de projetos
Teamwork.com no seu produto e nos seus agentes de IA, por uma API
O toolkit do Teamwork.com cobre projetos, listas de tarefas, tarefas com comentários, as pessoas do site e lançamentos de tempo. Pelo Connect, um produto ou agente de IA cria e conclui tarefas e registra horas faturáveis no Teamwork do cliente sem construir a integração nem guardar as credenciais.
15 dias para testar. Sem cartão de crédito.
POST https://connect.reportei.com/api/tools/teamwork_create_task/execute
Authorization: Bearer <merchant token>
x-customer-token: <customer token>
Content-Type: application/json
Accept: application/json
{
"customer_toolkit": "<connection UUID>",
"arguments": {
"tasklistId": 1,
"task": {}
}
}Como funciona
Do cliente conectado à primeira chamada no Teamwork.com.
- 1
O cliente conecta a conta
Seu sistema abre uma sessão do Connect para o toolkit e o cliente conecta a conta do Teamwork.com. 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 Teamwork.com.
Tarefas criadas pelo produto
Crie uma tarefa em uma lista, atribua a uma pessoa e adicione um comentário quando algo no seu app precisar de acompanhamento da equipe do cliente.
Registro de horas por agente
Deixe um agente de IA registrar tempo em uma tarefa, com os minutos e a data, e listar os lançamentos faturáveis para uma fatura.
Status de projeto para clientes
Liste projetos e suas tarefas abertas e mostre o andamento de cada um ao cliente no seu próprio portal.
Tools
13 tools do Teamwork.com
- Listar projetosGETLista os projetos a que o usuário conectado tem acesso, 50 por página por padrão. Pagine com page, a partir de 1, enquanto meta.page.hasMore na resposta for true.
- Listar listas de tarefasGETLista as listas de tarefas de um projeto. As tarefas são criadas dentro de uma lista. Pagine com page, a partir de 1, enquanto meta.page.hasMore na resposta for true.
- Listar tarefasGETLista as tarefas a que o usuário conectado tem acesso, em todos os projetos ou por projeto, lista de tarefas ou responsável, 50 por página por padrão e sem as tarefas concluídas, a menos que seja pedido. Pagine com page, a partir de 1, enquanto meta.page.hasMore na resposta for true.
- Obter tarefaGETRetorna uma tarefa com descrição, status, prioridade, datas, responsáveis, estimativa e progresso.
- Criar tarefaPOSTCria uma tarefa em uma lista de tarefas. Exige task com um name. As datas são yyyy-MM-dd.
- Atualizar tarefaPATCHAtualiza os campos enviados de uma tarefa e mantém os outros. Para concluir uma tarefa, use Complete task. As datas são yyyy-MM-dd.
- Concluir tarefaPUTMarca uma tarefa como concluída. É a rota que o Teamwork documenta para concluir tarefas, na API v1.
- Excluir tarefaDELETEExclui uma tarefa e suas subtarefas.
- Listar comentários da tarefaGETLista os comentários de uma tarefa. Pagine com page, a partir de 1, enquanto meta.page.hasMore na resposta for true.
- Criar comentário na tarefaPOSTAdiciona um comentário a uma tarefa. Exige comment com um body.
OAuth com o app do seu produto
Você cadastra o app OAuth do seu produto uma vez, em POST /api/merchants/credentials/teamwork, e o cliente autoriza a conta numa tela de consentimento. O Connect renova o token quando ele está para vencer.
Na conexão, o cliente informa também {site}: o endereço da conta dele na API do app.
Perguntas sobre o toolkit do Teamwork.com
Preciso implementar a API do Teamwork.com?
Não. O Connect já traz 13 tools do Teamwork.com 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 Teamwork.com?
Pelo modo que o toolkit aceita: 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.
