Passa al contenuto principale

Asana

Disponibile

Questa integrazione è attiva e pronta all'uso in Frihet.

Collega il tuo workspace di Asana a Frihet. Consulta progetti e attività direttamente dal tuo ERP per avere visibilità del lavoro svolto al momento della fatturazione.

A cosa serve?​

Con Asana integrato:

  • Vedere progetti — Consulta tutti i tuoi progetti Asana da Frihet
  • Vedere attività — Naviga le attività di ogni progetto con il loro stato
  • Contesto alla fatturazione — Rivedi le attività completate prima di creare fatture
  • Rilevamento automatico del workspace — Frihet rileva automaticamente il tuo workspace principale

Requisiti​

  • Account Asana attivo — asana.com
  • Personal Access Token — Si genera dalle impostazioni di Asana
  • Frihet Pro o superiore

Collegare Asana con Frihet​

Passaggio 1: Ottenere il tuo Personal Access Token​

  1. Vai su app.asana.com/0/developer-console
  2. Accedi con il tuo account Asana
  3. Nella sezione Personal access tokens, clicca su Create new token
  4. Assegna un nome (es: "Frihet ERP")
  5. Accetta i termini dell'API
  6. Copia il token generato
Salva il token

Il Personal Access Token viene mostrato solo una volta. Copialo prima di chiudere la finestra.

Passaggio 2: Configurare in Frihet​

  1. Vai su Impostazioni → Integrazioni
  2. Cerca Asana
  3. Clicca su Collega
  4. Incolla il tuo Personal Access Token
  5. Clicca su Verifica connessione
  6. Frihet rileverà automaticamente il tuo primo workspace

Passaggio 3: Verificare la connessione​

Se la connessione è corretta, Frihet mostrerà:

  • Nome del tuo workspace in Asana
  • Numero di progetti accessibili
  • Il tuo nome utente in Asana

Come funziona​

Frihet utilizza l'API REST v1 di Asana con Bearer authentication:

  1. Fornisci il tuo Personal Access Token
  2. Frihet invia il token nell'header Authorization: Bearer <token>
  3. Al momento della connessione, Frihet consulta i tuoi workspace e seleziona il primo automaticamente
  4. Progetti e attività vengono consultati su richiesta
  5. Il token viene archiviato crittografato (AES-256-GCM) in Frihet

Dati sincronizzati​

DatoDirezioneFrequenza
ProgettiAsana → FrihetSu richiesta
AttivitàAsana → FrihetSu richiesta
Stato delle attivitàAsana → FrihetCon ogni query
AssegnatariAsana → FrihetCon ogni query

Casi d'uso​

Consulente che fattura per progetto​

Gestisci i deliverable di ogni cliente in Asana. Prima di fatturare, consulti da Frihet le attività completate del progetto per includere il riepilogo corretto nella fattura.

Agenzia creativa con sprint​

Il tuo team lavora in sprint organizzati in progetti Asana. Alla fine di ogni sprint, consulti le attività completate da Frihet e generi le fatture corrispondenti.

Verificare l'ambito prima di fatturare​

Hai un progetto con ambito definito in Asana. Prima di emettere la fattura finale, verifichi da Frihet che tutte le attività dell'ambito siano contrassegnate come completate.

Funzionalità​

Vedere progetti​

  1. Da Frihet, accedi alla sezione Asana
  2. Vedrai tutti i progetti del tuo workspace
  3. Ogni progetto mostra nome, stato e numero di attività

Vedere attività di un progetto​

  1. Seleziona un progetto
  2. Frihet mostra le attività con:
    • Nome dell'attività
    • Stato (completata / in sospeso)
    • Persona assegnata
    • Data di scadenza
  3. Filtra per stato per vedere solo quelle completate

Rilevamento automatico del workspace​

Al momento della connessione, Frihet rileva automaticamente il tuo primo workspace. Se hai più workspace in Asana, viene utilizzato quello principale. Non è necessario configurare nulla di aggiuntivo.

Gestione degli errori​

Tutte le chiamate all'API di Asana hanno un timeout di 30 secondi. Se una richiesta fallisce, Frihet registra automaticamente l'errore per la diagnostica. Verifica la tua connessione a Internet se le query falliscono ripetutamente.

Risoluzione dei problemi​

"Errore di autenticazione"​

  • Verifica che il Personal Access Token sia corretto
  • Controlla che non sia stato revocato nella console per sviluppatori di Asana
  • Se hai rigenerato il token, aggiornalo in Frihet

"Non vedo i miei progetti"​

  • Frihet utilizza il primo workspace del tuo account. Se ne hai diversi, quello che desideri potrebbe essere in un altro
  • Verifica di avere accesso ai progetti dal tuo account Asana
  • I progetti privati di altri utenti non saranno visibili

"Le attività non si aggiornano"​

  • Le query sono in tempo reale (su richiesta)
  • Ricarica la vista in Frihet per vedere i cambiamenti recenti
  • Verifica che le attività siano assegnate al progetto corretto in Asana

"Voglio usare un altro workspace"​

  • Attualmente, Frihet rileva automaticamente il primo workspace
  • Se devi cambiare, disconnetti e riconnetti l'integrazione
  • Il workspace selezionato dipende dall'ordine restituito dall'API di Asana

"Voglio disconnettere"​

  1. Vai su Impostazioni → Integrazioni → Asana
  2. Clicca su Disconnetti
  3. Opzionalmente, revoca il token su app.asana.com/0/developer-console

Prossimi passi​