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

# Todoist en flujos de trabajo: disparadores y acciones

> Crea y gestiona tareas de Todoist desde tus flujos y lanza automatizaciones cuando se completan.

Todoist es una herramienta de gestión de tareas que organiza el trabajo en proyectos, secciones y tareas, con etiquetas, prioridades, fechas y comentarios. Al conectarlo con tus flujos de trabajo de Chateea, puedes crear tareas en Todoist a partir de lo que pasa con tus contactos (un formulario, una cita, una venta) y, al revés, lanzar automatizaciones cuando alguien completa una tarea o crea un proyecto en Todoist.

## Cómo funciona la integración

* **Disparadores (de Todoist hacia Chateea):** tres disparadores (**Nueva tarea pendiente**, **Nueva tarea completada** y **Nuevo proyecto**). Todos revisan Todoist cada 5 minutos y procesan en orden los registros nuevos desde la revisión anterior.
* **Acciones (de Chateea hacia Todoist):** doce acciones para crear, actualizar y completar tareas, comentar tareas y proyectos, crear proyectos, mover tareas de sección, buscar tareas, proyectos o usuarios, y gestionar colaboradores.

> [!NOTE]
>
> Todos los disparadores y acciones de Todoist son **acciones premium**: cada ejecución se descuenta de la billetera de tu cuenta. Consulta las tarifas en **Configuración → Facturación** o en [chateea.com/precios](https://chateea.com/precios). Tu plan de Todoist (proyectos, colaboradores, funciones) lo cobra Todoist directamente.

## Conectar tu cuenta de Todoist

**1. Abre un flujo**

Ve a **Automatización → Flujos de trabajo** y abre o crea un flujo.

**2. Busca Todoist**

Agrega un disparador o una acción, cambia a la pestaña **Aplicaciones** (Apps), busca **Todoist** y elige el disparador o la acción que necesites.

**3. Autoriza la conexión**

Haz clic en **Conectar tu cuenta** (Connect your account). Todoist te pedirá aprobar los permisos. Al volver al constructor, el panel mostrará **Conectado**.

También puedes conectarlo antes de construir el flujo desde **Configuración → Integraciones**: busca **Todoist**, haz clic en **Conectar** y completa la autorización.

## Disparadores disponibles

| Disparador | Cuándo se activa |
| - | - |
| **Nueva tarea pendiente** (New incomplete task) | Se agrega una tarea nueva a un proyecto. Puedes filtrar por proyecto. Devuelve título, nota, fecha de vencimiento, fecha límite, prioridad, etiquetas, proyecto y sección |
| **Nueva tarea completada** (New completed task) | Una tarea existente se marca como completada. Ideal para cerrar el ciclo y avisar a alguien |
| **Nuevo proyecto** (New project) | Se crea un proyecto en la cuenta conectada. Útil para arrancar procesos de inicio de proyecto |

## Acciones disponibles

### Tareas

| Acción | Para qué sirve |
| - | - |
| **Crear tarea** | Crea una tarea con proyecto, sección, etiquetas, prioridad y fecha opcionales. El título es obligatorio. Si no indicas proyecto, va a la **Bandeja de entrada** (Inbox) |
| **Actualizar tarea** | Cambia el título, la nota, la fecha de vencimiento, la fecha límite, la prioridad o las etiquetas de una tarea por su ID |
| **Marcar tarea como completada** | Completa una tarea. Esto activa también el disparador **Nueva tarea completada** en la misma cuenta |
| **Mover tarea a sección** | Mueve una tarea a otra sección dentro de su proyecto |

### Comentarios

| Acción | Para qué sirve |
| - | - |
| **Agregar comentario a tarea** | Anota avances o añade contexto a una tarea existente |
| **Agregar comentario a proyecto** | Comenta a nivel de proyecto, no de una tarea concreta |

### Proyectos, búsqueda y colaboración

| Acción | Para qué sirve |
| - | - |
| **Crear proyecto** | Crea un proyecto nuevo, por ejemplo uno por cada cliente que empiezas a atender |
| **Buscar tareas** | Busca tareas por nombre, proyecto, etiqueta o filtro para decidir qué hacer después |
| **Buscar proyectos** | Lista los proyectos o los filtra por nombre y devuelve su ID. Lo necesitas antes de **Crear tarea** si el proyecto no es la Bandeja de entrada |
| **Buscar usuario** | Localiza un usuario de Todoist por nombre o correo |
| **Obtener colaboradores del proyecto** | Lista las personas que colaboran en un proyecto |
| **Invitar usuario al proyecto** | Invita a alguien por correo a colaborar en un proyecto |

## Ejemplo: configurar el disparador "Nueva tarea pendiente"

Los disparadores **Nueva tarea completada** y **Nuevo proyecto** se configuran de la misma forma; solo cambian la selección y los filtros disponibles.

**1. Agrega el disparador**

En el flujo, haz clic en **Agregar disparador**, abre la pestaña **Aplicaciones**, busca **Todoist** y elige **Nueva tarea pendiente**.

**2. Configúralo**

* **Cuenta conectada:** la cuenta de Todoist que quieres vigilar.
* **Nombre del disparador:** por ejemplo "Nueva tarea de soporte".
* **Proyecto:** elige un proyecto para que el disparador solo se active con tareas de ese proyecto. Déjalo vacío para escuchar todos.
* **Filtros (opcional):** agrega condiciones por etiqueta, prioridad o rango de fechas.

**3. Pruébalo**

Haz clic en **Buscar nuevos registros** (Find new records) en el panel de prueba. Si no aparece nada, crea una tarea en el proyecto elegido, espera un ciclo de revisión (5 minutos) y vuelve a buscar. Selecciona el registro como referencia y haz clic en **Guardar disparador**.

## Ejemplo: configurar la acción "Crear tarea"

**1. Agrega la acción**

Haz clic en **+** donde quieras la acción, abre la pestaña **Aplicaciones**, elige **Todoist** y luego **Crear tarea**.

**2. Completa los campos**

* **Cuenta conectada:** la cuenta donde se creará la tarea.
* **Nombre de la acción:** por ejemplo "Tarea desde formulario".
* **Proyecto:** elígelo del desplegable. Si no lo indicas, se usa la Bandeja de entrada. Si solo conoces el nombre del proyecto al momento de ejecutar, usa antes **Buscar proyectos** para obtener su ID.
* **Título** (obligatorio): breve y claro.
* **Nota:** descripción detallada si el título no basta.
* **Fecha de vencimiento:** usa el formato legible (Human Formatted) **o** el formato estructurado (Raw Formatted), nunca ambos.
* **Fecha límite** (opcional): en formato `YYYY-MM-DD`. Las fechas límite de Todoist no admiten hora.
* **Prioridad:** de P1 (roja, la más alta) a P4 (gris, la más baja y la predeterminada).
* **Etiquetas:** una o varias. Deben existir antes en tu cuenta de Todoist.

**3. Prueba y guarda**

Haz clic en **Probar acción**. La prueba crea una tarea real en Todoist, así que usa un título fácil de identificar (por ejemplo "PRUEBA, BORRAR") si trabajas en un proyecto real. Guarda la acción y prueba el flujo completo antes de publicarlo.

## Cómo probar disparadores y acciones

* **Disparadores:** haz clic en **Buscar nuevos registros**. Si no hay resultados, crea o completa una tarea (o crea un proyecto) en Todoist, espera 5 minutos y vuelve a buscar. Selecciona el registro como referencia para los pasos siguientes.
* **Acciones:** haz clic en **Probar acción**. Se ejecuta sobre tu cuenta real de Todoist y crea tareas, comentarios o proyectos de verdad. Verifícalo en Todoist y borra los registros de prueba al terminar.

## Ideas de uso

> **Formulario enviado: tarea en el proyecto correcto**
>
> Disparador **Formulario enviado** → condición según las respuestas para elegir proyecto o urgencia → **Buscar proyectos** para obtener el ID → **Crear tarea** con el título del formulario, las respuestas completas en la nota, prioridad según la urgencia y etiquetas para el equipo. Por ejemplo, una solicitud marcada como "urgente" crea una tarea P1 en el proyecto "Soporte" en segundos.

> **Tarea completada: actualizar el CRM**
>
> Disparador **Nueva tarea completada** filtrado por proyecto → identificar el contacto relacionado (por ejemplo, con un ID de tarea guardado en un campo personalizado o una etiqueta con la referencia del contacto) → actualizar el contacto, enviar un aviso o mover la oportunidad de etapa. Tu equipo sigue trabajando en Todoist y el CRM se mantiene al día solo.

> **Tarea de equipo con fecha y etiqueta**
>
> Cualquier evento que requiera seguimiento → **Crear tarea** en un proyecto compartido con prioridad P2 y etiqueta "revisar" → **Agregar comentario a tarea** con contexto, enlaces o instrucciones.

## Preguntas frecuentes

> **¿Los disparadores son instantáneos?**
>
> No. Los tres disparadores revisan Todoist cada 5 minutos y procesan en orden los registros nuevos desde la última revisión, así que puede haber un retraso de hasta 5 minutos.

> **¿Por qué mi tarea se crea en la Bandeja de entrada?**
>
> Porque no indicaste proyecto en **Crear tarea**. Elige uno en el desplegable o usa **Buscar proyectos** antes para obtener su ID.

> **¿Por qué no se aplican mis etiquetas?**
>
> Las etiquetas deben existir previamente en tu cuenta de Todoist. Créalas allí y vuelve a probar la acción.

> **¿Puedo completar una tarea desde Chateea y que dispare otro flujo?**
>
> Sí. La acción **Marcar tarea como completada** hace que se active el disparador **Nueva tarea completada** en los flujos que escuchan esa misma cuenta.

## Artículos relacionados

> **[Cómo funcionan los flujos](https://help.chateea.com/docs/automatizaciones/introduccion.md)**
>
> Conceptos básicos de disparadores y acciones.

> **[Solución de problemas de flujos](https://help.chateea.com/docs/automatizaciones/solucion-de-problemas.md)**
>
> Qué revisar cuando un flujo no se comporta como esperas.


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