Gestão de projetos
Wrike no seu produto e nos seus agentes de IA, por uma API
O toolkit do Wrike cobre espaços, pastas e projetos, tarefas com comentários, contatos e workflows com seus status personalizados. Pelo Connect, um produto ou agente de IA cria e movimenta trabalho no Wrike 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/wrike_create_folder/execute
Authorization: Bearer <merchant token>
x-customer-token: <customer token>
Content-Type: application/json
Accept: application/json
{
"customer_toolkit": "<connection UUID>",
"arguments": {
"folderId": "<folderId>",
"title": "<title>"
}
}Como funciona
Do cliente conectado à primeira chamada no Wrike.
- 1
O cliente conecta a conta
Seu sistema abre uma sessão do Connect para o toolkit e o cliente conecta a conta do Wrike. 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 Wrike.
Tarefas criadas pelo produto
Crie uma tarefa em uma pasta ou projeto quando um cliente aprovar algo ou um lead converter, atribuída ao contato certo.
Perguntas de carga de trabalho por agente
Deixe um agente de IA buscar as tarefas atribuídas a alguém ou com prazo nesta semana e responder o que está na mesa de cada pessoa.
Atualização de status com comentário
Atualize uma tarefa para um status personalizado do grupo Completed e adicione um comentário explicando o que foi entregue.
Tools
13 tools do Wrike
- Listar pastasGETLista os espaços, pastas e projetos da conta. Sem filtros, retorna a árvore de pastas inteira, com id, title, childIds e scope de cada item, inclusive a pasta raiz da conta (scope WsRoot). Qualquer filtro retorna uma lista plana com os campos completos, incluindo status e datas dos projetos, até 1000 por página.
- Criar pastaPOSTCria uma pasta dentro de um espaço, pasta ou projeto, ou um projeto quando project é enviado. Exige title. Listas e objetos vão como texto JSON.
- Atualizar pastaPUTAtualiza os campos enviados de uma pasta ou projeto e mantém os outros, como o título, o status do projeto, as datas e os responsáveis, ou as pastas que o contêm. Listas e objetos vão como texto JSON.
- Listar tarefasGETLista as tarefas de um espaço, pasta ou projeto, até 1000 por página. Quando a resposta traz nextPageToken, envie-o para buscar a próxima página.
- Buscar tarefasGETBusca as tarefas da conta inteira, como as atribuídas a alguém ou com prazo nesta semana, até 1000 por página. Quando a resposta traz nextPageToken, envie-o para buscar a próxima página.
- Obter tarefaGETRetorna uma ou mais tarefas com descrição, responsáveis, datas, status, status personalizado, as pastas que as contêm, campos personalizados e subtarefas.
- Criar tarefaPOSTCria uma tarefa em um espaço, pasta ou projeto. Exige title. Sem datas, a tarefa vai para o backlog. Listas e objetos vão como texto JSON.
- Atualizar tarefaPUTAtualiza os campos enviados de uma tarefa e mantém os outros. Para concluí-la, envie status Completed ou um status personalizado do grupo Completed. Listas e objetos vão como texto JSON.
- Excluir tarefaDELETEMove uma tarefa para a Lixeira. Update task com restore true a traz de volta.
- Listar comentários da tarefaGETLista os comentários de uma tarefa, em HTML, a menos que plainText seja true.
OAuth com o app do seu produto
Você cadastra o app OAuth do seu produto uma vez, em POST /api/merchants/credentials/wrike, 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 {host}: o endereço da conta dele na API do app.
Perguntas sobre o toolkit do Wrike
Preciso implementar a API do Wrike?
Não. O Connect já traz 13 tools do Wrike 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 Wrike?
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.
