Aller au contenu principal

Asana

Disponible

Cette intégration est active et prête à l'emploi dans Frihet.

Connectez votre espace de travail Asana à Frihet. Consultez les projets et les tâches directement depuis votre ERP pour avoir une visibilité sur le travail effectué au moment de la facturation.

À quoi ça sert ?​

Avec Asana intégré :

  • Voir les projets — Consultez tous vos projets Asana depuis Frihet
  • Voir les tâches — Naviguez dans les tâches de chaque projet avec leur statut
  • Contexte de facturation — Revoyez les tâches terminées avant de créer des factures
  • Détection automatique de l'espace de travail — Frihet détecte automatiquement votre espace de travail principal

Prérequis​

  • Compte Asana actif — asana.com
  • Jeton d'accès personnel — Généré depuis les paramètres Asana
  • Frihet Pro ou supérieur

Connecter Asana à Frihet​

Étape 1 : Obtenir votre jeton d'accès personnel​

  1. Accédez à app.asana.com/0/developer-console
  2. Connectez-vous avec votre compte Asana
  3. Dans la section Personal access tokens, cliquez sur Create new token
  4. Donnez-lui un nom (ex : "Frihet ERP")
  5. Acceptez les conditions d'utilisation de l'API
  6. Copiez le jeton généré
Gardez le jeton

Le jeton d'accès personnel n'est affiché qu'une seule fois. Copiez-le avant de fermer la fenêtre.

Étape 2 : Configurer dans Frihet​

  1. Accédez à Paramètres → Intégrations
  2. Recherchez Asana
  3. Cliquez sur Connecter
  4. Collez votre Jeton d'accès personnel
  5. Cliquez sur Vérifier la connexion
  6. Frihet détectera automatiquement votre premier espace de travail

Étape 3 : Vérifier la connexion​

Si la connexion est correcte, Frihet affichera :

  • Nom de votre espace de travail dans Asana
  • Nombre de projets accessibles
  • Votre nom d'utilisateur dans Asana

Comment ça marche​

Frihet utilise l'API REST v1 d'Asana avec authentification Bearer :

  1. Vous fournissez votre jeton d'accès personnel
  2. Frihet envoie le jeton dans l'en-tête Authorization: Bearer <token>
  3. Lors de la connexion, Frihet consulte vos espaces de travail et sélectionne automatiquement le premier
  4. Les projets et les tâches sont consultés à la demande
  5. Le jeton est stocké chiffré (AES-256-GCM) dans Frihet

Données synchronisées​

DonnéeDirectionFréquence
ProjetsAsana → FrihetÀ la demande
TâchesAsana → FrihetÀ la demande
Statut des tâchesAsana → FrihetÀ chaque consultation
AttribuésAsana → FrihetÀ chaque consultation

Cas d'utilisation​

Consultant qui facture par projet​

Vous gérez les livrables de chaque client dans Asana. Avant de facturer, vous consultez depuis Frihet les tâches terminées du projet pour inclure le détail correct dans la facture.

Agence créative avec sprints​

Votre équipe travaille en sprints organisés dans les projets Asana. À la fin de chaque sprint, vous consultez les tâches terminées depuis Frihet et générez les factures correspondantes.

Vérifier la portée avant de facturer​

Vous avez un projet avec une portée définie dans Asana. Avant d'émettre la facture finale, vous vérifiez depuis Frihet que toutes les tâches de la portée sont marquées comme terminées.

Fonctionnalités​

Voir les projets​

  1. Depuis Frihet, accédez à la section Asana
  2. Vous verrez tous les projets de votre espace de travail
  3. Chaque projet affiche le nom, le statut et le nombre de tâches

Voir les tâches d'un projet​

  1. Sélectionnez un projet
  2. Frihet affiche les tâches avec :
    • Nom de la tâche
    • Statut (terminée / en attente)
    • Personne assignée
    • Date d'échéance
  3. Filtrez par statut pour ne voir que les tâches terminées

Détection automatique de l'espace de travail​

Lors de la connexion, Frihet détecte automatiquement votre premier espace de travail. Si vous avez plusieurs espaces de travail dans Asana, le principal est utilisé. Vous n'avez pas besoin de configurer quoi que ce soit de plus.

Gestion des erreurs​

Tous les appels à l'API Asana ont un délai d'expiration de 30 secondes. Si une requête échoue, Frihet enregistre automatiquement l'erreur pour diagnostic. Vérifiez votre connexion internet si les consultations échouent à plusieurs reprises.

Dépannage​

"Erreur d'authentification"​

  • Vérifiez que le jeton d'accès personnel est correct
  • Vérifiez qu'il n'a pas été révoqué dans la console développeur d'Asana
  • Si vous avez régénéré le jeton, mettez-le à jour dans Frihet

"Je ne vois pas mes projets"​

  • Frihet utilise le premier espace de travail de votre compte. Si vous en avez plusieurs, celui que vous souhaitez peut se trouver dans un autre
  • Vérifiez que vous avez accès aux projets depuis votre compte Asana
  • Les projets privés d'autres utilisateurs ne seront pas visibles

"Les tâches ne sont pas mises à jour"​

  • Les consultations sont en temps réel (à la demande)
  • Rechargez la vue dans Frihet pour voir les changements récents
  • Vérifiez que les tâches sont bien assignées au projet correct dans Asana

"Je veux utiliser un autre espace de travail"​

  • Actuellement, Frihet détecte automatiquement le premier espace de travail
  • Si vous devez changer, déconnectez et reconnectez l'intégration
  • L'espace de travail sélectionné dépend de l'ordre retourné par l'API Asana

"Je veux me déconnecter"​

  1. Accédez à Paramètres → Intégrations → Asana
  2. Cliquez sur Déconnecter
  3. Optionnellement, révoquez le jeton dans app.asana.com/0/developer-console

Prochaines étapes​