Connecter Asana

À quoi sert cette connexion ?

Asana permet à ELChat de retrouver des tâches, en créer, les mettre à jour, les terminer et y ajouter des commentaires.

Ce dont vous avez besoin

Identifiant	Rôle	Obligatoire
Jeton d’accès personnel	Autorise ELChat avec les droits de votre utilisateur Asana	Oui
ID du workspace (`workspace_gid`)	Définit l’espace dans lequel rechercher	Oui
ID du projet (`project_gid`)	Définit le projet par défaut pour lister et créer les tâches	Obligatoire dans le formulaire actuel

Un jeton personnel agit avec les mêmes droits que son propriétaire et reste valide jusqu’à sa révocation. Asana le recommande pour un usage personnel ou interne ; une application destinée à plusieurs utilisateurs devrait normalement employer OAuth. Voir la documentation officielle des jetons personnels Asana.

Étape 1 — Créer le jeton

Connectez-vous à Asana avec l’utilisateur qui peut accéder au projet.
Ouvrez la Console développeur Asana.
Sélectionnez Personal access tokens.
Créez un nouveau jeton nommé ELChat.
Copiez immédiatement le jeton et conservez-le dans un endroit sûr.

Étape 2 — Trouver les IDs

L’ID d’un projet est le nombre présent dans l’URL lorsque vous ouvrez ce projet : https://app.asana.com/0/PROJECT_GID/....
Le workspace GID est l’identifiant numérique de l’espace auquel appartient le projet.

Information à compléter : Asana n’affiche pas toujours le workspace GID directement dans l’interface standard. Si vous ne le connaissez pas, demandez-le à l’administrateur Asana ou récupérez-le via l’explorateur API officiel avec le jeton. Ne copiez pas l’ID d’une tâche à la place.

Étape 3 — Connecter Asana à ELChat

Ouvrez Dashboard > votre site > Actions IA > Connecteurs.
Cliquez sur Connecter sur la carte Asana.
Collez le jeton personnel.
Renseignez l’ID du workspace.
Renseignez l’ID du projet par défaut si vous voulez lister et créer des tâches dans ce projet.
Validez.

Vérifier la connexion

Demandez à ELChat de lister les tâches du projet configuré ou de rechercher une tâche test connue. Comparez le nom, l’échéance et l’état dans Asana.

Capacités disponibles

Capacité réelle	Type
Lister les tâches du projet par défaut	Lecture
Rechercher une tâche dans le workspace	Lecture
Créer une tâche	Écriture
Modifier une tâche	Écriture
Marquer une tâche comme terminée	Écriture
Ajouter un commentaire	Écriture

Le moteur peut techniquement fonctionner sans projet pour certaines recherches, mais le formulaire actuel exige cet ID. Sans projet par défaut, la liste et la création dans ce projet échouent. Sans workspace, la recherche globale échoue.

Reconnecter, déconnecter et dépanner

Pour remplacer le jeton, créez-en un nouveau, reconnectez et testez avant de révoquer l’ancien dans la Console développeur. Désactiver arrête ELChat, mais seule la révocation Asana invalide réellement le jeton.

Projet non configuré : renseignez le project_gid correct.
Workspace non configuré : renseignez le workspace_gid de l’espace contenant le projet.
Tâche introuvable : vérifiez que l’utilisateur du jeton a accès au projet et que la tâche n’est pas dans un autre workspace.
Accès refusé : corrigez les droits du membre Asana ; le jeton ne contourne pas les permissions utilisateur.

Sécurité et limites

Utilisez un compte dédié si possible. Le connecteur ne gère pas les portfolios, objectifs, formulaires, règles ou pièces jointes. Les limites de l’API Asana s’appliquent.