Gestión de proyectos
Clockify en tu producto y en tus agentes de IA, con una API
El toolkit de Clockify cubre el usuario conectado, workspaces, usuarios, clientes, proyectos, tareas y registros de tiempo, incluidos los temporizadores en curso. Tu cliente conecta una vez con una API key, y tu producto o agente de IA llama cada operación a través de Connect, que guarda la credencial y registra cada ejecución.
15 días de prueba. Sin tarjeta de crédito.
POST https://connect.reportei.com/api/tools/clockify_create_client/execute
Authorization: Bearer <merchant token>
x-customer-token: <customer token>
Content-Type: application/json
Accept: application/json
{
"customer_toolkit": "<connection UUID>",
"arguments": {
"workspaceId": "<workspaceId>",
"name": "<name>"
}
}Cómo funciona
Del cliente conectado a la primera llamada a Clockify.
- 1
Tu cliente conecta la cuenta
Tu sistema abre una sesión de Connect para el toolkit y tu cliente conecta su cuenta de Clockify. 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 Clockify.
Registrar tiempo desde tu producto
Añade a tu SaaS un botón de iniciar y detener temporizador que crea y cierra registros en el Clockify del cliente, ligados a un proyecto y una tarea.
Preparar proyectos de nuevos clientes
Cuando una herramienta de agencia da de alta a un cliente, crea el cliente y su proyecto en Clockify para que el equipo pueda registrar horas de inmediato.
Respuestas de timesheet con un agente
Deja que un agente de IA liste los registros de tiempo de un usuario con proyecto y tarea y responda en qué se fueron las horas.
Tools
13 tools de Clockify
- Obtener usuario actualGETDevuelve el usuario conectado con su id, que aceptan los argumentos userId, los ids de los workspaces activo y por defecto, el email y ajustes como la zona horaria.
- Listar workspacesGETLista los workspaces del usuario conectado, con ids, nombres, monedas y tarifas.
- Listar usuariosGETLista los usuarios de un workspace con ids, nombres y emails, 50 por página. Una página con menos de 50 usuarios es la última.
- Listar clientesGETLista los clientes de un workspace, 50 por página. Una página con menos de 50 clientes es la última.
- Crear clientePOSTCrea un cliente en un workspace. Requiere name.
- Listar proyectosGETLista los proyectos de un workspace, archivados o no, 50 por página. Una página con menos de 50 proyectos es la última.
- Crear proyectoPOSTCrea un proyecto en un workspace, opcionalmente para un cliente. Requiere name.
- Listar tareasGETLista las tareas de un proyecto, 50 por página. Una página con menos de 50 tareas es la última.
- Listar registros de tiempoGETLista los registros de tiempo de un usuario en un workspace, 50 por página. Una página con menos de 50 registros es la última. Con hydrated true, cada registro trae proyecto, tarea y etiquetas en lugar de solo sus ids.
- Crear registro de tiempoPOSTCrea un registro de tiempo para el usuario conectado. Requiere start. Sin end, inicia un temporizador en curso, que Stop timer termina. Si el workspace tiene campos personalizados obligatorios para registros, Clockify rechaza el registro.
Clave de API
Tu cliente pega la clave de la app en una pantalla de Connect, o tu sistema envía la clave con POST /api/customer-toolkits, sin pantalla.
Al conectar, tu cliente también indica {region}: la dirección de su cuenta en la API de la app.
Preguntas sobre el toolkit de Clockify
¿Necesito implementar la API de Clockify?
No. Connect ya trae 13 tools de Clockify 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 Clockify?
Con el modo que acepta el toolkit: Clave de API. 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.
