Recursos · Integración n8n

Integración awork n8nAutomatiza awork con n8n.

Lo que tu equipo guarda en awork se puede manejar desde un flujo de trabajo. El nodo reúne 37 operaciones sobre 5 recursos. El awork Trigger escucha 35 eventos y los entrega en segundos. La integración awork n8n encaja en equipos que viven al ritmo de los proyectos de cliente.

Nodo comunitario Este nodo no viene con n8n: es un paquete comunitario (n8n-nodes-awork) que instalas desde Settings › Community nodes en una instancia autoalojada. npm

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

Por qué automatizar

¿Para qué sirve una integración awork n8n?

El nodo de awork le da a un flujo de trabajo acceso a los objetos con los que el equipo trabaja cada día: empresas, proyectos, tareas de proyecto, documentos y usuarios. Junto al awork Trigger y sus 35 eventos, n8n pasa a ser la capa que reacciona a lo que ocurre en awork y que devuelve datos sin que nadie los reescriba.

Las horas dejan de contarse a final de mes. El evento timetracking_added despierta el flujo cada vez que alguien registra tiempo, project.get recupera el proyecto asociado y la línea cae en una hoja con Microsoft Excel 365. El acumulado por cliente está siempre al día.

Un presupuesto firmado abre el proyecto entero. company.create registra la cuenta y devuelve su identificador, project.post lo coloca en Company ID junto a un Project Template ID, y project.posttasklist añade la primera lista de tareas. Nadie monta el esqueleto a mano.

Los plazos aparecen donde la gente los mira. project.getall devuelve la cartera con sus fechas, y cada Due Date se convierte en un evento con Google Calendar, mientras el aviso de la semana se publica en un canal con Slack.

Cuando el nodo no cubre el endpoint que necesitas, el nodo HTTP Request llama directamente a la API de awork y reutiliza la misma credencial mediante la autenticación predefinida. Esa es la salida para todo lo que queda fuera de las 37 operaciones de más abajo.

Dos límites conviene tenerlos claros antes de empezar. El nodo está en la versión 1 y el paquete comunitario solo se instala en una instancia autoalojada, porque n8n Cloud únicamente acepta nodos comunitarios verificados. El trigger tampoco tiene una opción para escucharlo todo de golpe: cada evento útil se marca a mano. Los listados se comportan igual: con Return All desactivado el nodo para en Limit y el informe sale corto sin avisar. Si el tema de las credenciales te queda lejos, el Curso n8n lo recorre desde el principio, y la Reseña n8n entra en el detalle del alojamiento.

Conexión

¿Cómo se conecta awork con n8n?

  1. 01

    Instalar el paquete comunitario

    Abre Settings, entra en Community nodes e instala n8n-nodes-awork (versión 0.1.62). El nodo de awork y el awork Trigger aparecen en el panel de nodos cuando la instancia reinicia. Este paso solo funciona en un n8n autoalojado, levantado con Docker o npm, porque n8n Cloud únicamente acepta nodos comunitarios verificados. El paquete no tiene coste por parte de n8n.

  2. 02

    Crear la credencial de awork

    Ve al menú Credentials y crea la credencial de awork una sola vez. Una credencial es el juego de claves que n8n guarda para llamar a la API en tu nombre, y se reutiliza en todos los flujos de la instancia, así que ninguna clave acaba pegada dentro de un nodo. Ponle un nombre que indique a qué espacio de trabajo de awork apunta, porque un equipo con un entorno de pruebas y otro de producción terminará con las dos.

  3. 03

    Elegir la credencial en el nodo

    Coloca un nodo de awork en el lienzo y selecciona la credencial en su lista desplegable. Elige un recurso, después una operación, y ejecuta el nodo una vez sobre una lectura como project.getall. Una lectura no modifica nada y demuestra que la conexión funciona antes de que una escritura toque datos reales. La misma credencial se enchufa en el awork Trigger cuando el flujo debe arrancar con un evento y no con un horario.

Disparadores

¿Qué pone en marcha un flujo de awork ?

awork Trigger es el nodo que arranca un workflow cuando algo ocurre en awork. Escucha 35 eventos, listados abajo por familia. Eliges uno o varios, activas el workflow y n8n registra el webhook (la URL que awork 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.

absence_added.*1
  • absence_added.
    • absence_added
absence_deleted.*1
  • absence_deleted.
    • absence_deleted
absence_updated.*1
  • absence_updated.
    • absence_updated
company_added.*1
  • company_added.
    • company_added
company_deleted.*1
  • company_deleted.
    • company_deleted
company_type_changed.*1
  • company_type_changed.
    • company_type_changed
company_updated.*1
  • company_updated.
    • company_updated
project_added.*1
  • project_added.
    • project_added
project_comment_added.*1
  • project_comment_added.
    • project_comment_added
project_deleted.*1
  • project_deleted.
    • project_deleted
project_status_changed.*1
  • project_status_changed.
    • project_status_changed
project_type_changed.*1
  • project_type_changed.
    • project_type_changed
project_updated.*1
  • project_updated.
    • project_updated
projectmember_added.*1
  • projectmember_added.
    • projectmember_added
projectmember_deleted.*1
  • projectmember_deleted.
    • projectmember_deleted
task_added.*1
  • task_added.
    • task_added
task_comment_added.*1
  • task_comment_added.
    • task_comment_added
task_deleted.*1
  • task_deleted.
    • task_deleted
task_status_changed.*1
  • task_status_changed.
    • task_status_changed
task_type_changed.*1
  • task_type_changed.
    • task_type_changed
task_updated.*1
  • task_updated.
    • task_updated
taskassignment_added.*1
  • taskassignment_added.
    • taskassignment_added
taskassignment_deleted.*1
  • taskassignment_deleted.
    • taskassignment_deleted
tasklist_added.*1
  • tasklist_added.
    • tasklist_added
tasklist_deleted.*1
  • tasklist_deleted.
    • tasklist_deleted
tasklist_updated.*1
  • tasklist_updated.
    • tasklist_updated
timetracking_added.*1
  • timetracking_added.
    • timetracking_added
timetracking_deleted.*1
  • timetracking_deleted.
    • timetracking_deleted
timetracking_type_changed.*1
  • timetracking_type_changed.
    • timetracking_type_changed
timetracking_updated.*1
  • timetracking_updated.
    • timetracking_updated
user_activation_changed.*1
  • user_activation_changed.
    • user_activation_changed
user_added.*1
  • user_added.
    • user_added
user_deleted.*1
  • user_deleted.
    • user_deleted
user_status_changed.*1
  • user_status_changed.
    • user_status_changed
user_updated.*1
  • user_updated.
    • user_updated

Notas de configuración

01Set up the awork TriggerEl awork Trigger arranca un flujo cuando pasa algo en awork. Funciona por webhook, es decir, una URL a la que awork llama, en vez de que n8n pregunte una y otra vez. Cada evento llega en segundos. Usa la misma credencial que el nodo de awork, así que no hay nada más que configurar una vez instalado el paquete comunitario.

El awork Trigger arranca un flujo cuando pasa algo en awork. Funciona por webhook, es decir, una URL a la que awork llama, en vez de que n8n pregunte una y otra vez. Cada evento llega en segundos. Usa la misma credencial que el nodo de awork, así que no hay nada más que configurar una vez instalado el paquete comunitario.

Parámetros clave

  • Events: la lista de eventos que escucha, 35 en la versión 1 del trigger. No hay opción para cogerlos todos de golpe, así que marca uno a uno los que te interesan. Las empresas y los usuarios también tienen los suyos, desde company_added y company_type_changed hasta user_added y user_activation_changed.
Cuándo usarlo
siempre que el flujo deba reaccionar al trabajo real en lugar de correr a una hora fija. El webhook se registra en awork al activar el flujo, de modo que un trigger en borrador no recibe absolutamente nada.
02Time tracking eventsCuatro eventos siguen el tiempo registrado: timetracking_added, timetracking_updated, timetracking_type_changed y timetracking_deleted. Las ausencias tienen su propio trío con absence_added, absence_updated y absence_deleted. Los usuarios van al lado, con user_added, user_updated, user_status_changed, user_activation_changed y user_deleted.

Cuatro eventos siguen el tiempo registrado: timetracking_added, timetracking_updated, timetracking_type_changed y timetracking_deleted. Las ausencias tienen su propio trío con absence_added, absence_updated y absence_deleted. Los usuarios van al lado, con user_added, user_updated, user_status_changed, user_activation_changed y user_deleted.

Casos de uso
en una agencia que factura por horas, timetracking_added alimenta un acumulado por proyecto a medida que se registra el trabajo, sin carreras a fin de mes. timetracking_updated y timetracking_deleted pesan igual, porque un acumulado construido solo con altas se separa de la realidad en cuanto llega la primera corrección. absence_added avisa a quien lleva el proyecto de que alguien comprometido con una entrega no estará. Y user_activation_changed marca la salida de una cuenta, buen momento para cortar accesos en otras herramientas sin esperar a que alguien lo recuerde.
03Task eventsLa vida de una tarea cabe en seis eventos: task_added, task_updated, task_status_changed, task_type_changed, task_deleted y task_comment_added. La asignación va aparte, con taskassignment_added y taskassignment_deleted. Las listas de tareas repiten el patrón: tasklist_added, tasklist_updated y tasklist_deleted.

La vida de una tarea cabe en seis eventos: task_added, task_updated, task_status_changed, task_type_changed, task_deleted y task_comment_added. La asignación va aparte, con taskassignment_added y taskassignment_deleted. Las listas de tareas repiten el patrón: tasklist_added, tasklist_updated y tasklist_deleted.

Casos de uso
una tarea que pasa a terminada dispara task_status_changed, y el flujo puede leer el proyecto para avisar a quien la pidió. taskassignment_added sirve para que cada persona reciba en su bandeja lo que acaba de caerle encima, en vez de enterarse en la reunión diaria. Un comentario dispara task_comment_added, la puerta de entrada para llevar el feedback del cliente a una cola de revisión. Conviene ser selectivo: un flujo suscrito a todos los eventos de tarea se ejecuta también con cambios que no le importan.
04Project eventsDel lado del proyecto hay seis eventos: project_added, project_updated, project_status_changed, project_type_changed, project_deleted y project_comment_added. Los miembros tienen su pareja, projectmember_added y projectmember_deleted. Las empresas repiten la familia con company_added, company_updated, company_type_changed y company_deleted.

Del lado del proyecto hay seis eventos: project_added, project_updated, project_status_changed, project_type_changed, project_deleted y project_comment_added. Los miembros tienen su pareja, projectmember_added y projectmember_deleted. Las empresas repiten la familia con company_added, company_updated, company_type_changed y company_deleted.

Casos de uso
project_added es el punto de partida más limpio para un flujo de alta, porque el proyecto ya existe cuando n8n lo recibe y el nodo siguiente puede montarle sus listas de tareas y sus estados. project_status_changed encaja en el reporte a dirección: un proyecto que se tuerce se ve el mismo día y no en el comité del jueves. projectmember_added vale para la gestión de accesos, dándole a quien entra lo que necesita desde el primer día. Y project_comment_added recoge lo que se escribe a nivel de proyecto y no sobre una tarea.
Acciones

¿Qué sabe hacer el nodo de awork ?

El nodo awork expone 37 operaciones en 5 recursos. Para cada una: el nodo tal como lo configuras en n8n, los campos obligatorios y nuestras notas de campo.

Matriz recursos × operaciones
RecursoCreate CompanyGet Company by IDDelete DocumentAdd TagChange Project StatusChange StatusAdd CommentGet All CompaniesGet CommentsGet Document ContentGet Documents of Document SpaceGet Documents of ProjectGet All Project StatusesGet Project Statuses of ProjectGet Task Lists of ProjectGet Task Lists of ProjectGet Tasks of ProjectGet Task Statuses of ProjectGet Types of WorkCreate ProjectAdd Task to Task ListCreate Project StatusCreate Task ListCreate Task StatusCreate Type of WorkSet Task AssigneeSet Custom Field
Company
Document
Project
Project Task
User

Company

3 operaciones
01

Create a company

company.create

Lo que ves en n8n

Notas y casos de uso

Da de alta una empresa en awork y devuelve su identificador, que después reutilizan las operaciones de proyecto.

Parámetros clave

  • Company Name: el nombre de la empresa, normalmente {{ $json.companyName }} que viene del formulario o del CRM anterior. Si queda vacío, el nodo se detiene.
  • Company Description: texto libre, buen sitio para el contexto que anotó el comercial.
  • Company Industry: el sector de la empresa, útil cuando el reporte separa a los clientes por sector.
Casos de uso
se cierra una venta y la cuenta ya existe en awork antes de que nadie abra la aplicación.
02

Get companies

company.getall

Lo que ves en n8n

Notas y casos de uso

Devuelve las empresas del espacio de trabajo, un ítem por empresa, listas para un bucle o una búsqueda.

Parámetros clave

  • Return All: activado, n8n encadena todas las páginas de la API y trae la lista completa de clientes; desactivado, Limit pone el tope de empresas.
  • Filter By: acota el resultado con criterios, en la sintaxis de filtrado que documenta awork.
  • Order By: ordena por un campo y una dirección, cómodo para sacar la lista ya clasificada.
Casos de uso
rehacer un directorio de clientes fuera de awork, o enlazar un dominio de correo entrante con una cuenta existente.
03

Get company by id

company.get

Lo que ves en n8n

Notas y casos de uso

Recupera una empresa a partir de su identificador y la devuelve en un solo ítem.

Parámetros clave

  • Company ID: el identificador de la empresa, no su nombre. Suele llegar de un nodo anterior como {{ $json.id }}, o del Company ID que lleva un proyecto.
Casos de uso
un proyecto entra en el flujo sin los datos del cliente y esta operación los completa antes de enviar el mensaje. También enriquece una petición de soporte con la cuenta a la que pertenece.

Document

7 operaciones
04

Get all documents

document.getall

Lo que ves en n8n

Notas y casos de uso

Lista los documentos del espacio de trabajo sin pedir nada a cambio, un ítem por documento.

Casos de uso
un inventario trimestral de lo que ha escrito el equipo, volcado en una hoja para detectar las páginas que nadie ha vuelto a abrir desde el último encargo. Esa misma lista es el primer paso de una migración, donde alimenta un bucle que lee cada documento antes de escribirlo en otro sitio.
05

Get document by id

document.get

Lo que ves en n8n

Notas y casos de uso

Trae un documento concreto desde su identificador, con sus propiedades y no con su texto.

Parámetros clave

  • Document ID: el identificador del documento, casi siempre {{ $json.id }} heredado de una operación de listado.
Casos de uso
comprobar el nombre y la ubicación de un documento antes de decidir si el flujo lo copia, lo archiva o lo deja quieto. Buena parada de control delante de una operación que escribe.
06

Get document content

document.getcontent

Lo que ves en n8n

Notas y casos de uso

Extrae el contenido HTML de un documento, que es lo que hace falta cuando lo que viaja es el texto.

Parámetros clave

  • Document ID: el identificador del documento cuyo cuerpo quieres. Encadénalo detrás de un listado para no escribir nunca un identificador fijo.
Casos de uso
un briefing escrito en awork se republica en una base de conocimiento, o pasa a un modelo de lenguaje que redacta el resumen para el cliente. El cuerpo llega en HTML, así que conviértelo si el destino espera texto plano.
07

Get documents of a document space

document.getdocumentsofdocumentspace

Lo que ves en n8n

Notas y casos de uso

Reduce el listado de documentos a un único espacio documental en vez de todo el espacio de trabajo.

Parámetros clave

  • Document Space ID: el identificador del espacio documental que se lee. Un espacio por departamento o por cliente mantiene el volumen bajo control.
Casos de uso
una sincronización nocturna que copia solo el espacio de procedimientos internas y no toca el material de cliente. También es el camino corto para encontrar un documento cuando ya sabes en qué espacio vive.
08

Get documents of a project

document.getdocumentsofproject

Lo que ves en n8n

Notas y casos de uso

Enumera los documentos que cuelgan de un proyecto concreto, un ítem por documento.

Parámetros clave

  • Project ID: el identificador del proyecto, muchas veces {{ $json.projectId }} heredado de un evento del trigger sobre ese proyecto.
Casos de uso
cerrar un encargo enviando todos los entregables de una vez, o comprobar que un proyecto abierto la semana pasada ya tiene su briefing adjunto antes de la reunión de arranque.
09

Create a document

document.create

Lo que ves en n8n

Notas y casos de uso

Escribe un documento nuevo en awork, sea en un espacio documental o dentro de un proyecto.

Parámetros clave

  • Document Name: el nombre del documento, obligatorio.
  • Document Space ID o Project ID: hay que dar uno de los dos, y esa elección decide dónde aterriza la página.
  • Document Content: el cuerpo del documento, en HTML.
  • Emoji: el icono que acompaña al documento.
  • Parent Document ID: otro documento del mismo proyecto o espacio, para anidar este debajo.
Casos de uso
generar el acta justo al terminar la reunión.
10

Delete a document

document.delete

Lo que ves en n8n

Notas y casos de uso

Borra un documento de awork, así que deja esta operación detrás de una condición y no encima de una lista cruda.

Parámetros clave

  • Document ID: el identificador del documento que se elimina. Léelo antes con una operación de lectura si el flujo debe dejar rastro de lo que desaparece.
Casos de uso
limpiar los borradores que creó un generador durante una prueba, o vaciar documentos temporales cuando su contenido ya está copiado en su sitio definitivo.

Project

12 operaciones
11

Get projects

project.getall

Lo que ves en n8n

Notas y casos de uso

Trae los proyectos del espacio de trabajo, un ítem por proyecto, la columna vertebral de casi todos los flujos de reporte.

Parámetros clave

  • Return All: activado, suben todas las páginas de proyectos; desactivado, Limit fija cuántos.
  • Filter By: deja solo los proyectos que cumplen los criterios, en la sintaxis de filtrado de awork.
  • Order By: ordena por un campo y una dirección, útil para sacar primero los proyectos más antiguos.
Casos de uso
el resumen del lunes con los encargos en marcha.
12

Get project by id

project.get

Lo que ves en n8n

Notas y casos de uso

Lee un proyecto desde su identificador y lo devuelve como un ítem único.

Parámetros clave

  • Project ID: el identificador del proyecto, que rara vez se escribe a mano. Un evento del trigger sobre una tarea lleva el proyecto al que pertenece, y ese valor entra aquí directamente.
Casos de uso
una tarea cambia de estado y el aviso necesita el nombre del proyecto, no un identificador ilegible, así que la operación se coloca entre el trigger y el nodo de mensaje.
13

Get all project statuses

project.getprojectstatuses

Lo que ves en n8n

Notas y casos de uso

Enumera los estados de proyecto definidos en el espacio de trabajo, que es como se averiguan los identificadores que piden las operaciones de escritura.

Parámetros clave

  • Return All: activado para el conjunto completo de estados; desactivado, Limit recorta la lista.
  • Filter By: acota los estados devueltos con criterios.
  • Order By: los ordena por un campo y una dirección.
Casos de uso
ejecutarla una vez en la puesta en marcha para emparejar nombres con identificadores y guardar esa tabla para los flujos posteriores.
14

Get project statuses of project by id

project.getprojectstatusesofproject

Lo que ves en n8n

Notas y casos de uso

Ciñe el listado de estados a un solo proyecto en lugar de a todo el espacio de trabajo.

Parámetros clave

  • Project ID: el proyecto cuyos estados quieres.
  • Return All: activado para encadenar páginas, desactivado para parar en Limit.
  • Filter By: filtra los estados devueltos con criterios.
  • Order By: los ordena por un campo y una dirección.
Casos de uso
localizar el identificador de estado correcto antes de llamar a una operación de cambio sobre ese mismo proyecto, para que el flujo no adivine nada.
15

Create a project

project.post

Lo que ves en n8n

Notas y casos de uso

Crea un proyecto enviando sus datos y devuelve el objeto del que colgará el resto del flujo.

Parámetros clave

  • Project Name: obligatorio, el único campo que la operación exige.
  • Company ID: ata el proyecto a una cuenta de cliente.
  • Start Date y Due Date: las fechas que enmarcan el encargo.
  • Project Template ID: reutiliza una plantilla en vez de rehacer la estructura.
  • Project Type ID, Project Status ID, Project Description: tipo, estado inicial y contexto.
Casos de uso
abrir el encargo en cuanto se acepta un presupuesto.
16

Get task statuses of project by id

project.gettaskstatuses

Lo que ves en n8n

Notas y casos de uso

Lee los estados de tarea configurados en un proyecto, ya que cada proyecto puede llevar su propio tablero.

Parámetros clave

  • Project ID: el proyecto cuyos estados de tarea se leen.
  • Return All: activado para todos los estados, desactivado para topar en Limit.
  • Filter By y Order By: filtran con criterios y ordenan por un campo con su dirección.
Casos de uso
encontrar el identificador de la columna de terminado antes de que un flujo mueva solo las tareas acabadas.
17

Get task lists of project by id

project.gettasklists

Lo que ves en n8n

Notas y casos de uso

Devuelve las listas de tareas que organizan un proyecto, o sea las secciones a las que puede pertenecer una tarea.

Parámetros clave

  • Project ID: el proyecto que se inspecciona. Aliméntalo desde un evento del trigger o desde un listado anterior.
Casos de uso
comprobar que una fase no existe ya antes de volver a crearla, y elegir la lista donde colocar una tarea nueva cuando varios frentes avanzan a la vez en el mismo proyecto.
18

Create a project status

project.postprojectstatus

Lo que ves en n8n

Notas y casos de uso

Añade un estado de proyecto enviando sus datos, para que el seguimiento se parezca a cómo trabaja el equipo de verdad.

Parámetros clave

  • Project ID: el proyecto que recibe el estado nuevo.
  • Status Name: obligatorio, cómo se llama el estado.
  • Status Type: obligatorio, la categoría a la que pertenece.
Casos de uso
un flujo de aprovisionamiento que añade un estado de espera al cliente en cada proyecto de un tipo dado, en lugar de recrearlo a mano en cada encargo.
19

Change the project status

project.changeprojectstatus

Lo que ves en n8n

Notas y casos de uso

Pasa un proyecto a otro estado, la contraparte de escritura de los listados de estados.

Parámetros clave

  • Project ID: el proyecto que se mueve.
  • Project Status ID: obligatorio, y es un identificador, no la etiqueta que se ve en la interfaz. Resuélvelo antes con el listado de estados de proyecto.
Casos de uso
la última tarea de un proyecto pasa a terminada, el flujo recoge el evento y cambia el proyecto a entregado sin esperar a la revisión semanal.
20

Create a task status

project.posttaskstatus

Lo que ves en n8n

Notas y casos de uso

Suma una columna al tablero de tareas de un proyecto enviando los datos del estado.

Parámetros clave

  • Project ID: el proyecto cuyo tablero crece.
  • Status Name: obligatorio, la etiqueta de la columna.
  • Status Type: obligatorio, la categoría de la que depende.
  • Task Status Icon: también obligatorio, el icono que se muestra en el estado.
Casos de uso
un flujo plantilla que reconstruye las mismas columnas en cada proyecto de cliente, para que dos equipos no acaben con tableros que se leen distinto.
21

Create a task list

project.posttasklist

Lo que ves en n8n

Notas y casos de uso

Genera una lista de tareas dentro de un proyecto, el contenedor que agrupa las tareas.

Parámetros clave

  • Project ID: dónde se crea la lista.
  • Name: obligatorio, el nombre de esta entidad. Constrúyelo con datos anteriores, por ejemplo una etiqueta de sprint o un mes.
Casos de uso
abrir una lista limpia al empezar cada sprint y colocar ahí las tareas entrantes, para que el proyecto conserve un historial legible en vez de un backlog infinito.
22

Get comments of project

project.getcomments

Lo que ves en n8n

Notas y casos de uso

Reúne los comentarios dejados en un proyecto, un ítem por comentario, sin ningún parámetro que rellenar.

Casos de uso
archivar la conversación de un proyecto junto a sus documentos al cerrar el encargo, para que el hilo sobreviva fuera de awork. Esa misma lectura alimenta un resumen de lo hablado durante la semana, formato que le sirve a un cliente que nunca entra en la herramienta pero quiere seguir el intercambio.

Project Task

13 operaciones
23

Get tasks of a project

projecttask.gettasksofproject

Lo que ves en n8n

Notas y casos de uso

Devuelve las tareas que pertenecen a un proyecto, un ítem por tarea, la lectura con la que arrancan casi todos los flujos de seguimiento.

Parámetros clave

  • Project ID: obligatorio, el identificador del proyecto, normalmente {{ $json.projectId }} traído de un nodo anterior.
  • Return All: activo, n8n recorre todas las páginas de tareas; inactivo, Limit marca cuántas vuelven.
  • Filter By: deja solo las tareas que cumplen un criterio, con la sintaxis de filtrado de awork.
  • Order By: ordena por un campo y una dirección, por fecha de entrega por ejemplo.
Casos de uso
un informe de cierre de mes que recoge lo que sigue abierto en cada proyecto antes de facturar.
24

Get task by id

projecttask.get

Lo que ves en n8n

Notas y casos de uso

Trae una sola tarea a partir de su identificador, con todos los datos que leerán los nodos siguientes.

Parámetros clave

  • Task ID: obligatorio, el identificador de la tarea, casi siempre {{ $json.id }} salido de un evento de tarea.
Casos de uso
un evento avisa de que una tarea cambió, el flujo vuelve a leerla para obtener los campos que el evento no trae y decide si alguien debe enterarse.
25

Create a project task

projecttask.post

Lo que ves en n8n

Notas y casos de uso

Envía los datos de una tarea y la abre dentro de un proyecto.

Parámetros clave

  • Project ID: obligatorio, el proyecto que recibe la tarea.
  • Task Name: obligatorio, el nombre de la tarea.
  • Task Description: el texto largo, útil cuando la petición llega de un formulario.
  • Type of Work ID y Task Status ID: identificadores, no etiquetas, así que léelos antes con las operaciones de listado.
  • Due Date: una fecha con hora.
  • Planned Duration: un número, contado en segundos.
Casos de uso
convertir una petición entrante en una tarea ya colocada en el proyecto correcto.
26

Set a custom field

projecttask.settaskcustomfield

Lo que ves en n8n

Notas y casos de uso

Escribe un valor en un campo personalizado de una tarea, para los datos que no tienen campo estándar en awork.

Parámetros clave

  • Task ID: obligatorio, el identificador de la tarea.
  • Text Value: el valor de texto del campo personalizado.
  • Custom Field Definition ID: el identificador de la definición del campo, el que decide cuál se rellena.
Casos de uso
dejar en la tarea la referencia de un documento de facturación, para cruzar las dos herramientas más adelante sin que nadie reescriba un número.
27

Add tag

projecttask.addtag

Lo que ves en n8n

Notas y casos de uso

Pone una etiqueta en una tarea, la forma más ligera de clasificar trabajo sin tocar su estado.

Parámetros clave

  • Task ID: obligatorio, el identificador de la tarea.
  • Tag Name: el nombre de la etiqueta, que viaja como texto; acuerda una grafía antes de que el flujo escriba cientos.
Casos de uso
señalar cada tarea nacida de un cliente recurrente, para que un tablero filtrado enseñe esa cuenta aparte del resto.
28

Change status

projecttask.changestatus

Lo que ves en n8n

Notas y casos de uso

Lleva una tarea a otro estado, la contraparte de escritura de los listados de estados de tarea.

Parámetros clave

  • Task ID: obligatorio, el identificador de la tarea.
  • Status ID: el identificador del estado, no el nombre de la columna, así que lee antes los estados de tarea del proyecto.
Casos de uso
una publicación termina en una herramienta de build, el flujo cierra la tarea equivalente y nadie tiene que acordarse de mover una ficha al final del día.
29

Add comment

projecttask.comments

Lo que ves en n8n

Notas y casos de uso

Publica un comentario en una tarea, para que la parte automática del proceso deje rastro donde el equipo ya lee.

Parámetros clave

  • Task ID: obligatorio, el identificador de la tarea.
  • Comment Message: el mensaje del comentario, que se arma con los datos del nodo anterior.
Casos de uso
anotar el resultado de una revisión externa en la propia tarea en vez de mandar otro aviso suelto, que luego nadie conecta con el trabajo.
30

Set a task assignee

projecttask.settaskassignee

Lo que ves en n8n

Notas y casos de uso

Entrega una tarea a una persona, lo que convierte un ítem sin dueño en trabajo asignado.

Parámetros clave

  • Task ID: obligatorio, el identificador de la tarea.
  • User ID: el identificador del usuario, resuelto antes con la operación de listado de usuarios, porque un correo por sí solo no vale.
Casos de uso
un turno guardado fuera de awork decide quién recoge las tareas entrantes esta semana, y el flujo las asigna según se crean.
31

Get types of work

projecttask.gettypesofwork

Lo que ves en n8n

Notas y casos de uso

Lee los tipos de trabajo configurados en la cuenta, con sus identificadores.

Parámetros clave

  • Return All: activo, vuelven todos los tipos de trabajo; inactivo, Limit corta la lista.
  • Filter By: restringe los tipos con un criterio, en la sintaxis de filtrado de awork.
  • Order By: los ordena por un campo y una dirección.
Casos de uso
resolver el Type of Work ID una sola vez al principio del flujo en lugar de fijar un identificador que se cae el día que alguien reorganiza la configuración.
32

Get task lists of a project

projecttask.gettasklistsofproject

Lo que ves en n8n

Notas y casos de uso

Desde el recurso de tareas, esta lectura trae las listas de tareas de un proyecto con los controles de paginación que la lectura por proyecto no ofrece.

Parámetros clave

  • Project ID: obligatorio, el identificador del proyecto.
  • Return All: activo para el conjunto de listas, inactivo para parar en Limit.
  • Filter By: reduce las listas con un criterio.
  • Order By: las ordena por un campo y una dirección.
Casos de uso
localizar la lista del sprint en curso antes de que un nodo posterior coloque ahí las tareas nuevas.
33

Create a type of work

projecttask.posttypeofwork

Lo que ves en n8n

Notas y casos de uso

Suma un tipo de trabajo a la cuenta, la categoría con la que se califican las tareas.

Parámetros clave

  • Name: obligatorio, el nombre de esta entidad.
  • Icon: también obligatorio, el icono de esta entidad.
  • Description: la descripción de esta entidad, que conviene rellenar cuando varios equipos comparten la misma configuración.
Casos de uso
un flujo que prepara una nueva línea de servicio y crea su tipo de trabajo una vez, para poder contabilizar después todas sus tareas.
34

Add a task to a task list

projecttask.postaddtasktotasklist

Lo que ves en n8n

Notas y casos de uso

Coloca una tarea existente en una lista de tareas del proyecto, sin crear nada nuevo.

Parámetros clave

  • Project ID: obligatorio, el identificador del proyecto.
  • Task ID: obligatorio, el identificador de la tarea.
  • Task List ID: la lista a la que se mueve la tarea, que te da el listado de listas.
Casos de uso
repartir el viernes las tareas llegadas durante la semana, para que el tablero vuelva a leerse como un plan y no como un montón.
35

Get comments of task

projecttask.getcomments

Lo que ves en n8n

Notas y casos de uso

Reúne los comentarios de una tarea desde su identificador, un ítem por comentario, con el autor y el texto de cada mensaje.

Parámetros clave

  • Task ID: obligatorio, el identificador de la tarea.
Casos de uso
juntar la conversación de una tarea antes de cerrarla y guardarla con el entregable, para que el motivo de una decisión no se vaya con el tablero. Esa lectura también sirve para detectar las peticiones que llegaron por comentario y no por el encargo inicial.

User

2 operaciones
36

Get users

user.getall

Lo que ves en n8n

Notas y casos de uso

Lee los usuarios de la cuenta de awork, la lectura que permite a un flujo convertir a una persona en un identificador.

Parámetros clave

  • Return All: activo, vuelven todos los usuarios página a página; inactivo, Limit acota la lista.
  • Filter By: se queda con los usuarios que cumplen un criterio.
  • Order By: los ordena por un campo y una dirección, por nombre por ejemplo.
Casos de uso
montar una tabla de equivalencias al inicio de la ejecución, para que las asignaciones posteriores no dependan de un nombre escrito a mano.
37

Get user by id

user.get

Lo que ves en n8n

Notas y casos de uso

Lee un usuario a partir de un identificador y devuelve el perfil guardado en awork.

Parámetros clave

  • User ID: obligatorio, el identificador del usuario, muchas veces el valor que trae un evento de asignación.
Casos de uso
llega un evento de usuario, el flujo lee el perfil que hay detrás y dirige el aviso al canal del equipo correcto en lugar de a todo el mundo.
Necesitas ayuda

¿Necesitas ayuda para automatizar awork con n8n?

El equipo te responde directamente.

Cada mensaje lo lee una persona.

FAQ

awork y n8n, las dudas que aparecen

01¿La integración awork n8n es gratuita?
Sí por parte de n8n, con una condición. awork es un nodo comunitario: no viene con n8n, es el paquete npm n8n-nodes-awork, que se instala desde Settings y después Community nodes. Esa instalación solo funciona en una instancia autoalojada, levantada con Docker o npm, porque n8n Cloud únicamente acepta nodos comunitarios verificados. n8n no cobra nada por el paquete, ni por las 37 operaciones, ni por los 35 eventos del trigger. Lo que cueste tu plan de awork es otro asunto y se resuelve del lado de awork.
02¿Qué credenciales hacen falta para conectar awork?
Una credencial de awork, creada una sola vez en el menú Credentials de n8n y reutilizada después por todos los flujos de la instancia. El nodo la ofrece en una lista desplegable, así que ninguna clave se pega dentro de un nodo ni se copia de un flujo a otro. Crea la credencial antes de montar nada, lanza una operación de lectura como el listado de proyectos y en segundos sabrás si la conexión aguanta. Esa misma credencial sirve también al nodo HTTP Request mediante la autenticación predefinida, algo que importa en cuanto sales de las operaciones que cubre el nodo.
03¿Qué límites tiene el nodo de awork en n8n?
Tres que conviene anticipar. El nodo está en la versión 1 y cubre 37 operaciones sobre 5 recursos, así que todo lo que quede fuera pasa por el nodo HTTP Request, que llama directamente a la API de awork reutilizando la misma credencial. Los listados se cortan pronto si Return All queda desactivado, porque entonces manda Limit sobre el número de ítems devueltos y un informe se queda incompleto sin avisar. Y al tratarse de un paquete comunitario, la instalación se limita al n8n autoalojado: un espacio en Cloud no puede añadirlo mientras el nodo no esté verificado.
04¿El awork Trigger reacciona en tiempo real?
Sí. El awork Trigger funciona por webhook, es decir, una URL a la que awork llama en cuanto ocurre algo. n8n registra esa URL en awork al activar el flujo y cada evento llega en segundos, sin consultas repetidas. Dos consecuencias prácticas. Un flujo que se queda inactivo no recibe nada, porque el webhook solo se registra en la activación. Y el parámetro Events no ofrece una opción para escucharlo todo de golpe: entre los 35 eventos disponibles, marcas uno a uno los que quieres.
05¿n8n o Make para awork?
Depende de dónde quieras que vivan los datos y de cómo prefieras pagar. Make está alojado por Make, sin opción de autoalojamiento, y factura por operación, de modo que un flujo que recorre todos los proyectos tiene un coste que sube con el volumen. n8n corre en n8n Cloud o en tu propio servidor con Docker o npm, y el flujo se comporta igual en los dos casos. Ese autoalojamiento es justo lo que hace accesible a awork aquí, porque el paquete comunitario se instala en tu instancia. Los dos montan flujos de forma visual, así que la pregunta real es el alojamiento, el control de los datos y el modelo de coste.
Hack'celeration Lab

Recibe nuestros tips de integración cada semana.

Sin spam. Cancela cuando quieras.