API publique des tâches : intégrer et gérer vos tâches dans les Instances digitalisées (BP)

L'API publique des tâches permet de relier vos tâches des Instances digitalisées (BP) à d'autres outils, comme Microsoft Planner ou Power Automate. Une API (interface de programmation) est un moyen sécurisé pour deux logiciels d'échanger des données. Grâce à elle, vous automatisez les tâches répétitives et gardez vos tâches synchronisées entre vos outils.

✋ Qui peut faire quoi

• Les utilisateurs autorisés à générer un token API personnel peuvent créer un token, connecter un outil externe et créer, consulter, modifier ou supprimer des tâches via l'API.
• Les administrateurs peuvent vous aider pour les droits et la configuration. Si vous n'êtes pas sûr d'avoir les droits nécessaires, contactez votre administrateur.

❓ Que pouvez-vous faire avec l'API publique des tâches ?

• Créer des tâches automatiquement.
• Récupérer et suivre toutes vos tâches.
• Modifier le statut des tâches.
• Supprimer les tâches dont vous n'avez plus besoin.

Quelques exemples :

• Créer automatiquement une tâche à partir d'une décision de réunion.
• Synchroniser vos tâches avec Microsoft Planner.
• Lancer un processus automatique lorsqu'une tâche est terminée.

✅ Avant de commencer

• Vous avez accès aux Instances digitalisées.
• Vous êtes autorisé à générer un token API personnel.
• Vous disposez d'un outil capable d'appeler des API, par exemple Power Automate, Postman ou un système interne.

✍ Utilisateurs autorisés à générer un token : configurer la connexion

Étape 1 : générer votre token API

Un token API est une clé secrète qui prouve que l'outil externe a le droit d'agir en votre nom.

1. Allez dans vos paramètres utilisateur.
2. Générez un token API personnel.
3. Copiez le token et conservez-le en lieu sûr.

Le token fonctionne comme un mot de passe. Ne le partagez jamais publiquement.

Étape 2 : connecter votre outil externe

1. Dans votre outil externe (par exemple Power Automate ou Planner), utilisez votre token API pour vous authentifier.
2. Configurez les appels API vers les points de terminaison DiliTrust. Un point de terminaison est l'adresse web que l'outil appelle pour effectuer une action.
3. Si besoin, testez la connexion avec un outil comme Postman.

Étape 3 : gérer vos tâches via l'API

• Récupérer les tâches : obtenez la liste de vos tâches et leur statut (À faire, Terminée, En retard).
• Créer des tâches : ajoutez des tâches depuis votre outil externe, avec des informations comme le titre, l'échéance et la personne assignée.
• Modifier des tâches : changez le statut ou les informations d'une tâche pour garder vos outils synchronisés.
• Supprimer des tâches : retirez les tâches qui ne sont plus utiles.

⭐ Conseils

• Testez d'abord vos appels API dans un environnement de test (sandbox ou préproduction).
• Protégez votre token API et remplacez-le régulièrement.
• Utilisez des outils d'automatisation comme Power Automate pour gagner du temps.
• Vérifiez régulièrement vos intégrations pour garantir la cohérence des données.
• Commencez simplement, testez votre configuration, puis automatisez étape par étape.

⛔ Limites

• Certains champs, comme les valeurs de statut, peuvent ne pas être strictement contrôlés par l'API. Vérifiez toujours vos données avant de les envoyer.
• L'accès repose actuellement sur un token.
• Ce que vous pouvez faire via l'API peut dépendre de vos droits et de votre configuration.

❓ FAQ

Puis-je partager mon token API avec un collègue ?

Non. Le token fonctionne comme un mot de passe. Chaque utilisateur doit utiliser son propre token personnel.

Quels outils puis-je connecter ?

Tout outil capable d'appeler des API, par exemple Power Automate, Microsoft Planner, Postman ou un système interne.

Je n'arrive pas à générer de token. Que faire ?

Contactez votre administrateur pour vérifier vos droits.