Toolkit de Asana

Interactúa con proyectos, tareas y usuarios de Asana desde dentro de un flujo de trabajo.

El Toolkit de Asana permite que sus flujos de trabajo interactúen con Asana — recuperando proyectos, tareas, usuarios y espacios de trabajo, así como creando y actualizando tareas.

​

Autenticación

Todas las herramientas de Asana requieren una conexión de cuenta de Asana. Cada herramienta incluye un selector de Cuenta de Asana con dos opciones:

Opción	Descripción
Usar mi cuenta de Asana	Usa su cuenta personal de Asana conectada.
Usar cuenta de equipo	Usa una cuenta de equipo compartida de Asana configurada para el proyecto.

Si no hay una cuenta conectada, haga clic en Conectar cuenta de Asana para autenticar.

​

Herramientas

​

Obtener proyectos de Asana

Recupera todos los proyectos accesibles para la cuenta de Asana conectada.

Campo	Obligatorio	Descripción
Cuenta de Asana	Sí	Seleccione su cuenta personal o de equipo de Asana.

​

Obtener usuarios de Asana

Recupera todos los usuarios en el espacio de trabajo de Asana conectado.

Campo	Obligatorio	Descripción
Cuenta de Asana	Sí	Seleccione su cuenta personal o de equipo de Asana.

​

Obtener espacios de trabajo de Asana

Recupera todos los espacios de trabajo accesibles para la cuenta de Asana conectada.

Campo	Obligatorio	Descripción
Cuenta de Asana	Sí	Seleccione su cuenta personal o de equipo de Asana.

​

Obtener campos personalizados de Asana

Recupera las definiciones de campos personalizados configurados para un proyecto específico de Asana.

Campo	Obligatorio	Descripción
Cuenta de Asana	Sí	Seleccione su cuenta personal o de equipo de Asana.
ID del proyecto	Sí	El ID del proyecto del que obtener las definiciones de campos personalizados. Escriba @ para seleccionar una variable.

​

Obtener tareas de Asana

Recupera tareas de un proyecto específico de Asana con filtros opcionales para asignatario, espacio de trabajo y paginación.

Campo	Obligatorio	Descripción
Cuenta de Asana	Sí	Seleccione su cuenta personal o de equipo de Asana.
ID del proyecto	Sí	El ID del proyecto del que obtener tareas. Escriba @ para seleccionar una variable.
Límite	No	Número máximo de tareas a devolver por solicitud API. El valor predeterminado es 50.
Asignatario	No	Filtra tareas por ID de usuario o correo electrónico del asignatario. El valor predeterminado es null.
Espacio de trabajo	No	Filtra tareas por ID del espacio de trabajo. Usa el espacio de trabajo predeterminado si no se proporciona. El valor predeterminado es null.
Desplazamiento	No	Token de desplazamiento inicial para la paginación. Generalmente no es necesario ya que obtiene todas las páginas. El valor predeterminado es null.

​

Obtener tareas de usuario de Asana

Recupera todas las tareas asignadas a un usuario específico en Asana.

Campo	Obligatorio	Descripción
Cuenta de Asana	Sí	Seleccione su cuenta personal o de equipo de Asana.
Asignatario	Sí	El ID de usuario o dirección de correo electrónico para obtener las tareas. Escriba @ para seleccionar una variable.
Espacio de trabajo	No	ID del espacio de trabajo en el que buscar. Usa el espacio de trabajo predeterminado si no se proporciona. El valor predeterminado es null.
Límite	No	Número máximo de tareas a devolver por solicitud API. El valor predeterminado es 50.
Desplazamiento	No	Token de desplazamiento inicial para la paginación. Generalmente no es necesario ya que obtiene todas las páginas. El valor predeterminado es null.

​

Crear tarea de Asana

Crea una nueva tarea en un proyecto específico de Asana.

Campo	Obligatorio	Descripción
Cuenta de Asana	Sí	Seleccione su cuenta personal o de equipo de Asana.
ID del proyecto	Sí	El ID del proyecto donde se creará la tarea. Escriba @ para seleccionar una variable.
Nombre	Sí	El nombre/título de la tarea. Escriba @ para seleccionar una variable.
Notas	No	Descripción o notas para la tarea. El valor predeterminado es null.
Asignatario	No	Correo electrónico o ID de la persona a la que se asignará la tarea. El valor predeterminado es null.
Fecha de vencimiento	No	Fecha de vencimiento en formato ISO (YYYY-MM-DD) o cualquier formato de fecha analizable. El valor predeterminado es null.
Etiquetas	No	Array de nombres de etiquetas o GIDs de etiquetas para asignar a la tarea. El valor predeterminado es null.
Campos personalizados	No	Campos personalizados como diccionario. Formato: {"field_gid": "valor"} o {"field_name": "valor"}. Para campos de enumeración, use el GID o nombre de la opción de enumeración. El valor predeterminado es null.

​

Actualizar tarea de Asana

Actualiza una tarea existente de Asana por su ID.

Campo	Obligatorio	Descripción
Cuenta de Asana	Sí	Seleccione su cuenta personal o de equipo de Asana.
ID de tarea	Sí	El ID de la tarea a actualizar. Escriba @ para seleccionar una variable.
Nombre	No	Nuevo nombre/título para la tarea. El valor predeterminado es null.
Notas	No	Nueva descripción o notas para la tarea. El valor predeterminado es null.
Completada	No	Marca la tarea como completada (true) o incompleta (false). El valor predeterminado es null.
Campos personalizados	No	Campos personalizados a actualizar como diccionario. Formato: {"field_gid": "valor"} o {"field_name": "valor"}. El valor predeterminado es null.