Vantaggi Chiave dell'Integrazione Transkriptor + Dust
I Tuoi Agenti Imparano da Ogni Riunione: Transkriptor salva ogni trascrizione completata in una cartella Dust, e Dust la indicizza all'istante. Da quel momento, qualsiasi agente con accesso a quello spazio può rispondere a domande basate su mesi di conversazioni: a cosa si è opposto un cliente, quali impegni sono stati presi in una chiamata o dove è stata sollevata per la prima volta una decisione.
Niente da Creare su Dust: Scegli una cartella e il gioco è fatto. Transkriptor formatta ogni trascrizione come un documento markdown pulito, con titolo, data, riepilogo e trascrizione già strutturati — nessun template da progettare, nessun campo da configurare, nessuna automazione da impostare.
Riepilogo e trascrizione completa insieme: Ogni documento include il riepilogo generato dall'IA in alto e la trascrizione completa subito sotto. I tuoi agenti possono fornire una risposta rapida o citare una frase esatta, avendo tutto a disposizione nello stesso file.
Riunioni e caricamenti in un'unica cartella: Sia le riunioni live acquisite dal bot di Transkriptor che i file caricati o registrati manualmente confluiscono nello stesso posto, offrendo ai tuoi agenti una visione d'insieme completa.
Nessun duplicato, mai: Ogni trascrizione corrisponde a un singolo documento. Se una registrazione viene elaborata nuovamente, Transkriptor aggiorna il documento esistente invece di crearne uno nuovo.
Compatibile con entrambe le regioni Dust: Transkriptor supporta le aree di lavoro Dust sia negli USA che nell'UE. Le tue trascrizioni rimangono nella stessa regione in cui si trova già il tuo workspace Dust.
Come connettere Dust a Transkriptor
Tre brevi passaggi: uno su Dust, la copia di una chiave e l'ultimo su Transkriptor.
Passaggio 1: Crea una cartella in Dust
In Dust, apri la sezione Spaces, scegli lo spazio che desideri utilizzare e vai su Folders → Add folder. Assegna un nome come "Trascrizioni Riunioni" e salva.
Importante: Questo passaggio è obbligatorio e deve essere eseguito per primo. Le cartelle di Dust possono essere create solo all'interno di Dust: Transkriptor non può crearne una al posto tuo. Se effettui il collegamento prima di creare una cartella, il menu a discesa Cartella di Destinazione risulterà vuoto. In tal caso, torna qui, crea la cartella e riapri le impostazioni di Transkriptor.
Passaggio 2: Ottieni la tua chiave API di Dust
In Dust, vai su Admin → Developers → API Keys e clicca su + Create API key. Assegna un nome come Transkriptor e assicurati che lo spazio contenente la tua nuova cartella sia incluso nell'ambito della chiave.
Dust mostrerà quindi quattro valori: Nome, Dominio, ID Workspace e la Chiave API. Copia subito gli ultimi tre: la chiave API viene visualizzata una sola volta e scomparirà non appena chiuderai il pannello.
Passaggio 3: Collega Dust a Transkriptor
Apri la scheda Integrazioni nella dashboard di Transkriptor, individua Dust e clicca su Connetti.
Nella finestra “Collega Dust”, inserisci i due valori seguenti:
Chiave API: la chiave creata nel passaggio precedente (inizia con
sk-).URL del Workspace: restando nella pagina Sviluppatori di Dust, copia l' URL completo dalla barra degli indirizzi del tuo browser, come evidenziato di seguito. Dovrebbe apparire così:
//app.dust.tt/w/vostro-id-workspace/developers.
Copia l'intero URL, non solo il dominio. Inserire solo
dust.ttoppureapp.dust.ttnon funzionerà, poiché l'URL contiene anche l'ID del tuo workspace.
2. e clicca su connetti.
Transkriptor verifica immediatamente la chiave con il tuo workspace Dust. Se i valori sono corretti, verrai indirizzato direttamente alla schermata delle impostazioni con le tue cartelle già caricate.
Passaggio 4: Configura le tue impostazioni Dust
Una volta stabilita la connessione, si aprirà la finestra delle impostazioni di Dust. Configura quanto segue:
Cartella di destinazione — Scegli la cartella di Dust in cui Transkriptor dovrà salvare i tuoi documenti. Il menu a discesa elenca tutte le cartelle accessibili tramite la tua chiave API, visualizzate come Spazio / Cartella. Se il menu è vuoto, significa che non esistono ancora cartelle nel tuo workspace o che la chiave API è limitata a spazi che non contengono la tua cartella; in tal caso, crea la cartella o una nuova chiave con permessi più ampi, quindi chiudi e riapri le impostazioni.
Includi riepilogo (attivo per impostazione predefinita) — Inserisce il riepilogo generato dall'IA in una sezione dedicata all'inizio del documento, convertito in un testo chiaro e leggibile.
Includi trascrizione (attivo per impostazione predefinita) — Aggiunge la trascrizione completa sotto il riepilogo, completa di timestamp e nomi degli interlocutori.
Includi link al file audio (attivo di default) — Aggiunge un link al file audio o video originale alla fine del documento.
Clicca su Salva per applicare le impostazioni.
Almeno una di queste opzioni deve essere attiva. Se le disattivi tutte e tre, Transkriptor salterà la trascrizione anziché creare un documento vuoto.
Passaggio 5: Fatto — I documenti vengono creati automaticamente
L'integrazione è ora attiva. Ogni riunione trascritta da questo momento in poi apparirà come un nuovo documento nella tua cartella Dust, pronta per essere utilizzata dai tuoi agent.
Cosa contiene ogni documento
Ogni trascrizione viene convertita in un documento markdown, strutturato in questo modo:
Sezione | Contenuti |
Titolo | Il titolo della riunione o il nome del file caricato (senza estensione) |
Data | Data di creazione del documento, in formato UTC |
Tipo | Indica se il record proviene da una riunione dal vivo o da un file caricato |
Riepilogo | Il riepilogo generato dall'IA, convertito in testo semplice |
Trascrizione | La trascrizione completa con timestamp e nomi dei relatori |
Registrazione | Un link al file audio o video originale |
Ogni documento include tag che i tuoi agenti e la ricerca di Dust possono filtrare: 'transkriptor' su ogni documento, 'type:meeting' o 'type:upload' a seconda della fonte, e 'order_id:' seguito dall'ID univoco della trascrizione. L'URL associato al documento rimanda alla trascrizione esportata, permettendoti di passare da Dust al testo completo con un solo clic.
Come disconnettersi dall'integrazione
Fai clic sull'icona con i tre puntini accanto all'integrazione di Dust in Transkriptor per modificare le impostazioni o disconnetterti.
La disconnessione impedisce a Transkriptor di scrivere nuovi documenti. Tutto ciò che è già presente nella tua cartella Dust rimarrà al suo posto e i tuoi agent continueranno a utilizzarlo.
Un passaggio aggiuntivo consigliato: Dust non consente alle app esterne di revocare le proprie chiavi, quindi la chiave API creata rimarrà valida finché non la eliminerai. Per completare la procedura, vai su Admin → Developers → API Keys in Dust e rimuovi la chiave creata per Transkriptor.
Risoluzione dei problemi
Problema | Cosa fare |
Il menu a discesa Cartella di destinazione è vuoto | Non esiste ancora alcuna cartella nel tuo workspace di Dust, oppure la chiave API è limitata a uno spazio che non contiene la tua cartella. Crea prima la cartella in Dust, oppure genera una nuova chiave con l'ambito corretto, quindi chiudi e riapri le impostazioni. |
La connessione fallisce dopo aver incollato le credenziali | Assicurati di aver copiato correttamente tutti e tre i valori — Chiave API, ID Workspace e Dominio — dal pannello API di Dust prima che venisse chiuso. Se necessario, genera una nuova chiave. |
Il pannello delle chiavi API è stato chiuso prima della copia | Torna su Dust → Admin → Developers → API Keys e crea una nuova chiave. La chiave precedente rimarrà attiva, ma il suo valore non potrà più essere recuperato. |
Le note non compaiono su Dust | Verifica che la Cartella di Destinazione sia impostata correttamente e che almeno uno dei selettori di contenuto (Riepilogo, Trascrizione o Link Audio) sia attivo. |
Il workspace EU non si connette | Assicurati che il campo Dominio contenga //eu.dust.tt, e non //dust.tt. |
Hai ancora bisogno di aiuto? Contatta l'assistenza.
