Recursos · Integración n8n

Integración Toggl n8nAutomatiza Toggl con n8n.

¿Qué pasaría si cada cronómetro detenido en Toggl pusiera en marcha el resto del trabajo? La integración Toggl n8n vive en un solo nodo, el Toggl Trigger: 1 evento, newTimeEntry, consultado en el intervalo que elijas. No hay nodo de acción, así que escribir en Toggl pasa por HTTP Request.

Reseñas verificadas en Trustpilot · Agencia de IA, automatización y growth

Por qué automatizar

¿Qué aporta de verdad la integración Toggl n8n?

La integración Toggl n8n funciona en un solo sentido: n8n vigila tu cuenta de Toggl y arranca un flujo de trabajo, es decir una serie de pasos automáticos, en cuanto aparece una entrada de tiempo nueva. Toggl sigue siendo donde se registran las horas. n8n es donde esas horas se convierten en una fila, un aviso o una línea de factura. La conexión usa un credential Basic auth que se crea una vez y se reutiliza siempre.

Primer caso, una consultora que factura por horas. Cada cronómetro detenido alimenta una hoja de control en Microsoft Excel 365, en la pestaña del cliente que corresponde. Nadie vuelve a copiar horas a final de mes y esa hoja ya sirve de base para facturar.

Segundo caso, visibilidad para un equipo pequeño. Llega la entrada, n8n la formatea y la publica en el canal del proyecto con Slack. El responsable ve en qué se está trabajando sin abrir ninguna herramienta de reporting, y el hilo queda como registro ligero de actividad.

Tercer caso, el archivo del cliente. Un flujo acumula las entradas de la semana, genera un documento con el detalle de lo registrado y lo guarda en la carpeta compartida de Google Drive. Siempre el mismo formato, siempre el mismo día, sin que nadie lo prepare a mano.

Lo que esta integración no hace: escribir en Toggl. El catálogo muestra 0 operaciones y 0 recursos para esta herramienta, o sea que ningún nodo escribe en Toggl. Para eso está el nodo HTTP Request, que llama a cualquier endpoint de la API de Toggl reutilizando el mismo credential mediante la autenticación predefinida. Cuesta más de configurar que una lista desplegable, y aquí es el único camino.

El otro límite es el retraso. El trigger, el nodo que dispara el flujo, consulta la API cada cierto tiempo: la entrada se recoge en el siguiente sondeo, no en el segundo exacto en que se para el cronómetro. Para una hoja de control o un resumen semanal da igual. Para una reacción inmediata, no es la herramienta. Si los credenciales y las ejecuciones todavía te suenan a chino, el Curso n8n los explica antes de montar nada en producción.

Conexión

¿Cómo conectas Toggl con n8n?

  1. 01

    Crea el credential de Toggl

    Primero hace falta una cuenta de Toggl. En n8n, abre el menú Credentials y crea un credential de Toggl, es decir el acceso guardado que n8n usa para hablar con la herramienta en tu nombre. Se crea una sola vez: los flujos que añadas después lo eligen de una lista desplegable. La ventaja práctica llega el día que cambia la contraseña, porque la corrección se hace en un único sitio y no flujo por flujo.

  2. 02

    Rellena los dos campos de Basic auth

    Toggl admite aquí un solo método de autenticación, Basic auth, así que el formulario cabe en dos líneas. Username espera la dirección de correo de tu cuenta de usuario, la misma con la que entras. Password espera la contraseña de esa cuenta. No hay clave que generar ni permisos que marcar. A cambio, la conexión queda atada a una cuenta real, y para un equipo suele convenir una cuenta de operaciones compartida.

  3. 03

    Coloca el trigger y elige el evento

    Añade el Toggl Trigger al lienzo, selecciona el credential y elige el Event que escucha el nodo. La versión 1 ofrece newTimeEntry y ningún otro parámetro pide valor. Ajusta el intervalo de sondeo, activa el flujo y registra una entrada corta en Toggl: la primera ejecución te enseña los datos que llegan de verdad antes de que construyas el resto de la rama.

Disparadores

¿Qué dispara un flujo de Toggl en n8n?

Toggl Trigger es el nodo que arranca un workflow cuando algo ocurre en Toggl. Escucha 1 eventos, listados abajo por familia. Eliges uno o varios, activas el workflow y n8n registra el webhook (la URL que Toggl llama) en tu cuenta.

Lo que ves en n8n

Todos los eventos, por familia

Una fila por objeto, un chip por acción. El evento que marcas en el nodo se escribe objeto.acción; pasa el cursor por un chip para leer cuándo se dispara.

new.*1

    Notas de configuración

    01Set Up the Toggl TriggerEl nodo Toggl Trigger arranca un flujo cuando Toggl reporta un evento. Su configuración se resume en tres decisiones: el credential, el evento que escucha y cada cuánto se consulta la API.

    El nodo Toggl Trigger arranca un flujo cuando Toggl reporta un evento. Su configuración se resume en tres decisiones: el credential, el evento que escucha y cada cuánto se consulta la API.

    Parámetros clave

    • Event: el evento de Toggl que vigila el nodo. La versión 1 expone un único valor, newTimeEntry, agrupado en 1 familia. No hay nada que comparar en la lista ni una opción comodín que recoja todos los tipos de evento a la vez.
    • Poll Times: cada cuánto pregunta n8n a la API de Toggl si hay algo nuevo. Eso es el polling, o sondeo: preguntar cada cierto tiempo en lugar de recibir un aviso. Una vez por minuto como mucho; un intervalo más amplio sobra cuando el destino es una hoja que se mira por la mañana.
    Cuándo usarlo
    cuando el punto de partida es una persona que para un cronómetro, no una hora del día. Si lo que quieres es un resumen a hora fija, quien abre el flujo es el Schedule Trigger.
    02New Time EntryCada ejecución transporta una sola entrada de tiempo recién creada. El flujo maneja siempre un bloque de trabajo, nunca un lote que haya que recorrer en bucle, y eso simplifica bastante la rama que viene detrás.

    Cada ejecución transporta una sola entrada de tiempo recién creada. El flujo maneja siempre un bloque de trabajo, nunca un lote que haya que recorrer en bucle, y eso simplifica bastante la rama que viene detrás.

    Parámetros clave

    • Event: fijado en newTimeEntry, el único valor de la familia new en este nodo. No existe otro evento con el que combinarlo, así que varias necesidades de Toggl se resuelven con varios flujos separados y no con un nodo de casillas múltiples.
    Casos de uso
    un despacho registra horas por expediente y quiere cada entrada añadida a su hoja de control en cuanto existe. Un estudio vigila el consumo de un paquete de horas y avisa al pasar de un umbral. En ambos, lo que sigue lee el item entrante con una expresión del tipo {{ $json.description }}, que apunta a un campo del elemento emitido por el trigger.
    Necesitas ayuda

    ¿Necesitas ayuda para automatizar Toggl con n8n?

    El equipo te responde directamente.

    Cada mensaje lo lee una persona.

    FAQ

    Toggl y n8n, las preguntas que vienen después

    01¿La integración Toggl n8n es gratis?
    Sí por el lado de n8n. El Toggl Trigger viene incluido: nada que instalar, nada que comprar, ningún paso por una tienda de extensiones. Se comporta igual en n8n Cloud, la oferta alojada por n8n, y en una instancia autoalojada montada con Docker o npm bajo la Community Edition y su licencia Sustainable Use. Un flujo creado en un sitio funciona idéntico en el otro, así que puedes empezar en la nube y llevártelo a tu servidor más adelante. Lo que cueste un plan de Toggl es otra conversación y esta página no la aborda, porque el catálogo de nodos no incluye ese dato.
    02¿Qué credenciales necesita el Toggl Trigger?
    Basic auth, y es el único método admitido. Creas un credential de Toggl en el menú Credentials con dos campos: Username, donde va la dirección de correo de tu cuenta de usuario, y Password, donde va la contraseña de esa cuenta. Ni clave de API que generar, ni pantalla de OAuth, ni lista de permisos que aprobar. Como equivale a un acceso completo a la cuenta y no a un token limitado, muchos equipos lo asocian a una cuenta de operaciones compartida en vez de a la de una persona. Guardado una vez, se elige desde una lista en todos los flujos siguientes.
    03¿Qué límites tiene el nodo de Toggl en n8n?
    El primero es el alcance. El catálogo muestra 0 operaciones y 0 recursos para Toggl, así que no existe ningún nodo de acción: n8n sabe reaccionar a Toggl, nunca escribir en él con un nodo dedicado. Crear, corregir o descargar cualquier cosa en Toggl pasa por el nodo HTTP Request, que llama a cualquier endpoint de la API de Toggl reutilizando el mismo credential mediante la autenticación predefinida. En el trigger hay 1 evento, newTimeEntry, sin opción comodín para escuchar todos los tipos. La versión 1 del nodo no expone ningún parámetro aparte del evento.
    04¿El Toggl Trigger reacciona en tiempo real?
    No, y conviene decirlo claro. El nodo funciona por sondeo: n8n pregunta a la API de Toggl en el intervalo fijado en Poll Times si hay entradas nuevas y luego emite un item por cada elemento encontrado. No se registra nada del lado de Toggl, así que no hay webhook que configurar ni URL que exponer, lo que simplifica mucho el montaje. A cambio hay un retraso igual al intervalo elegido, y lo más corto es una vez por minuto. Para una hoja de control, un aviso de proyecto o un resumen semanal ese retraso no se nota. Para reaccionar al segundo, este mecanismo no sirve.
    05¿n8n o Make para Toggl?
    Depende de lo que pese más en tu caso. Make es una plataforma alojada, sin opción de autoalojarse, que factura por operación: un trigger que consulta a menudo gasta cuota aunque no llegue nada. n8n se puede instalar en tu propio servidor, con lo que las horas registradas y las credenciales de la cuenta se quedan en una infraestructura que controlas, y también existe como oferta alojada si nadie quiere administrar una instancia. En esta herramienta concreta las dos parten de la misma base escasa: 1 evento y ninguna operación de escritura. La decisión se juega en alojamiento, control de los datos y modelo de coste, no en el nodo de Toggl.