Instrucciones de uso
Integra Asana en el flujo de trabajo. Puede leer, escribir y actualizar tareas.
Herramientas
asana_get_task
Recupera una tarea individual por GID u obtén múltiples tareas con filtros
Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
taskGid | string | No | El identificador único global (GID) de la tarea. Si no se proporciona, obtendrá múltiples tareas. |
workspace | string | No | GID del espacio de trabajo para filtrar tareas (requerido cuando no se usa taskGid) |
project | string | No | GID del proyecto para filtrar tareas |
limit | number | No | Número máximo de tareas a devolver (predeterminado: 50) |
Salida
| Parámetro | Tipo | Descripción |
|---|---|---|
success | boolean | Estado de éxito de la operación |
ts | string | Marca de tiempo de la respuesta |
gid | string | Identificador único global de la tarea |
resource_type | string | Tipo de recurso (tarea) |
resource_subtype | string | Subtipo de recurso |
name | string | Nombre de la tarea |
notes | string | Notas o descripción de la tarea |
completed | boolean | Si la tarea está completada |
assignee | object | Detalles del asignado |
asana_create_task
Crear una nueva tarea en Asana
Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
workspace | string | Sí | GID del espacio de trabajo donde se creará la tarea |
name | string | Sí | Nombre de la tarea |
notes | string | No | Notas o descripción para la tarea |
assignee | string | No | GID del usuario al que se asignará la tarea |
due_on | string | No | Fecha de vencimiento en formato AAAA-MM-DD |
Salida
| Parámetro | Tipo | Descripción |
|---|---|---|
success | boolean | Estado de éxito de la operación |
ts | string | Marca de tiempo de la respuesta |
gid | string | Identificador único global de la tarea |
name | string | Nombre de la tarea |
notes | string | Notas o descripción de la tarea |
completed | boolean | Si la tarea está completada |
created_at | string | Marca de tiempo de creación de la tarea |
permalink_url | string | URL a la tarea en Asana |
asana_update_task
Actualizar una tarea existente en Asana
Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
taskGid | string | Sí | El identificador único global (GID) de la tarea a actualizar |
name | string | No | Nombre actualizado para la tarea |
notes | string | No | Notas o descripción actualizadas para la tarea |
assignee | string | No | GID del usuario asignado actualizado |
completed | boolean | No | Marcar tarea como completada o no completada |
due_on | string | No | Fecha de vencimiento actualizada en formato AAAA-MM-DD |
Salida
| Parámetro | Tipo | Descripción |
|---|---|---|
success | boolean | Estado de éxito de la operación |
ts | string | Marca de tiempo de la respuesta |
gid | string | Identificador único global de la tarea |
name | string | Nombre de la tarea |
notes | string | Notas o descripción de la tarea |
completed | boolean | Si la tarea está completada |
modified_at | string | Marca de tiempo de última modificación de la tarea |
asana_get_projects
Recuperar todos los proyectos de un espacio de trabajo de Asana
Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
workspace | string | Sí | GID del espacio de trabajo del que recuperar los proyectos |
Salida
| Parámetro | Tipo | Descripción |
|---|---|---|
success | boolean | Estado de éxito de la operación |
ts | string | Marca de tiempo de la respuesta |
projects | array | Array de proyectos |
asana_search_tasks
Buscar tareas en un espacio de trabajo de Asana
Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
workspace | string | Sí | GID del espacio de trabajo donde buscar tareas |
text | string | No | Texto a buscar en los nombres de las tareas |
assignee | string | No | Filtrar tareas por GID del usuario asignado |
projects | array | No | Array de GIDs de proyectos para filtrar tareas |
completed | boolean | No | Filtrar por estado de finalización |
Salida
| Parámetro | Tipo | Descripción |
|---|---|---|
success | boolean | Estado de éxito de la operación |
ts | string | Marca de tiempo de la respuesta |
tasks | array | Array de tareas coincidentes |
asana_add_comment
Añadir un comentario (historia) a una tarea de Asana
Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
taskGid | string | Sí | El identificador único global (GID) de la tarea |
text | string | Sí | El contenido de texto del comentario |
Salida
| Parámetro | Tipo | Descripción |
|---|---|---|
success | boolean | Estado de éxito de la operación |
ts | string | Marca de tiempo de la respuesta |
gid | string | Identificador único global del comentario |
text | string | Contenido de texto del comentario |
created_at | string | Marca de tiempo de creación del comentario |
created_by | object | Detalles del autor del comentario |
Notas
- Categoría:
tools - Tipo:
asana
Salida
| Parámetro | Tipo | Descripción |
|---|---|---|
success | boolean | Estado de éxito de la operación |
ts | string | Marca de tiempo de la respuesta |
gid | string | Identificador único global del comentario |
text | string | Contenido de texto del comentario |
created_at | string | Marca de tiempo de creación del comentario |
created_by | object | Detalles del autor del comentario |
↳ gid | string | GID del autor |
↳ name | string | Nombre del autor |