API de Todoist: qué puedes hacer y cómo usarla con agentes de IA
La API de Todoist permite crear, actualizar y completar tareas, y gestionar proyectos, secciones, etiquetas y comentarios. La usan personas y equipos que organizan su trabajo en Todoist y quieren alimentar tareas desde otros sistemas. El acceso es con un token personal o con OAuth para aplicaciones.
Qué ofrece la API de Todoist
Tareas
Creación con fecha límite, prioridad, responsable y recurrencia; finalización y edición.
Proyectos y secciones
Organización de las tareas por proyecto y etapa.
Etiquetas
Clasificación de las tareas por contexto.
Comentarios
Notas y archivos adjuntos en tareas y proyectos.
Sincronización
Lectura incremental de lo que cambió desde la última consulta.
Webhooks
Avisos de tareas creadas, completadas y modificadas para aplicaciones.
Cómo acceder a la API de Todoist
- API públicaToken personal disponible en los ajustes de integración de Todoist, u OAuth 2.0 para aplicaciones publicadas.
- El token personal accede a todo lo de la cuenta: guárdalo solo en la bóveda.
- Hay límites de solicitudes: usa la sincronización incremental.
- Las tareas pueden contener información sensible: evita reenviarla a otros canales.
Documentación oficial: developer.todoist.com
Qué hace un agente de iTeam con la API de Todoist
Correo que se convierte en tarea
El agente lee las peticiones recibidas por correo y crea la tarea en el proyecto correcto, con fecha límite y enlace al mensaje.
Planificación del día
Cada mañana, el agente envía por WhatsApp las tareas de hoy y las atrasadas, y reprograma lo que la persona pida.
De acta a acción
Después de la reunión, las decisiones se convierten en tareas con responsables en el proyecto compartido.
Revisión semanal
El agente lista las tareas paradas desde hace semanas y pregunta si siguen vigentes.
De la credencial al agente trabajando, con aprobación
Obtén el token o autoriza por OAuth
Usa la cuenta propietaria de las tareas o una aplicación con los alcances mínimos.
Regístralo en la bóveda de iTeam
El token queda en la bóveda; el agente crea y completa tareas, sin borrar proyectos.
Prueba con aprobación
Las eliminaciones y los cambios en proyectos compartidos pasan por confirmación.
Equipos de IA listos para este trabajo
Reportes e indicadores
Nina junta los datos, Darwin revisa los números y el informe de indicadores llega a Slack con lo que cambió y por qué.
Gestión de inventario
Nina vigila cada referencia, Darwin calcula cuánto reponer y la orden de compra sale solo cuando una persona la aprueba.
Compras y cotizaciones
Darwin pide cotizaciones y las compara en una tabla, Henry revisa las condiciones y la orden de compra sale con la aprobación registrada.
Logística y entregas
Nina arma las rutas y sigue a cada conductor por WhatsApp; Jaca avisa al cliente del estado de su pedido antes de que llame.
Preguntas sobre la API de Todoist
¿La API de Todoist es gratuita?
En general, sí: la API está disponible sin cobro por llamada, aunque algunos recursos dependen del plan de la cuenta.
¿Necesito programar para usar la API de Todoist con iTeam?
No necesariamente. Todoist está en el catálogo de apps, y el equipo de implantación configura los flujos.
¿Se puede crear una tarea con lenguaje natural?
Sí, la API acepta fechas escritas de forma natural, y el agente interpreta la petición antes de crear la tarea.
