Asana

Descripción

Los nodos Asana conectan tus workflows con Asana a través de su API REST 1.0. Con ellos podés automatizar la gestión de tareas: crear una tarea cuando entra un lead, marcarla como completada al terminar un proceso, comentar el resultado, o listar las tareas de un proyecto para procesarlas.

Hay seis nodos, uno por operación:

Nodo	Operación	Método HTTP
Asana: Crear tarea (`asanaCreateTask`)	Crea una tarea	`POST /tasks`
Asana: Leer tarea (`asanaGetTask`)	Lee una tarea por su gid	`GET /tasks/{gid}`
Asana: Actualizar tarea (`asanaUpdateTask`)	Actualiza campos	`PUT /tasks/{gid}`
Asana: Borrar tarea (`asanaDeleteTask`)	Borra una tarea	`DELETE /tasks/{gid}`
Asana: Comentar tarea (`asanaAddComment`)	Agrega un comentario	`POST /tasks/{gid}/stories`
Asana: Listar tareas (`asanaListTasks`)	Lista las tareas de un proyecto	`GET /tasks?project={gid}`

Credencial

Los nodos usan una credencial de tipo Asana. Creala en Credenciales → Agregar → Asana con estos campos:

Campo	Descripción
Personal Access Token	Se genera en app.asana.com → Configuración → Apps → Developer console → Personal Access Token. Nunca se muestra en logs.
Workspace por defecto (gid)	Opcional. El gid del workspace a usar cuando el nodo no especifica uno.

La autenticación es Bearer (Personal Access Token). Podés probar la credencial con el botón Test, que llama a GET /users/me y confirma el usuario.

Nota importante: gid

En Asana, los identificadores se llaman gid (son strings, no números). Todo lo que referencie una tarea, proyecto, workspace o responsable usa su gid. Podés obtener el gid de un proyecto desde su URL en Asana, o listando recursos con el nodo HTTP.

Nodos

Asana: Crear tarea (`asanaCreateTask`)

Parámetro	Tipo	Requerido	Descripción
credentials_id	credencial	Sí	Credencial de Asana
name	texto	Sí	Nombre de la tarea
notes	texto	No	Descripción / notas
project_gid	texto	No	gid del proyecto (recomendado)
workspace_gid	texto	No	gid del workspace (si no hay proyecto ni default en la credencial)
assignee	texto	No	gid o email del responsable
due_on	texto	No	Fecha límite `YYYY-MM-DD`

Necesitás al menos un project_gid o un workspace_gid (o un workspace por defecto en la credencial). Salida: la tarea creada, incluyendo su gid.

Asana: Leer tarea (`asanaGetTask`)

Parámetro	Tipo	Requerido	Descripción
credentials_id	credencial	Sí	Credencial de Asana
task_gid	texto	Sí	gid de la tarea
opt_fields	texto	No	Campos a devolver, separados por coma

Asana: Actualizar tarea (`asanaUpdateTask`)

Parámetro	Tipo	Requerido	Descripción
credentials_id	credencial	Sí	Credencial de Asana
task_gid	texto	Sí	gid de la tarea
fields	JSON	Sí	Campos a actualizar, ej. `{"completed":true}`

Asana: Borrar tarea (`asanaDeleteTask`)

Parámetro	Tipo	Requerido	Descripción
credentials_id	credencial	Sí	Credencial de Asana
task_gid	texto	Sí	gid de la tarea a borrar

Asana: Comentar tarea (`asanaAddComment`)

Parámetro	Tipo	Requerido	Descripción
credentials_id	credencial	Sí	Credencial de Asana
task_gid	texto	Sí	gid de la tarea
text	texto	Sí	Texto del comentario

El comentario se agrega como una story de la tarea (el mecanismo de Asana para comentarios y actividad).

Asana: Listar tareas (`asanaListTasks`)

Parámetro	Tipo	Requerido	Descripción
credentials_id	credencial	Sí	Credencial de Asana
project_gid	texto	Sí	gid del proyecto
limit	número	No	Máximo de resultados (por defecto 50)
opt_fields	texto	No	Campos a devolver, separados por coma

Salida: el array de tareas del proyecto.

Ejemplo

Crear una tarea en un proyecto a partir de un formulario:

Nodo: Asana: Crear tarea
name: Seguimiento: {{data.cliente}}
notes: {{data.mensaje}}
project_gid: 1201234567890123
due_on: 2026-08-15

Salida:

{
  "gid": "1209876543210987",
  "name": "Seguimiento: ACME S.A.",
  "resource_type": "task",
  "completed": false
}

Manejo de errores

Cada nodo clasifica los errores para que el motor sepa si tiene sentido reintentar:

Situación	Reintentable	Qué hacer
Validación (400/412)	No	Asana devuelve el motivo (ej. gid inválido o campo faltante). Corregí los datos.
No encontrado (404)	No	La tarea o el proyecto no existen. Revisá el gid.
Autenticación (401/403)	No	Token inválido o sin permiso sobre el recurso. Revisá la credencial.
Servidor (500)	Sí	Error temporal de Asana; se reintenta automáticamente.
Límite de tasa (429)	Sí	Se respeta el `Retry-After` de Asana y se reintenta.
Red / Timeout	Sí	Problema pasajero; se reintenta automáticamente.

Ver también

Jira (Atlassian) — el equivalente para tickets/incidencias.
Cola de reintentos (DLQ) — cómo se reintentan las ejecuciones que fallan.
Nodo HTTP — para endpoints de Asana no cubiertos por estos nodos.