Trello
Questa integrazione è attiva e pronta all'uso in Frihet.
Collega le tue bacheche Trello a Frihet. Consulta bacheche, liste e schede direttamente dal tuo ERP per avere il contesto del progetto al momento della fatturazione.
A cosa serve?
Con Trello integrato:
- Visualizzare le bacheche — Consulta tutte le tue bacheche Trello da Frihet
- Visualizzare liste e schede — Naviga la struttura dei tuoi progetti
- Contesto al momento della fatturazione — Consulta le attività completate prima di creare una fattura
- Visibilità centralizzata — Senza cambiare applicazione
Requisiti
- Account Trello attivo — trello.com
- Chiave API di Trello — Si ottiene dal portale sviluppatori
- Token di autorizzazione — Viene generato autorizzando la tua applicazione
- Frihet Pro o superiore
Collegare Trello con Frihet
Passo 1: Ottenere la tua Chiave API
- Vai su trello.com/power-ups/admin
- Accedi al tuo account Trello
- Clicca su New per creare un nuovo Power-Up o integrazione
- Compila i campi:
- Name: "Frihet ERP"
- Workspace: Seleziona il tuo workspace
- Una volta creato, vai alla scheda API Key
- Copia la tua API Key
Passo 2: Generare un Token
- Nella stessa pagina, accanto alla Chiave API, clicca sul link Token
- Si aprirà una pagina di autorizzazione di Trello
- Controlla i permessi richiesti e clicca su Allow
- Copia il Token generato
Hai bisogno di entrambe: la Chiave API e il Token. Copiale prima di continuare.
Passo 3: Configurare in Frihet
- Vai su Impostazioni → Integrazioni
- Cerca Trello
- Clicca su Connetti
- Inserisci la tua Chiave API
- Inserisci il tuo Token
- Clicca su Verifica connessione
- Se la connessione è avvenuta con successo, vedrai le tue bacheche elencate
Come funziona
Frihet utilizza l'API REST di Trello con autenticazione tramite parametri di query:
- Fornisci Chiave API e Token
- Frihet aggiunge entrambi come parametri di query in ogni richiesta:
?key=<api-key>&token=<token> - Le bacheche, liste e schede vengono consultate su richiesta
- Entrambe le credenziali vengono memorizzate cifrate (AES-256-GCM) in Frihet
Dati sincronizzati
| Dato | Direzione | Frequenza |
|---|---|---|
| Bacheche | Trello → Frihet | Su richiesta |
| Liste | Trello → Frihet | Su richiesta |
| Schede | Trello → Frihet | Su richiesta |
| Membri | Trello → Frihet | Ad ogni consultazione |
Casi d'uso
Freelance che gestisce progetti in Trello
Hai una bacheca per cliente con colonne come "Da fare", "In corso" e "Completato". Prima di fatturare, consulti le schede completate da Frihet per verificare quale lavoro includere.
Agenzia con bacheche cliente
Il tuo team lavora con bacheche condivise per cliente. Da Frihet puoi vedere lo stato di ogni bacheca per sapere quando un progetto è pronto per essere fatturato.
Verificare i deliverable prima di fatturare
Prima di emettere una fattura per un progetto, consulti da Frihet le schede della bacheca corrispondente in Trello. Confermi che tutti i deliverable sono stati completati.
Funzionalità
Visualizzare le bacheche
- Da Frihet, accedi alla sezione di Trello
- Vedrai tutte le bacheche a cui il tuo account ha accesso
- Seleziona una bacheca per vedere le sue liste e schede
Visualizzare liste e schede
- Seleziona una bacheca
- Frihet mostra le liste (colonne) con le rispettive schede
- Ogni scheda mostra titolo, membri assegnati ed etichette
Navigare le schede
- Clicca su una scheda per vedere maggiori dettagli
- Visualizza la descrizione, la checklist, i commenti e gli allegati
- Usa queste informazioni come riferimento al momento della creazione delle fatture
Limiti API
Frihet implementa un throttling automatico (100ms tra le richieste) per rispettare i limiti dell'API di Trello. Le query su bacheche grandi potrebbero richiedere qualche secondo in più.
Risoluzione dei problemi
"Errore di autenticazione"
- Verifica che la Chiave API e il Token siano corretti
- Il Token deve corrispondere allo stesso account della Chiave API
- Se hai revocato il Token, generane uno nuovo e aggiornalo in Frihet
"Non vedo tutte le mie bacheche"
- Verifica che il tuo account abbia accesso a quelle bacheche in Trello
- Le bacheche private di altri membri non saranno visibili
- Se sei invitato a una bacheca, l'accesso dipende dai permessi della bacheca
"Il Token è scaduto"
- I token di Trello non scadono per impostazione predefinita a meno che tu non li configuri in tal modo
- Se il token è stato revocato manualmente, generane uno nuovo
- Vai su trello.com/power-ups/admin per gestire i token
"Voglio disconnettermi"
- Vai su Impostazioni → Integrazioni → Trello
- Clicca su Disconnetti
- Opzionalmente, revoca il Token da Trello in Settings → Applications