Saltar al contenido principal
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ónDescripción
Usar mi cuenta de AsanaUsa su cuenta personal de Asana conectada.
Usar cuenta de equipoUsa 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.
CampoObligatorioDescripción
Cuenta de AsanaSeleccione su cuenta personal o de equipo de Asana.

Obtener usuarios de Asana

Recupera todos los usuarios en el espacio de trabajo de Asana conectado.
CampoObligatorioDescripción
Cuenta de AsanaSeleccione 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.
CampoObligatorioDescripción
Cuenta de AsanaSeleccione 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.
CampoObligatorioDescripción
Cuenta de AsanaSeleccione su cuenta personal o de equipo de Asana.
ID del proyectoEl 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.
CampoObligatorioDescripción
Cuenta de AsanaSeleccione su cuenta personal o de equipo de Asana.
ID del proyectoEl ID del proyecto del que obtener tareas. Escriba @ para seleccionar una variable.
LímiteNoNúmero máximo de tareas a devolver por solicitud API. El valor predeterminado es 50.
AsignatarioNoFiltra tareas por ID de usuario o correo electrónico del asignatario. El valor predeterminado es null.
Espacio de trabajoNoFiltra tareas por ID del espacio de trabajo. Usa el espacio de trabajo predeterminado si no se proporciona. El valor predeterminado es null.
DesplazamientoNoToken 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.
CampoObligatorioDescripción
Cuenta de AsanaSeleccione su cuenta personal o de equipo de Asana.
AsignatarioEl ID de usuario o dirección de correo electrónico para obtener las tareas. Escriba @ para seleccionar una variable.
Espacio de trabajoNoID del espacio de trabajo en el que buscar. Usa el espacio de trabajo predeterminado si no se proporciona. El valor predeterminado es null.
LímiteNoNúmero máximo de tareas a devolver por solicitud API. El valor predeterminado es 50.
DesplazamientoNoToken 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.
CampoObligatorioDescripción
Cuenta de AsanaSeleccione su cuenta personal o de equipo de Asana.
ID del proyectoEl ID del proyecto donde se creará la tarea. Escriba @ para seleccionar una variable.
NombreEl nombre/título de la tarea. Escriba @ para seleccionar una variable.
NotasNoDescripción o notas para la tarea. El valor predeterminado es null.
AsignatarioNoCorreo electrónico o ID de la persona a la que se asignará la tarea. El valor predeterminado es null.
Fecha de vencimientoNoFecha de vencimiento en formato ISO (YYYY-MM-DD) o cualquier formato de fecha analizable. El valor predeterminado es null.
EtiquetasNoArray de nombres de etiquetas o GIDs de etiquetas para asignar a la tarea. El valor predeterminado es null.
Campos personalizadosNoCampos 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.
CampoObligatorioDescripción
Cuenta de AsanaSeleccione su cuenta personal o de equipo de Asana.
ID de tareaEl ID de la tarea a actualizar. Escriba @ para seleccionar una variable.
NombreNoNuevo nombre/título para la tarea. El valor predeterminado es null.
NotasNoNueva descripción o notas para la tarea. El valor predeterminado es null.
CompletadaNoMarca la tarea como completada (true) o incompleta (false). El valor predeterminado es null.
Campos personalizadosNoCampos personalizados a actualizar como diccionario. Formato: {"field_gid": "valor"} o {"field_name": "valor"}. El valor predeterminado es null.