Gestión de proyectos
ClickUp en tu producto y en tus agentes de IA, con una API
El toolkit de ClickUp cubre Workspaces, Spaces, Folders, Lists, tareas y comentarios de tareas. Tu cliente autoriza ClickUp una vez con OAuth, y tu producto o agente de IA llama cada operación a través de Connect, que guarda y renueva las credenciales y registra cada ejecución.
15 días de prueba. Sin tarjeta 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>"
}
}Cómo funciona
Del cliente conectado a la primera llamada a ClickUp.
- 1
Tu cliente conecta la cuenta
Tu sistema abre una sesión de Connect para el toolkit y tu cliente conecta su cuenta de ClickUp. Recibes el id de la conexión.
- 2
Tu producto llama a la tool
Un POST a /api/tools/{tool}/execute con el id de la conexión y los argumentos. Si la llamada tiene éxito, Connect conserva el status y el cuerpo de la respuesta de la app.
- 3
Connect se encarga del resto
Guarda la credencial cifrada, renueva tokens en conexiones OAuth que admiten renovación y registra las ejecuciones en un historial de auditoría disponible por API.
Casos de uso
Qué hace tu producto con ClickUp.
Convertir tickets en tareas
Cuando una solicitud de soporte o una negociación llega a cierto estado en tu producto, crea una tarea en la List correcta con responsables y fecha de entrega.
Sincronizar el estado de las tareas
Busca tareas de todo el Workspace por fecha y actualiza su estado, para que tu producto muestre lo que vence esta semana y marque el trabajo como completado.
Asistente de proyectos con IA
Deja que un agente de IA navegue por Spaces y Lists, lea una tarea con sus checklists y publique comentarios, sin que escribas la integración con ClickUp.
Tools
14 tools de ClickUp
- Listar workspacesGETLista los Workspaces (llamados teams en la API v2) que el usuario autorizó en la conexión, cada uno con su id y sus miembros. Los ids de usuario de los miembros son los que aceptan los argumentos assignee.
- Listar spacesGETLista los Spaces de un Workspace, con los estados de tarea que define cada Space. Los nombres de estado son los que aceptan los argumentos status de las herramientas de tarea.
- Listar foldersGETLista los Folders de un Space. Los subfolders vienen en la misma lista plana, con parent_folder con el id del Folder donde están.
- Listar listsGETLista las Lists de un Folder. Las Lists que están directamente en un Space, fuera de cualquier Folder, vienen de List folderless lists.
- Listar lists sin folderGETLista las Lists que están directamente en un Space, fuera de cualquier Folder.
- Crear listPOSTCrea una List en un Folder. Requiere name. La List usa los estados de tarea de su Folder o Space.
- Listar tareasGETLista las tareas cuyo origen es una List, hasta 100 por página, sin tareas cerradas ni subtareas salvo que se pidan. Recorre con page mientras last_page en la respuesta sea false. Las fechas son Unix time en milisegundos.
- Buscar tareasGETBusca las tareas de todo un Workspace por fecha, como las que vencen esta semana en todas las Lists, hasta 100 por página y sin tareas cerradas salvo que se pidan. Recorre con page hasta que una respuesta traiga menos de 100 tareas. Las fechas son Unix time en milisegundos.
- Obtener tareaGETDevuelve una tarea con estado, responsables, fechas, etiquetas, valores de campos personalizados, checklists y adjuntos.
- Crear tareaPOSTCrea una tarea en una List. Requiere name. ClickUp notifica a los responsables y observadores, y también al creador cuando notify_all es true. Las fechas son Unix time en milisegundos.
OAuth con la app de tu producto
Registras la app OAuth de tu producto una sola vez, con POST /api/merchants/credentials/clickup, y tu cliente autoriza la cuenta en una pantalla de consentimiento. Connect renueva el token cuando está por vencer.
Preguntas sobre el toolkit de ClickUp
¿Necesito implementar la API de ClickUp?
No. Connect ya trae 14 tools de ClickUp descritas y listas. Tu cliente conecta la cuenta y tu sistema llama a cada tool por el mismo endpoint, con el mismo formato de solicitud.
¿Cómo conecta mi cliente su cuenta de ClickUp?
Con el modo que acepta el toolkit: OAuth con la app de tu producto. Connect guarda la credencial cifrada y nunca la devuelve a tu sistema.
¿Funciona con agentes de IA?
Sí. El input de cada tool está descrito en JSON Schema, que tu agente usa directamente como definición de tool. El agente elige la tool y los argumentos, y tu sistema hace la llamada a Connect.
¿Mi cliente necesita una cuenta en Reportei?
No. Tu cliente conecta la cuenta en una pantalla de Connect, o tu sistema envía la credencial por la API, y sigue usando solo tu producto.
Toolkits de la misma categoría
Ver los 100 toolkitsMira Connect aplicado a tu producto.
Pruébalo durante 15 días sin tarjeta, o cuéntale tu caso a nuestro equipo.
