API Todoist : ce qu'elle permet et comment l'utiliser avec des agents IA
L'API Todoist permet de créer, mettre à jour et terminer des tâches, et de gérer les projets, sections, étiquettes et commentaires. Elle sert aux personnes et aux équipes qui organisent leur travail dans Todoist et veulent y alimenter des tâches depuis d'autres systèmes. L'accès se fait par un jeton personnel ou par OAuth pour les applications.
Ce que propose l’API Todoist
Tâches
Création avec échéance, priorité, responsable et récurrence ; clôture et modification.
Projets et sections
Organisation des tâches par projet et par étape.
Étiquettes
Classement des tâches par contexte.
Commentaires
Notes et pièces jointes sur les tâches et les projets.
Synchronisation
Lecture incrémentale de ce qui a changé depuis la dernière consultation.
Webhooks
Notifications de tâches créées, terminées et modifiées pour les applications.
Comment accéder à l’API Todoist
- API publiqueJeton personnel disponible dans les paramètres d'intégration de Todoist, ou OAuth 2.0 pour les applications publiées.
- Le jeton personnel accède à tout le compte : conservez-le uniquement dans le coffre.
- Des limites de requêtes existent ; utilisez la synchronisation incrémentale.
- Les tâches peuvent contenir des informations sensibles ; évitez de les relayer vers d'autres canaux.
Documentation officielle: developer.todoist.com
Ce qu’un agent iTeam fait avec l’API Todoist
L'e-mail devient tâche
L'agent lit les demandes reçues par e-mail et crée la tâche dans le bon projet, avec l'échéance et le lien du message.
Planification de la journée
Chaque matin, l'agent envoie sur WhatsApp les tâches du jour et celles en retard, et replanifie ce que la personne demande.
Du compte rendu à l'action
Après la réunion, les décisions deviennent des tâches avec responsables dans le projet partagé.
Revue hebdomadaire
L'agent liste les tâches à l'arrêt depuis des semaines et demande si elles restent d'actualité.
De l’identifiant à l’agent au travail, avec validation
Récupérez le jeton ou autorisez via OAuth
Utilisez le compte propriétaire des tâches ou une application aux portées minimales.
Enregistrez-le dans le coffre iTeam
Le jeton reste dans le coffre ; l'agent crée et termine des tâches, sans supprimer de projets.
Testez avec validation
Les suppressions et les modifications de projets partagés passent par une confirmation.
Équipes IA prêtes à l’emploi pour ce travail
Reporting de direction
Les chiffres des ventes, de la finance et des opérations sont rassemblés, vérifiés et commentés en clair avant votre réunion de direction.
Gestion des stocks
L'équipe suit les ventes et les stocks, prévoit les ruptures et prépare des propositions de commande que vous validez.
Achats et devis fournisseurs
Les demandes de prix partent aux fournisseurs, les devis sont comparés ligne par ligne et l'acheteur décide avec l'historique sous les yeux.
Logistique et livraisons
Les livraisons du jour sont organisées en tournées, les chauffeurs suivis sur WhatsApp et les clients prévenus avant de s'inquiéter.
Questions sur l’API Todoist
L'API Todoist est-elle gratuite ?
En règle générale, oui : l'API est disponible sans facturation à l'appel ; certaines fonctions dépendent de l'offre du compte.
Faut-il programmer pour utiliser l'API Todoist avec iTeam ?
Pas nécessairement. Todoist figure dans le catalogue d'apps, et l'équipe de déploiement configure les flux.
Peut-on créer une tâche en langage naturel ?
Oui, l'API accepte des échéances écrites en langage naturel, et l'agent interprète la demande avant de créer la tâche.
