Toolkit de Asana
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. |