Guida alle integrazioni, passo dopo passo

Per chi clicca su Collega nella pagina Integrazioni e vuole sapere che cosa tenere a portata di mano e dove trovare ogni informazione. Le schermate dei fornitori cambiano: se il nome di un menu è diverso, cerca il nome dell'opzione nella ricerca della pagina del fornitore.

• Prima di iniziare
• Come trattiamo i tuoi segreti
• Messaggi: Telegram e WhatsApp
• E-mail automatica
• Riunioni: Zoom, Meet e Teams
• Cloud: Drive, Dropbox, OneDrive e S3
• Documenti: Google Documenti, Fogli, Presentazioni, Word, Excel e PowerPoint
• Progetti: Trello, Jira, Linear, Asana, ClickUp, monday.com e Azure DevOps
• Chiavi IA
• Accessi salvati
• Quando qualcosa non funziona e riepilogo

Come leggere il pulsante e l'etichetta di ogni riga

Quando il collegamento riesce, la pagina mostra "collegato" e TranscritorAi ti invia un'e-mail per avvisarti della modifica. Se quell'e-mail arriva senza che tu abbia fatto nulla, scollega e cambia la password del tuo account.

Due modi per collegare

1. Accesso sul sito del fornitore (OAuth): Google Drive, Dropbox, OneDrive, Zoom, Google Meet, Teams, Trello, Jira, Asana, ClickUp, monday.com, Azure DevOps e Linear. Si apre una finestra del fornitore, accedi e accetti. La tua password non passa mai da TranscritorAi e non c'è nulla da copiare e incollare.
2. Incollare una chiave o una password per app: token del bot di Telegram, e-mail via POP3, Amazon S3, chiavi IA, bot per riunioni e app proprie. Questa guida spiega dove generare ciascuna.

Regole valide per tutto

• Pop-up bloccato? L'accesso al fornitore si apre in una finestra a parte. Se il browser la blocca, la pagina prosegue nella stessa scheda. Consenti i pop-up per il sito di TranscritorAi e clicca di nuovo.
• I segreti compaiono una sola volta. Copia subito la chiave. Se la perdi, creane un'altra presso il fornitore e registrala di nuovo.
• Non inviare mai chiavi o password per e-mail, WhatsApp o chat di assistenza. L'unico posto dove incollarle è il campo del popup, nella pagina Integrazioni.
• Il costo è del fornitore, addebitato direttamente a te. Chiavi IA, bot per riunioni e app Microsoft propria sono fatturati dal fornitore sul tuo conto. TranscritorAi non partecipa a quel pagamento.
• Puoi scollegare quando vuoi. Scollegare cancella la credenziale dal nostro lato. Ciò che è già stato creato nel tuo cloud, nelle tue attività o nei tuoi file resta lì. Per revocare del tutto, rimuovi l'accesso anche presso il fornitore (ogni sezione dice dove).
• Devi aver effettuato l'accesso a TranscritorAi. Senza accesso, la pagina mostra solo il pulsante Accedi.

Che cosa non conserviamo mai

• La password del tuo accesso a Google, Dropbox, OneDrive, Zoom, Microsoft, Trello, Jira, Asana, ClickUp, monday.com, Azure DevOps, Linear o Meta. L'accesso avviene sul sito del fornitore. TranscritorAi riceve solo un token di accesso, che puoi revocare quando vuoi.
• La password del tuo account TranscritorAi in forma leggibile. Diventa un hash, una "impronta" da cui non si può recuperare la password originale. Quando il pannello chiede "La tua password, per confermare", viene solo verificata, mai copiata.
• Una password di posta nel percorso di inoltro (Hotmail, Outlook, iCloud o qualsiasi altro): quel percorso non usa alcuna password.
• Nessun segreto torna sullo schermo. Una volta salvati, chiave, token o password non vengono più mostrati. Il pannello mostra al massimo la fine della chiave, come "termina con 3f9a".
• Il testo grezzo del fornitore negli errori. I messaggi di errore che vedi sono testi nostri.

Che cosa conserviamo, sempre cifrato

Ogni voce qui sotto viene scritta nel database già cifrata (Fernet: AES con verifica di integrità, libreria cryptography), con chiavi di cifratura separate per ogni tipo di integrazione. Se il server non ha la chiave di un tipo, quell'integrazione resta del tutto disattivata, invece di conservare il segreto senza cifratura.

Quando scolleghi o elimini: la credenziale viene cancellata dal nostro lato. Ciò che è già stato creato (file nel tuo cloud, attività, trascrizioni) resta tuo. Eliminare qui non revoca l'accesso presso il fornitore: per questo usa la riga "Revoca del tutto" di ogni sezione.

Che cosa protegge la cifratura e che cosa no

Protegge il contenuto del database e dei backup: chi copiasse solo il file del database non leggerebbe nessun segreto. Nessuna cifratura protegge da chi entra nel server stesso, dove stanno le chiavi. Per questo conviene anche:

• Dare alle chiavi il minor potere possibile: la policy minima di S3, l'accesso di sola lettura sulle piattaforme di progetti, un limite di spesa sulle chiavi IA.
• In caso di sospetta fuga, revocare prima presso il fornitore e solo dopo cancellare qui.
• Non incollare mai segreti in e-mail, chat di assistenza o fuori dai campi del popup in Integrazioni.

Telegram (bot tuo), circa 3 minuti

Tieni a portata di mano: Telegram e la password del tuo account TranscritorAi (più il codice della verifica in due passaggi, se la usi).

1. In Telegram cerca @BotFather (il bot ufficiale, con la spunta blu di verifica).
2. Invia /newbot.
3. Ti chiede il nome del bot (va bene qualsiasi) e poi il nome utente, che deve finire con bot, per esempio mio_trascrittore_bot.
4. BotFather risponde con il token, qualcosa come 123456789:AAH.... Copialo. Quel token è la password del bot: non condividerlo. Viene conservato cifrato e non viene mai mostrato di nuovo.
5. In TranscritorAi: Integrazioni, Messaggi, Telegram, Collega.
6. Incolla il token in Token del bot, digita la tua password per confermare (e il codice della verifica in due passaggi, se richiesto) e clicca su Collega.
7. Compare un codice di abbinamento, valido 10 minuti e utilizzabile una sola volta. Clicca su Apri il bot in Telegram e tocca Avvia, oppure invia il codice al bot.
8. Lo stato diventa Pronto all'uso. Invia o inoltra audio, video, file o link al bot e la trascrizione torna nella stessa conversazione.

• Comandi del bot: /status, /creditos, /cancelar, /desconectar.
• Limite: Telegram accetta file fino a 20 MB. Quelli più grandi li invii dal sito.
• Codice scaduto? Clicca su Genera un altro codice.
• "Impossibile collegare": il token è stato incollato con uno spazio o manca un pezzo, oppure è di un bot eliminato. Creane uno nuovo con /token in BotFather.
• Revocare del tutto: in BotFather, /revoke (crea un altro token e invalida il vecchio) oppure /deletebot.

WhatsApp (account WhatsApp Business), circa 5 minuti

Tieni a portata di mano: un numero WhatsApp Business (un numero dedicato, oppure l'app WhatsApp Business; il WhatsApp normale non va bene), un account Facebook e la password di TranscritorAi.

1. Integrazioni, Messaggi, WhatsApp, Collega.
2. Digita la password di TranscritorAi e clicca su Collega con Meta.
3. Nella finestra di Meta accedi con Facebook, scegli o crea l'account WhatsApp Business, scegli il numero (o registralo e verificalo via SMS o chiamata) e accetta i permessi.
4. Tornato sul sito compare un codice. Dal tuo WhatsApp personale invia quel codice al numero collegato (il pulsante Apri WhatsApp apre già la conversazione).
5. Fatto: invia o inoltra audio, video, file o link al numero e la trascrizione torna nella stessa conversazione.

• Le risposte entro 24 ore dal tuo ultimo messaggio non hanno costo di messaggio presso Meta.
• "WhatsApp non è ancora stato abilitato su questo server": il pulsante compare, ma la parte di TranscritorAi con Meta non è ancora completata. Non è un tuo errore. Nel frattempo usa Telegram.
• Revocare del tutto: nelle impostazioni di Facebook, in Integrazioni aziendali, rimuovi TranscritorAi.

Fa entrare da sole nella coda di trascrizione il testo, gli allegati e (se vuoi) i link delle tue e-mail, con gli stessi crediti di un invio dal sito. Prima di tutto, conferma l'e-mail del tuo account TranscritorAi (la pagina avvisa se manca). Se compare "non incluso nel tuo piano", la funzione non è abilitata per il tuo piano.

Hotmail, Outlook e Live accedono tramite Microsoft, senza salvare la password, e Apple iCloud si collega via IMAP con una password per app. L'inoltro vale per qualsiasi provider.

Percorso A: inoltrare (qualsiasi provider)

Funziona con qualsiasi provider e non salva né password né autorizzazione. È la scelta per chi non vuole consegnare l'accesso alla casella, e l'unica per un provider senza POP3, IMAP né accesso Microsoft.

1. Integrazioni, E-mail, (il tuo fornitore), Collega. Il pannello mostra l'indirizzo di TranscritorAi a cui inoltrare. Usa Copia indirizzo.
2. Autorizza il tuo indirizzo di origine. Sono accettate solo e-mail da un indirizzo verificato, e l'e-mail del tuo account vale già. Per un altro, digitalo in Un altro tuo indirizzo, clicca su Invia codice, apri l'e-mail arrivata a quell'indirizzo e digita le 6 cifre in Conferma.
3. Configura l'inoltro nella tua posta. In Hotmail/Outlook (Outlook sul web): Impostazioni, Posta, Inoltro, attivalo e incolla l'indirizzo copiato, oppure crea una regola che inoltra solo ciò che scegli. In iCloud: iCloud.com, Mail, ingranaggio, Impostazioni, Generali, attiva l'inoltro verso l'indirizzo copiato.
4. Scegli le opzioni e salva: trascrivere il testo dell'e-mail, gli allegati, seguire i link, nascondere i dati personali (LGPD).
5. Prova: invia a te stesso un'e-mail con un audio allegato. Il risultato compare in Cronologia.

Suggerimento: crea la regola di inoltro solo per un mittente o una cartella, altrimenti ogni e-mail della casella consuma crediti.

Percorso B: collegare la casella via POP3

Server e porta si compilano quando scegli il fornitore. Il login è sempre l'indirizzo e-mail completo. La password è una password per app, mai la password normale. Viene conservata cifrata, non viene mai mostrata di nuovo e viene cancellata quando scolleghi la casella. Poiché apre la posta solo via POP3 (non accede al tuo account), puoi revocarla in qualsiasi momento senza cambiare la password principale.

Hotmail, Outlook e Live: accesso con Microsoft

1. Hotmail, Outlook e Live non accettano la password via POP3. Per questo accedi con il tuo account Microsoft: TranscritorAi non vede mai la tua password e riceve solo il permesso di leggere la casella.
2. In Outlook sul web: Impostazioni > Posta > Sincronizza posta, e in POP e IMAP scegli «Sì» in «Consenti a dispositivi e app di usare POP». Salva.
3. Qui in TranscritorAi, digita la tua e-mail Hotmail, Outlook o Live e indica i mittenti consentiti e/o un'etichetta nell'oggetto (per esempio [trascrivere]).
4. Fai clic su Accedi con Microsoft, scegli l'account e accetta l'accesso in lettura alla casella. Al ritorno la casella risulta collegata. Per revocare, usa Scollega qui oppure rimuovi l'accesso su account.live.com/consent/Manage.

Apple iCloud: IMAP

1. iCloud Mail non offre POP3, ma accetta IMAP con una password specifica per app: TranscritorAi legge solo la posta in arrivo (imap.mail.me.com, porta 993) e non contrassegna né modifica nulla nelle tue e-mail.
2. Su account.apple.com > Accesso e sicurezza > Password specifiche per app (l'autenticazione a due fattori deve essere attiva), fai clic su + e chiamala TranscritorAi. Copia la password generata (formato xxxx-xxxx-xxxx-xxxx): compare una sola volta.
3. Qui in TranscritorAi scegli Apple iCloud, digita il tuo indirizzo iCloud completo (nome@icloud.com, @me.com o @mac.com) e incolla la password per app. Server e porta sono già compilati.
4. Indica i mittenti consentiti e/o un'etichetta nell'oggetto (per esempio [trascrivere]), fai clic su Verifica connessione e poi su Collega.

Gmail

1. Su myaccount.google.com apri Sicurezza e attiva la verifica in due passaggi (necessaria per creare una password per app).
2. Sempre in Sicurezza, cerca "Password per le app" (oppure vai su myaccount.google.com/apppasswords). Dagli un nome, per esempio "TranscritorAi", e clicca su Crea. Copia le 16 lettere, senza spazi. Compaiono una sola volta.
3. In Gmail: ingranaggio, Visualizza tutte le impostazioni, scheda Inoltro e POP/IMAP. In Scaricamento POP scegli di abilitare il POP per tutti i messaggi (o solo per quelli in arrivo da ora) e salva.
4. In TranscritorAi: Integrazioni, E-mail, Gmail, Collega. Compila l'e-mail (login) e la password per app.

Yahoo Mail

1. Su login.yahoo.com/account/security attiva la verifica in due passaggi, se non lo è già.
2. Nella stessa pagina genera una password per app ("Altra app"), dagli un nome e copiala.
3. Collega in TranscritorAi con il server pop.mail.yahoo.com.

Zoho Mail

1. In Zoho Mail, in Impostazioni, Account di posta, Accesso POP, attiva il POP.
2. Se usi l'autenticazione a due fattori, su accounts.zoho.com, Sicurezza, Password specifiche per app, genera una password e copiala.
3. Collega con il server pop.zoho.com. Gli account di altre regioni (come .eu o .in) usano il server POP della regione: controlla nel pannello di Zoho.

UOL, Hostinger e dominio proprio

1. Attiva il POP3 nelle impostazioni della posta (in UOL Mail o nel pannello dell'hosting del tuo dominio).
2. Usa server, porta e password indicati dal fornitore. In Hostinger il login è l'e-mail completa.
3. Se il fornitore non ha password per app, usa la password della casella. Quando possibile, crea una casella solo per questo.

Compilare il modulo (tutti i fornitori POP3)

1. Scegli il fornitore, dai un nome (facoltativo) e inserisci l'e-mail (login) e la password per app.
2. Filtro di sicurezza: per sicurezza leggiamo solo ciò che scegli. Indica i mittenti consentiti, separati da virgola (per esempio ana@esempio.com, @azienda.com), e/o un'etichetta nell'oggetto (per esempio [trascrivi]). "Accetta qualsiasi e-mail" esiste, ma consuma crediti per tutto ciò che arriva: evitalo.
3. Lascia attivo Ignora le e-mail già presenti nella casella (consigliato): la prima lettura registra soltanto ciò che c'è già.
4. "Elimina dalla casella ciò che è stato trascritto" è facoltativo. Lascialo disattivato se non sei sicuro.
5. Clicca su Prova la connessione e poi su Collega.
6. La lettura va da sola ogni pochi minuti. Leggi ora forza una lettura (pianificata entro 1 minuto).

• La prova fallisce: quasi sempre è la password normale al posto di quella per app, il POP disattivato presso il fornitore, o spazi nella password.
• Casella "in pausa per errore": il fornitore ha rifiutato l'accesso (password cambiata o revocata). Crea un'altra password per app e usa Correggi.
• Revocare del tutto: elimina la password per app nelle impostazioni di sicurezza del tuo account di posta.

Collega il tuo account Zoom, Google Meet o Microsoft Teams per ricevere la trascrizione generata dalla piattaforma stessa, senza registrare e senza inviare file. TranscritorAi legge soltanto e non entra mai nella chiamata. L'accesso avviene sul sito della piattaforma: TranscritorAi non vede né conserva la tua password, ma solo un token di accesso cifrato.

Procedura: Integrazioni, Riunioni, (piattaforma), Collega, accedi alla piattaforma nella finestra che si apre, accetta l'accesso e poi regola le regole.

Il punto principale: collegare non crea una trascrizione. La trascrizione deve esistere sulla piattaforma. Controlla i requisiti della tua prima di collegare.

Zoom

Serve: un piano Zoom a pagamento, con registrazione nel cloud e trascrizione audio attive.

1. Su zoom.us apri le impostazioni di Registrazione dell'organizzatore.
2. Attiva la registrazione nel cloud e l'opzione per creare la trascrizione audio.
3. Registra le riunioni nel cloud (automaticamente o a mano). Senza registrazione nel cloud non c'è trascrizione.
4. In TranscritorAi clicca su Collega e accetta l'accesso nella finestra di Zoom.

Revocare del tutto: Zoom Marketplace, Manage, Added Apps.

Google Meet

Serve: un'edizione a pagamento di Google Workspace che includa la trascrizione (per esempio Business Standard o superiore). Gli account personali @gmail.com di norma non generano trascrizioni.

1. Collega con l'account dell'organizzatore della riunione: la trascrizione resta a chi l'ha organizzata.
2. Nella riunione attiva la trascrizione (Attività, Trascrizioni), oppure chiedi all'amministratore di Workspace di attivarla di default.
3. Dopo la fine della riunione la trascrizione impiega qualche minuto. TranscritorAi la recupera da solo.
4. In TranscritorAi clicca su Collega, scegli l'account dell'organizzatore e accetta l'accesso in lettura alle riunioni.

• Avviso "app non verificata" di Google: finché la verifica dell'app non è completata, Google può mostrare un avviso. Procedi solo se la pagina è accounts.google.com e l'app è TranscritorAi.
• Revocare del tutto: myaccount.google.com/permissions, TranscritorAi, Rimuovi accesso.

Microsoft Teams

Serve: un account di lavoro o scuola di Microsoft 365 (un account personale Hotmail/Outlook non ha trascrizioni di Teams), con la trascrizione delle riunioni attiva. Di solito l'amministratore deve approvare l'accesso.

1. Chiedi all'amministratore di Microsoft 365 di consentire la trascrizione delle riunioni di Teams per il tuo account.
2. Nella riunione avvia la trascrizione (Altre azioni, Registra e trascrivi, Avvia trascrizione).
3. In TranscritorAi clicca su Collega e accedi con l'account dell'organizzazione. Se Microsoft chiede l'approvazione dell'amministratore, invia la richiesta e ricollega dopo.

App propria (facoltativa, ma può essere obbligatoria). Microsoft fa pagare l'uso dell'API di trascrizione. Se il pannello dice "Per collegare questa piattaforma, registra l'applicazione della tua organizzazione", o se preferisci che l'addebito vada sulla tua sottoscrizione Azure, registra un'app tua:

1. Su portal.azure.com apri Microsoft Entra ID, Registrazioni app, Nuova registrazione.
2. Nome: "TranscritorAi". Tipo di account: solo questa directory. Come URI di reindirizzamento, tipo Web, inserisci https://<indirizzo del sito>/api/reunioes/integracoes/teams/callback, sostituendo la parte tra i segni con il dominio di TranscritorAi, lo stesso che usi nel browser, senza barra finale. Registra.
3. Copia l'ID applicazione (client) e l'ID directory (tenant).
4. In Certificati e segreti crea un nuovo segreto client e copia subito il Valore (poi scompare).
5. In Autorizzazioni API aggiungi Microsoft Graph, autorizzazioni delegate: User.Read, OnlineMeetings.Read, OnlineMeetingTranscript.Read.All e offline_access. Poi un amministratore del tenant deve concedere il consenso.
6. In TranscritorAi, nel pannello di Teams, compila ID applicazione, segreto dell'applicazione e organizzazione (l'ID directory) e clicca su Salva applicazione. Solo allora clicca su Collega. Per tornare all'app di TranscritorAi usa Rimuovi applicazione.

L'addebito della trascrizione di Microsoft va sulla sottoscrizione Azure collegata all'app. Senza sottoscrizione un piccolo volume funziona in modalità di valutazione, poi Microsoft rifiuta. Revocare del tutto: su myapps.microsoft.com rimuovi il consenso (Microsoft non permette di revocare tramite API, quindi scollegare cancella solo il token dal nostro lato).

Dopo il collegamento: regole e calendario

• Acquisizione: solo quando lo chiedo, tutte le riunioni, o solo quelle con una parola nel titolo.
• Riepilogo e piano d'azione, nascondere i dati personali (LGPD) e avviso via e-mail quando è pronta sono facoltativi.
• Cerca riunioni ora elenca quelle degli ultimi 7 giorni. "Prossime riunioni" ti lascia scegliere una per una che cosa trascrivere.
• Avvisa i partecipanti che la riunione sarà trascritta. Sei tu il responsabile di avere l'autorizzazione.
• Alcune opzioni possono comportare un costo aggiuntivo addebitato sul saldo riunioni (per esempio Teams tramite l'app di TranscritorAi). In quel caso la pagina chiede il tuo consenso. Senza consenso e senza saldo, nulla viene trascritto. Il saldo si acquista in Piani.

Bot nella riunione (per le riunioni che la piattaforma non trascrive)

Un partecipante chiamato "TranscritorAi" entra nella chiamata e l'organizzatore deve ammetterlo. Il bot è di un fornitore esterno (oggi Recall.ai) e usa il suo account. La chiave del bot è conservata cifrata.

1. Crea un account su recall.ai e genera una chiave API nel pannello. Annota la regione dell'account (per esempio us-west-2, us-east-1, eu-central-1 o ap-northeast-1).
2. Nel blocco Bot nella riunione scegli il fornitore e la regione (la stessa del tuo account), incolla la chiave in "Chiave del tuo account" e clicca su Salva chiave.
3. Spunta il consenso all'addebito. L'addebito è del fornitore, direttamente a te.
4. Incolla il link della riunione (Zoom, Meet o Teams), spunta che hai avvisato i partecipanti e clicca su Invia il bot. Ammetti "TranscritorAi" nella riunione.

Limiti: al massimo 2 bot contemporaneamente e un tetto mensile per account. Senza chiave propria potrebbe essere possibile usare il bot a carico del saldo riunioni, se il server lo offre.

TranscritorAi salva i tuoi file e le trascrizioni in una cartella chiamata transcritorai nel tuo cloud, senza usare lo spazio del tuo piano. Scegli tu che cosa può fare:

Dopo il collegamento: Usa come destinazione stabilisce quale cloud riceve i nuovi file, Sposta i miei file nel cloud invia ciò che è ancora solo sul sito, e Importa dal cloud recupera file da trascrivere.

Google Drive, Dropbox e OneDrive (accesso presso il fornitore)

1. Integrazioni, Cloud, (fornitore), Collega.
2. Scegli il permesso e conferma.
3. Nella finestra del fornitore accedi, leggi i permessi e accetta. La cartella transcritorai viene creata da sola.

La tua password non passa mai da TranscritorAi: conserviamo solo il token, cifrato. Che cosa concede ogni fornitore:

• Google Drive: solo i file che TranscritorAi stesso crea. Per importare, scegli i file nel selettore di Google.
• Dropbox: in modalità solo salvare, accesso solo alla cartella Apps/transcritorai.
• OneDrive: in modalità solo salvare, solo la cartella dell'app (Apps). Importare, o usare la cartella nella radice, richiede l'accesso ai tuoi file. Gli account di lavoro o scuola possono richiedere l'approvazione dell'amministratore.
• Ampliare il permesso in seguito richiede di collegare di nuovo l'account (Ricollega).
• Revocare del tutto: Google su myaccount.google.com/permissions, Dropbox in Impostazioni, Sicurezza, App collegate, OneDrive su account.microsoft.com/privacy (o myapps.microsoft.com per gli account di lavoro).

Amazon S3 e servizi compatibili (AWS, Alibaba OSS, iDrive e2 e altri)

È l'unico che chiede chiavi, perché non ha un "accesso sul sito". Crea una chiave solo per TranscritorAi, con il permesso minimo. Non usare mai la chiave root di AWS. La chiave di accesso e il segreto vengono conservati cifrati e non vengono mai mostrati di nuovo.

Tieni a portata di mano: un account sul servizio e un bucket (la "cartella radice" dello spazio).

1. Crea il bucket, se non ce l'hai. Annota nome e regione (per esempio us-east-1 o sa-east-1).
2. In TranscritorAi: Integrazioni, Cloud, Amazon S3, Collega. Scegli il servizio e indica bucket, regione e permesso. Il popup mostra la policy di accesso minima generata per il tuo bucket: clicca su Copia.
3. In AWS: IAM, Utenti, Crea utente (per esempio transcritorai), senza accesso alla console. Apri l'utente, Autorizzazioni, Aggiungi autorizzazioni, Crea policy inline, scheda JSON, incolla la policy copiata e salva.
4. Sempre sull'utente: Credenziali di sicurezza, Crea chiave di accesso (caso d'uso "applicazione esterna ad AWS"). Copia Access Key ID e Secret Access Key. Il segreto compare solo adesso.
5. Tornato in TranscritorAi, incolla la chiave di accesso e il segreto e concludi con Collega.
6. Clicca su Verifica la connessione. "Connessione funzionante" significa che è pronto. Se compare che la chiave raggiunge l'intero bucket, la policy è troppo ampia: sostituiscila con quella copiata dal popup.

Altri servizi compatibili: scegli Alibaba Cloud OSS, iDrive e2 o "Altro compatibile con S3" e compila anche l'indirizzo del servizio (https), che il pannello del fornitore mostra. In Regione usa quella indicata dal fornitore. Su MEGA funziona qui solo MEGA S4 (compatibile con S3).

• "La chiave di accesso è stata rifiutata": Access Key o Secret errati, oppure chiave disattivata.
• "La chiave non ha il permesso": la policy non è stata collegata, o il nome del bucket al suo interno non coincide.
• "Il bucket indicato non esiste in questa regione": nome o regione scambiati.
• Revocare del tutto: in IAM disattiva o elimina la chiave di accesso.

Fornitori indicati come non disponibili

iCloud Drive, Proton Drive e NordLocker: l'azienda non offre accesso ad applicazioni esterne. MEGA normale: in analisi di sicurezza (usa MEGA S4 tramite S3).

Trasforma in testo i documenti che conservi già nel cloud. Non c'è un nuovo accesso: la scheda Documenti usa lo stesso collegamento della scheda Cloud, solo con l'autorizzazione minima per leggere ciò che scegli. Ogni documento ha il suo pulsante Collega, con i suoi passaggi.

Google Documenti, Fogli e Presentazioni, circa 2 minuti

Tieni a portata di mano: l'account Google dove si trovano i documenti.

1. Integrazioni, Documenti, fai clic su Collega nella riga del documento e poi su Collega l'account Google.
2. Nella finestra di Google, scegli l'account, leggi l'autorizzazione e fai clic su Consenti.
3. La finestra si chiude da sola e le tre righe di Google diventano verdi, con Collegato.
4. Nella Home, fai clic su Integrazioni › Google Drive, scegli i documenti nel selettore di Google e conferma.
5. I file entrano in coda, consumano crediti come qualsiasi invio e il testo resta in I miei file.

Cosa concede Google: solo i file che scegli nel selettore, mai l'intero Drive. TranscritorAi non modifica, non sposta e non elimina nessun documento. I documenti di Google vengono esportati al momento (PDF e .xlsx) solo per la trascrizione.

Come vedere e scegliere i tuoi documenti Google

1. Collega il tuo account Google in questa scheda (pulsante Collega). Quando la riga diventa verde, con «Collegato», l'accesso è concesso.
2. Vai alla Home e fai clic su Integrazioni › Google Drive.
3. Si apre il selettore di Google con l'elenco dei tuoi file. Per trovare quello che cerchi, usa la ricerca in alto o il menu laterale (come Recenti, Il mio Drive e Condivisi con me).
4. Riconosci il tipo dall'icona: blu è un documento, verde è un foglio di calcolo e giallo è una presentazione. Fai clic sul file per selezionarlo (puoi sceglierne più di uno).
5. Fai clic su Seleziona. TranscritorAi vede solo i file che hai selezionato qui; il resto del tuo Drive resta chiuso per lui.
6. I file entrano in coda e vengono trascritti. Quando un elemento è pronto, fai clic su Visualizza per leggere il testo in un popup (con il pulsante Copia).
7. I risultati restano anche in I miei file, dove puoi aprirli, scaricarli o inviarli a un'IA. Il documento originale resta su Google, senza alcuna modifica.

Word, Excel e PowerPoint, circa 3 minuti

Tieni a portata di mano: l'account Microsoft del OneDrive e il file salvato lì come .docx, .xlsx o .pptx.

1. Salva il file su OneDrive. I file vecchi (.doc, .xls, .ppt) vanno salvati come .docx, .xlsx o .pptx.
2. Integrazioni, Documenti, fai clic su Collega nella riga del documento e poi su Collega l'account Microsoft.
3. Nella finestra di Microsoft, scegli l'account, accedi, leggi l'autorizzazione (leggere i tuoi file) e accetta.
4. La finestra si chiude da sola e le tre righe di Microsoft diventano verdi, con Collegato.
5. Fai clic su Scegli i file da trascrivere, seleziona i file e fai clic su Trascrivi. Il pulsante Integrazioni, nella Home, apre lo stesso elenco.

Cosa concede Microsoft: solo l'autorizzazione di lettura dei file del tuo OneDrive. TranscritorAi non scrive, non modifica e non elimina nulla, e non legge e-mail, calendario né contatti. Funziona con un account personale e con un account di lavoro o scuola.

Quando qualcosa non funziona

• Il pulsante Integrazioni › Google Drive non compare nella Home: ricarica la pagina dopo aver collegato. Se resta nascosto, il selettore di file di Google non è ancora attivo su questo server.
• La finestra di Microsoft chiede l'approvazione dell'amministratore: è un account di lavoro o scuola. Chiedi a chi amministra l'account di consentire l'app di TranscritorAi e riprova.
• File .doc, .xls o .ppt: il formato vecchio non viene letto. Apri il file e salvalo come .docx, .xlsx o .pptx.
• File protetto da password: togli la password prima di importare.
• OneDrive è collegato solo per conservare file: apri un documento Microsoft, fai di nuovo clic su Collega e accetta l'autorizzazione di lettura.
• Vuoi togliere l'accesso: usa Gestisci nella scheda Cloud. Ciò che TranscritorAi ha già convertito resta in I miei file.

Due usi, sempre con il tuo account nello strumento, e TranscritorAi non modifica né elimina mai le attività già esistenti. Invia al progetto trasforma il verbale di una trascrizione in attività, e rivedi tutto prima di crearle. Importa attività dal link (Trello e Jira) legge un'attività il cui link hai incollato nel campo dei link della Home e trascrive gli allegati che scegli. Per estrarre le attività serve una tua chiave IA (vedi Chiavi IA). Piattaforme: Trello, Jira, Linear, Asana, ClickUp, monday.com e Azure DevOps. Tutte mostrano Collega e la guida passo passo; "Disponibile" significa che puoi accedere subito, e "In attivazione" che TranscritorAi sta ancora completando l'attivazione (non devi configurare nulla). Jira è solo Jira Cloud, Azure DevOps richiede un account di lavoro o scolastico, ClickUp ha un accesso ampio (non ci sono livelli di permesso) e, con monday.com, Collega porta prima all'installazione dell'app e poi all'autorizzazione.

Collegare

1. Integrazioni, Progetti, (piattaforma), Collega.
2. In Accesso scegli Leggere e creare attività (necessario per crearle davvero) oppure Sola lettura.
3. Nella finestra della piattaforma accedi, scegli il workspace o il team (e, dove richiesto, le bacheche) e accetta. La pagina mostra l'account collegato.

Usare

1. In I miei file apri la trascrizione e clicca su Invia al progetto.
2. Scegli l'account collegato e la destinazione: bacheca e lista in Trello, workspace e progetto in Asana, team in Linear, spazio e lista in ClickUp, sito e progetto in Jira, bacheca e gruppo in monday.com, organizzazione e progetto in Azure DevOps.
3. Indica i partecipanti (facoltativo, separati da virgola): aiuta ad assegnare ogni attività alla persona giusta.
4. Clicca su Estrai attività, rivedi (titolo, responsabile e scadenza), spunta solo quelle che vuoi e creale. Ogni attività compare come creata (con link per aprirla) o come "già esistente, non duplicata".

Importare un'attività dal link (Trello e Jira)

1. Nella Home, incolla un link di attività nel campo dei link (più link continuano ad andare nell'elenco). Se non hai ancora collegato lo strumento, la finestra offre Collega.
2. Nell'anteprima, vedi il testo letto (gratis), seleziona gli allegati e controlla la stima dei crediti prima di scaricare. Audio, video e PDF consumano crediti.
3. Clicca su importa: TranscritorAi trascrive e prepara il documento finale, che copi o scarichi. Legge soltanto: nulla viene scritto nello strumento, e il testo letto sparisce dal nostro database dopo 7 giorni.

Trello con la tua app (facoltativo)

Di default Trello usa l'app di TranscritorAi. Per usare un'app tua, con limite e accesso tuoi, registrala in Integrazioni, IA, Trello con la mia app:

1. Su trello.com/apps/admin crea un'app con il nome che vuoi.
2. Nella scheda OAuth 2.0 scegli il tipo Confidenziale.
3. Come URL di ritorno incolla l'indirizzo mostrato dal pannello di TranscritorAi. Deve essere identico, senza barra finale.
4. Ambiti: read:board:trello, write:board:trello e read:member:trello.
5. Copia Client ID e Client secret, incollali nei campi e salva. Poi collega Trello come al solito: userà la tua app. Il secret viene conservato cifrato.

Questa credenziale non viene verificata al salvataggio: Trello convalida la coppia solo quando autorizzi l'accesso, quindi il collegamento è la prova. Eliminare l'app da qui annulla l'accesso degli account collegati con essa.

Revocare del tutto: Trello e Jira su id.atlassian.com/manage-profile/security, Asana in Impostazioni, App, Linear in Settings, Account, Applications, ClickUp in Impostazioni, App; per monday.com e Azure DevOps, nell'area delle app autorizzate del tuo account.

Qui stanno le tue chiavi IA, usate per estrarre attività dalle trascrizioni. Il costo è tuo, addebitato dal fornitore dell'IA. La chiave è conservata cifrata, in un caveau con chiave di cifratura propria, e non viene mai mostrata di nuovo: il pannello ne mostra solo la fine. Se il server non ha il caveau attivo, la funzione resta disattivata invece di conservare la chiave senza cifratura.

Regola d'oro: l'abbonamento (Claude Pro, ChatGPT Plus, Gemini Advanced, Perplexity Pro) non è la chiave API. La chiave API si crea nel pannello sviluppatori del fornitore ed è fatturata a parte, a consumo. Imposta un limite di spesa nel pannello.

La modalità predefinita è "Uso la mia chiave (il costo è mio)". La modalità "TranscritorAi si occupa di tutto" compare solo se il server la attiva e richiede che tu accetti il prezzo. TranscritorAi usa la prima chiave valida, nell'ordine Anthropic, OpenAI, Gemini, Perplexity, DeepSeek.

Passo dopo passo (uguale per tutti)

1. Integrazioni, IA, Anthropic (Claude), Collega. Gli altri fornitori compaiono nello stesso pannello.
2. Crea la chiave nel pannello del fornitore e copiala subito: compare una sola volta.
3. Incollala in "Incolla qui la chiave" e clicca su Salva chiave.
4. TranscritorAi verifica subito la chiave, con una richiesta minima al fornitore. Funziona: fatto. Impossibile testare ora: la chiave è stata salvata ma il fornitore non ha risposto (rete, limite o saldo esaurito), usa Testa più tardi. Rifiutata dal fornitore: chiave sbagliata, scaduta o revocata, salvane una nuova.
5. Elimina rimuove la chiave da TranscritorAi ma non la revoca presso il fornitore. Per questo eliminala anche nel pannello del fornitore.

Se l'estrazione delle attività fallisce: "chiave rifiutata" richiede una chiave nuova, "impossibile leggere la chiave conservata" richiede di registrarla di nuovo, e "nessuna chiave" richiede di registrare la tua.

Non è una connessione che crei qui: è l'elenco dei siti per cui hai chiesto di ricordare l'accesso.

1. Trascrivi una pagina che richiede una password.
2. Nel popup di accesso che compare, accedi al sito e spunta salva accesso.
3. Nelle trascrizioni successive di quel sito l'accesso avviene da solo, senza popup.
4. In Integrazioni, Accessi vedi i siti salvati e clicca su Rimuovi per eliminarne uno.

Utente e password sono conservati cifrati, non compaiono più sullo schermo e sono usati solo per quel sito. Rimuovi cancella il record. Se cambi la password sul sito, la trascrizione successiva chiede di nuovo l'accesso.

Non hai risolto? Apri l'Assistenza indicando l'integrazione e il messaggio esatto sullo schermo. Non includere mai la chiave o la password.

Riepilogo: che cosa tenere a portata di mano