Gestão de projetos
ClickUp no seu produto e nos seus agentes de IA, por uma API
O toolkit do ClickUp cobre Workspaces, Spaces, Folders, Lists, tarefas e comentários de tarefas. Seu cliente autoriza o ClickUp uma vez com OAuth, e seu produto ou agente de IA chama cada operação pelo Connect, que guarda e renova as credenciais e registra cada execução.
15 dias para testar. Sem cartão de crédito.
POST https://connect.reportei.com/api/tools/clickup_create_list/execute
Authorization: Bearer <merchant token>
x-customer-token: <customer token>
Content-Type: application/json
Accept: application/json
{
"customer_toolkit": "<connection UUID>",
"arguments": {
"folder_id": "<folder_id>",
"name": "<name>"
}
}Como funciona
Do cliente conectado à primeira chamada no ClickUp.
- 1
O cliente conecta a conta
Seu sistema abre uma sessão do Connect para o toolkit e o cliente conecta a conta do ClickUp. 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 ClickUp.
Transformar tickets em tarefas
Quando um pedido de suporte ou uma negociação chega a um estado no seu produto, crie uma tarefa na List certa com responsáveis e data de entrega.
Sincronizar o status das tarefas
Busque tarefas de todo o Workspace por data e atualize o status, para seu produto mostrar o que vence na semana e marcar o trabalho como concluído.
Assistente de projetos com IA
Deixe um agente de IA navegar por Spaces e Lists, ler uma tarefa com seus checklists e publicar comentários, sem você escrever a integração com o ClickUp.
Tools
14 tools do ClickUp
- Listar workspacesGETLista os Workspaces (chamados de teams na API v2) que o usuário autorizou na conexão, cada um com seu id e seus membros. Os ids de usuário dos membros são os que os argumentos assignee aceitam.
- Listar spacesGETLista os Spaces de um Workspace, com os status de tarefa que cada Space define. Os nomes de status são os que os argumentos status das ferramentas de tarefa aceitam.
- Listar foldersGETLista os Folders de um Space. Os subfolders vêm na mesma lista plana, com parent_folder contendo o id do Folder onde estão.
- Listar listsGETLista as Lists de um Folder. As Lists que ficam direto em um Space, fora de qualquer Folder, vêm de List folderless lists.
- Listar lists sem folderGETLista as Lists que ficam direto em um Space, fora de qualquer Folder.
- Criar listPOSTCria uma List em um Folder. Exige name. A List usa os status de tarefa do seu Folder ou Space.
- Listar tarefasGETLista as tarefas que têm como origem uma List, até 100 por página, sem tarefas fechadas e subtarefas, a menos que peçam. Percorra com page enquanto last_page na resposta for false. As datas são Unix time em milissegundos.
- Buscar tarefasGETBusca as tarefas de um Workspace inteiro por data, como as que vencem esta semana em todas as Lists, até 100 por página e sem tarefas fechadas, a menos que peçam. Percorra com page até uma resposta trazer menos de 100 tarefas. As datas são Unix time em milissegundos.
- Obter tarefaGETRetorna uma tarefa com status, responsáveis, datas, tags, valores de campos personalizados, checklists e anexos.
- Criar tarefaPOSTCria uma tarefa em uma List. Exige name. O ClickUp notifica os responsáveis e observadores, e também o criador quando notify_all é true. As datas são Unix time em milissegundos.
OAuth com o app do seu produto
Você cadastra o app OAuth do seu produto uma vez, em POST /api/merchants/credentials/clickup, 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 ClickUp
Preciso implementar a API do ClickUp?
Não. O Connect já traz 14 tools do ClickUp 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 ClickUp?
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.
