> ## Documentation Index
> Fetch the complete documentation index at: https://docs.fetchhive.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Ticktick

> Aplicación de gestión de tareas y listas de tareas para organizar proyectos, tareas, comentarios y etiquetas a través de tu cuenta conectada.

# Ticktick

Usa TickTick cuando necesites crear, actualizar, completar o revisar tareas y proyectos en tus flujos de trabajo. También te ayuda cuando necesitas comentarios, etiquetas o datos del proyecto para enrutar el trabajo.

## Configuración

| Opción | Requerido | Descripción |
| - | - | - |
| Nombre | No | Etiqueta para el paso en el lienzo del flujo de trabajo. |
| Authentication | Sí | La cuenta de Ticktick conectada que se usará para este paso. |
| Action | Sí | La acción de Ticktick que se realizará (por ejemplo, Get User Projects, Get Project By ID, Get Project With Data, Create Project). |
| Arguments | Sí | Campos de formulario específicos de cada acción generados a partir del esquema de la acción. Cada campo de texto tiene un botón **Insert Variable** para insertar valores `{{placeholder}}`. Hay una pestaña **Raw JSON** disponible para uso avanzado. |
| When the step fails | No | Controla si el flujo de trabajo debe **Terminate Workflow** o **Continue** si este paso falla. |

Antes de configurar este paso, conecta Ticktick en **Integrations** para tu espacio de trabajo usando el flujo de inicio de sesión. Si no hay ninguna conexión activa disponible, el paso muestra una advertencia con un enlace a **Integrations** en lugar del selector de cuenta.

## Formulario de Arguments

Cuando seleccionas una acción, la sección **Arguments** muestra un formulario generado a partir del esquema de entrada de la acción. Los campos que hacen referencia a registros existentes incluyen selectores desplegables.

Cambia a la pestaña **Raw JSON** cuando prefieras escribir el objeto completo de argumentos manualmente. Los cambios en cualquiera de las pestañas se mantienen sincronizados.

## Acciones comunes

| Action | Descripción |
| - | - |
| **Get User Projects** | Recupera todos los proyectos accesibles para la cuenta conectada. |
| **Get Project By ID** | Recupera un solo proyecto por su ID. |
| **Get Project With Data** | Recupera un proyecto junto con sus tareas y columnas. |
| **Create Project** | Crea un nuevo proyecto. |
| **Update Project** | Actualiza un proyecto existente. |
| **List All Tasks** | Lista todas las tareas abiertas de tus proyectos. |
| **Filter Tasks** | Devuelve tareas que coinciden con filtros de proyecto, fecha, prioridad, etiqueta, tipo o estado. |
| **Get Task By Project And ID** | Recupera una tarea de un proyecto por sus IDs. |
| **Create Task** | Crea una nueva tarea. |
| **Update Task** | Actualiza una tarea existente. |
| **Complete Task** | Marca una tarea como completada. |
| **Batch Create Or Update Tasks** | Crea o actualiza hasta 50 tareas en una sola solicitud. |
| **Add Task Comment** | Añade un comentario a una tarea. |
| **List Task Comments** | Lista los comentarios adjuntos a una tarea. |
| **List Tags** | Lista las etiquetas disponibles para tu cuenta. |

Las acciones destructivas, como eliminar registros, no están disponibles en el selector de acciones del flujo de trabajo.

## Output

Este paso almacena la respuesta de Ticktick como la salida del paso. La estructura de la respuesta depende de la acción.

Usa la referencia de salida completa en pasos posteriores:

```text theme={null}
{{STEP_IDENTIFIER.output}}
```

## Ejemplo

1. Abre **Integrations** y conecta Ticktick si aún no lo has hecho.
2. Añade un paso de **Ticktick** a tu flujo de trabajo.
3. Selecciona una cuenta conectada en **Authentication**.
4. Elige **Get User Projects** en **Action**.
5. Completa los campos obligatorios. Usa **Insert Variable** para referenciar la salida de un paso anterior para cualquier valor de campo.
6. Haz clic en **Run** en el encabezado del paso para probar la acción y luego revisa la carga útil devuelta en **Output**.

## Casos de uso

### Crear una tarea a partir de una respuesta de formulario

1. Create Task
2. Update Task
3. Get Task By Project And ID

### Cerrar trabajo completado

1. List All Tasks
2. Complete Task
3. Add Task Comment

### Revisar un proyecto y sus tareas

1. Get Project By ID
2. Get Project With Data
3. List Task Comments

## Notas

* Este paso depende de una integración conectada de Ticktick en tu espacio de trabajo.
* El selector de acciones del flujo de trabajo muestra un conjunto curado de acciones. Los agentes con la herramienta Ticktick pueden usar más de ellas.
* La pantalla de inicio de sesión puede mostrar la marca de autorización de terceros.

## Usar Ticktick como herramienta de agente

También puedes añadir Ticktick como herramienta en el **Agent Editor**. Abre el agente, haz clic en **Add tool** y selecciona **Ticktick**. En el panel de configuración de la herramienta, elige la cuenta conectada que el agente debe usar. El agente llama a acciones de Ticktick cuando son relevantes para la conversación.

See also: [Integrations](https://docs.fetchhive.com/es/workspace/integrations.md), [Creating and Editing](https://docs.fetchhive.com/es/workflows/creating-and-editing.md), and [Testing and Iteration](https://docs.fetchhive.com/es/workflows/testing-and-iteration.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.