Principais Benefícios da Integração Transkriptor + Dust
Seus Agentes Aprendem com Cada Reunião: O Transkriptor salva cada transcrição finalizada em uma pasta do Dust, e o Dust a indexa no instante em que ela chega. A partir daí, qualquer agente com acesso a esse espaço pode responder a perguntas que abrangem meses de conversas — quais foram as objeções de um cliente, quais compromissos foram feitos em uma chamada ou onde uma decisão foi mencionada pela primeira vez.
Nada para Configurar no Dust: Basta escolher uma pasta e pronto. O Transkriptor formata cada transcrição como um documento markdown limpo, com título, data, resumo e transcrição já estruturados — sem templates para desenhar, campos para configurar ou automações complexas para criar.
Resumo e Transcrição Completa Juntos: Cada documento apresenta o resumo gerado por IA no topo e a transcrição completa logo abaixo. Seus agentes podem fornecer uma resposta rápida ou extrair uma citação exata, pois ambos os conteúdos residem no mesmo documento.
Reuniões e Uploads em uma Única Pasta: Tanto as reuniões ao vivo capturadas pelo bot do Transkriptor quanto os arquivos que você envia ou grava por conta própria vão para o mesmo local, garantindo que seus agentes tenham uma visão completa.
Sem Duplicatas, Nunca: Cada transcrição corresponde a um único documento. Se uma gravação for processada novamente, o Transkriptor atualiza o documento existente em vez de criar um novo.
Compatível com Ambas as Regiões do Dust: O Transkriptor oferece suporte aos workspaces dos EUA e da UE do Dust. Suas transcrições permanecem na mesma região onde seu workspace do Dust já está localizado.
Como Conectar o Dust ao Transkriptor
Três etapas rápidas — uma no Dust, uma cópia de chave e uma no Transkriptor.
Passo 1: Crie uma pasta no Dust
No Dust, abra o menu Spaces, escolha o espaço que deseja usar e vá em Folders → Add folder. Dê um nome como "Transcritos de Reunião" e salve.
Importante: Esta etapa é obrigatória e deve ser feita primeiro. As pastas do Dust só podem ser criadas dentro da própria plataforma — o Transkriptor não consegue criar uma para você. Se você fizer a conexão antes de criar a pasta, o menu suspenso "Pasta de Destino" ficará vazio. Caso isso aconteça, crie a pasta e abra as configurações do Transkriptor novamente.
Passo 2: Obtenha sua Chave de API do Dust
No Dust, acesse Admin → Developers → API Keys e clique em + Create API key. Nomeie-a como "Transkriptor" e certifique-se de que o espaço onde você criou a pasta esteja incluído no escopo da chave.
O Dust exibirá quatro valores: Nome, Domínio, ID do Workspace e a Chave de API. Copie os três últimos agora — a chave de API só aparece uma vez e some quando você fecha o painel.
Passo 3: Conectar o Dust no Transkriptor
Acesse a aba Integrações no seu painel do Transkriptor, localize o Dust e clique em Conectar.
No modal “Conecte seu Dust”, insira os dois valores abaixo:
Chave de API: a chave que você criou na etapa anterior (começa com
sk-).URL do Workspace: enquanto ainda estiver na página de Desenvolvedores no Dust, copie a URL completa da barra de endereços do seu navegador, como destacado abaixo. Ela deve ser semelhante a
//app.dust.tt/w/seu-workspace-id/developers.
Copie a URL inteira, não apenas o domínio. Digitar apenas
dust.ttouapp.dust.ttnão funcionará, pois a URL também contém o ID do seu workspace.
2. e clique em conectar.
O Transkriptor verifica a chave no seu workspace do Dust imediatamente. Se os valores estiverem corretos, você será levado diretamente para a tela de configurações com suas pastas já carregadas.
Passo 4: Configure suas Ajustes do Dust
Após a conexão, o modal de Configurações do Dust será aberto. Configure o seguinte:
Pasta de Destino — Escolha a pasta do Dust onde o Transkriptor deve gravar seus documentos. O menu suspenso lista todas as pastas que sua chave de API pode acessar, exibidas como Espaço / Pasta. Se o menu estiver vazio, ou não existe uma pasta no seu workspace, ou a chave de API está restrita a espaços que não contêm sua pasta — crie a pasta ou uma nova chave com permissões mais amplas, depois feche e abra as configurações novamente.
Incluir Resumo (ativado por padrão) — Grava o resumo gerado por IA em uma seção de Resumo no topo do documento, convertido em um texto limpo e legível.
Incluir Transcrição (ativado por padrão) — Adiciona a transcrição completa abaixo do resumo, com marcações de tempo e identificação dos falantes.
Incluir link do áudio (ativado por padrão) — Adiciona um link para o arquivo original de áudio ou vídeo ao final do documento.
Clique em Salvar para aplicar as configurações.
Pelo menos uma destas opções deve estar ativa. Se você desativar as três, o Transkriptor ignorará a transcrição em vez de criar um documento vazio.
Passo 5: Concluído — Os documentos são criados automaticamente
Sua integração está ativa. A partir de agora, cada reunião transcrita aparecerá como um novo documento na sua pasta do Dust, pronta para ser usada pelos seus agentes.
O que cada documento contém
Cada transcrição se torna um documento markdown, estruturado da seguinte forma:
Parte | Conteúdo |
Título | O título da reunião ou o nome do arquivo enviado, sem a extensão |
Data | Data e hora de criação do documento (UTC) |
Tipo | Indica se o registro veio de uma reunião ao vivo ou de um arquivo enviado |
Resumo | Resumo gerado por IA, convertido para texto simples |
Transcrição | Transcrição completa com marcações de tempo e identificação de oradores |
Gravação | Link para o arquivo original de áudio ou vídeo |
Cada documento também possui tags que seus agentes e a busca do Dust podem filtrar: transkriptor em todos os documentos, type:meeting ou type:upload dependendo da origem, e order_id: seguido pelo ID exclusivo da transcrição. O campo Associated URL do documento aponta para a transcrição exportada, permitindo que você acesse o texto completo a partir do Dust com apenas um clique.
Como desconectar da integração
Clique no ícone de três pontos ao lado da integração do Dust no Transkriptor para alterar suas configurações ou desconectar.
A desconexão impede que o Transkriptor escreva novos documentos. Tudo o que já está na sua pasta do Dust permanecerá lá, e seus agentes continuarão utilizando esses arquivos.
Um passo extra recomendado: O Dust não permite que aplicativos externos revoguem suas próprias chaves, portanto, a chave de API que você criou continuará válida até ser excluída. Para encerrar o processo completamente, acesse Admin → Developers → API Keys no Dust e remova a chave criada para o Transkriptor.
Solução de problemas
Problema | O que fazer |
O menu suspenso 'Pasta de Destino' está vazio | Isso ocorre porque não existe uma pasta no seu espaço de trabalho do Dust ou a chave de API está limitada a um espaço que não contém sua pasta. Crie a pasta no Dust primeiro ou gere uma nova chave com a permissão correta, depois feche e abra as configurações novamente. |
A conexão falhou após colar as credenciais | Verifique se você copiou corretamente os três valores — Chave de API, ID do Workspace e Domínio — do painel da API do Dust antes que ele fosse fechado. Se necessário, gere uma nova chave. |
O painel da chave de API fechou antes da cópia | Acesse Dust → Admin → Developers → API Keys e crie uma nova chave. A chave anterior continuará ativa, mas não é mais possível visualizar seu valor. |
As notas não aparecem no Dust | Confirme se a Pasta de Destino está configurada corretamente e se pelo menos uma opção de conteúdo (Resumo, Transcrição ou Link do Áudio) está ativada. |
Workspace da UE não conecta | Certifique-se de que o campo Domínio contém //eu.dust.tt, e não //dust.tt. |
Ainda precisa de ajuda? Entre em contato com o suporte.
