Integración con Zapier

Integración con Zapier

Conecta Working Timer con miles de aplicaciones mediante Zapier. Por ejemplo, puedes crear un registro de trabajo desde un evento de calendario, formulario, fila de hoja de cálculo o tarea completada.

La integración utiliza la API pública de Working Timer. No necesitas compartir tu contraseña de Working Timer con Zapier.

Requisitos

  • Una cuenta de Working Timer con un plan o prueba activa de la API pública
  • Un plan de pago de Zapier con API by Zapier o Webhooks by Zapier
  • El ID del perfil de Working Timer que recibirá los registros

Importante: Trata la clave API como una contraseña. No la incluyas en nombres, notas, URL ni campos del Zap que puedan aparecer en el historial de tareas.

1. Crear una clave API

  1. Abre el portal de la API de Working Timer, selecciona Sign In e inicia sesión.
  2. En API Dashboard, busca API Keys y selecciona New Key.
  3. Escribe un nombre como Zapier y selecciona Create.
  4. Copia inmediatamente la clave que empieza por wt_ak_. Solo se muestra una vez.

Si pierdes la clave, revócala y crea otra.

2. Obtener el ID del perfil

  1. Abre la referencia de la API.
  2. Selecciona Authorize e introduce la clave en ApiKey.
  3. Abre GET /api/v1/Profile, selecciona Try it out y después Execute.
  4. Busca el perfil en la respuesta y copia su id.

El ID es un GUID parecido a a1b2c3d4-1234-5678-9abc-1234567890ab.

3. Conectar mediante API by Zapier

  1. En Zapier, abre Apps, selecciona Add connection y elige API by Zapier.
  2. En Authentication type, elige Static Headers (API key).
  3. En Headers, añade una línea:
X-Api-Key: wt_ak_tu_clave_api
  1. Define Connection name como Working Timer.
  2. Define Domain filter como api.workingtimer.com.
  3. Usa como Test URL https://api.workingtimer.com/api/v1/Profile?pageSize=1.
  4. Selecciona Yes, Continue to API by Zapier.

API by Zapier está en fase beta. Si no está disponible, utiliza el método Webhooks descrito más abajo.

4. Crear el primer Zap

  1. Crea un Zap y elige un disparador, como un nuevo evento, tarea, formulario o fila.
  2. Añade API by Zapier, selecciona API Request y la conexión Working Timer.
  3. Define Method como POST y URL como https://api.workingtimer.com/api/v1/WorkRecord.
  4. Introduce en Body:
{
  "profileId": "ID_DEL_PERFIL",
  "year": 2026,
  "month": 7,
  "day": 31,
  "clockIn": 540,
  "clockOut": 1020,
  "breakMinutes": 30,
  "recordType": "common",
  "isPaid": true,
  "note": "Creado por Zapier"
}
  1. Sustituye ID_DEL_PERFIL, asigna los valores del disparador y utiliza antes Formatter by Zapier si necesitas convertirlos.
  2. Selecciona Test step. Una solicitud correcta devuelve 201. Comprueba el registro en Working Timer y publica el Zap.

clockIn y clockOut son minutos desde medianoche: 08:00 = 480, 09:00 = 540, 17:00 = 1020. En turnos nocturnos, clockOut puede superar 1440.

Alternativa: Webhooks by Zapier

Añade Webhooks by Zapier con el evento POST. Usa la URL https://api.workingtimer.com/api/v1/WorkRecord, Payload Type JSON, los datos anteriores y las cabeceras X-Api-Key con tu clave y Content-Type con application/json. Una prueba correcta devuelve 201.

Otras solicitudes útiles

  • Perfiles: GET https://api.workingtimer.com/api/v1/Profile
  • Registros: GET https://api.workingtimer.com/api/v1/WorkRecord
  • Actualizar: PATCH https://api.workingtimer.com/api/v1/WorkRecord/{id}
  • Eliminar: DELETE https://api.workingtimer.com/api/v1/WorkRecord/{id}

Consulta la referencia de la API para ver más endpoints.

Solución de problemas

  • 401 Unauthorized — falta la clave, está incompleta o revocada. La cabecera debe llamarse exactamente X-Api-Key.
  • 403 Forbidden — activa o renueva el plan o la prueba de la API pública.
  • 400 Bad Request — revisa el JSON, la fecha y los valores numéricos de minutos.
  • Profile was not found — comprueba que profileId pertenece a la misma cuenta.
  • 429 Too Many Requests — se alcanzó un límite; inténtalo más tarde y revisa el uso.
  • Registros duplicados — revisa el historial de Zapier y utiliza un filtro o ID de origen único antes de la acción.

Para retirar el acceso, selecciona Revoke junto a la clave de Zapier en API Dashboard.