Guia de integrações, passo a passo

Para quem clica em Conectar na página Integrações e quer saber o que ter em mãos e onde conseguir cada informação. As telas dos provedores mudam: se algum nome de menu estiver diferente, procure pelo nome da opção na busca da página do provedor.

• Antes de começar
• Como tratamos os seus segredos
• Mensagens: Telegram e WhatsApp
• E-mail automático
• Reuniões: Zoom, Meet e Teams
• Nuvem: Drive, Dropbox, OneDrive e S3
• Documentos: Google Docs, Sheets, Slides, Word, Excel e PowerPoint
• Projetos: Trello, Jira, Linear, Asana, ClickUp, monday.com e Azure DevOps
• IA e chaves
• Logins salvos
• Quando algo não funciona e resumo

Como ler o botão e a etiqueta de cada linha

Ao conectar com sucesso, a página mostra "conectado" e o TranscritorAi envia um e-mail avisando da alteração. Se esse e-mail chegar sem você ter feito nada, desconecte e troque a senha da sua conta.

Dois jeitos de conectar

1. Login no site do provedor (OAuth): Google Drive, Dropbox, OneDrive, Zoom, Google Meet, Teams, Trello, Jira, Asana, ClickUp, monday.com, Azure DevOps e Linear. Abre uma janela do provedor, você entra e aceita. Sua senha nunca passa pelo TranscritorAi e não há nada para copiar e colar.
2. Colar uma chave ou senha de aplicativo: token do bot do Telegram, e-mail por POP3, Amazon S3, chaves de IA, robô de reunião e aplicativos próprios. Este guia explica onde gerar cada uma.

Regras que valem para tudo

• Pop-up bloqueado? O login do provedor abre numa janela à parte. Se o navegador bloquear, a página segue na mesma aba. Permita pop-ups para o site do TranscritorAi e clique de novo.
• Segredos aparecem uma vez. Copie a chave na hora. Se perder, gere outra no provedor e cadastre de novo.
• Nunca mande chave nem senha por e-mail, WhatsApp ou chat de suporte. O único lugar para colar é o campo do popup, na página Integrações.
• O custo é do provedor, direto de você. Chaves de IA, robô de reunião e aplicativo próprio da Microsoft são cobrados pelo fornecedor na sua conta. O TranscritorAi não entra nesse pagamento.
• Você desconecta quando quiser. Desconectar apaga a credencial do nosso lado. O que já foi criado na sua nuvem, nas suas tarefas ou nos seus arquivos continua lá. Para revogar de vez, remova o acesso também no provedor (cada seção diz onde).
• É preciso estar logado no TranscritorAi. Sem login, a página só mostra o botão Entrar.

O que nunca guardamos

• A senha do seu login no Google, Dropbox, OneDrive, Zoom, Microsoft, Trello, Jira, Asana, ClickUp, monday.com, Azure DevOps, Linear ou Meta. O login acontece no site do provedor. O TranscritorAi só recebe um token de acesso, que você revoga quando quiser.
• A senha da sua conta do TranscritorAi em texto legível. Ela vira um hash, uma "impressão" que não permite recuperar a senha original. Quando o painel pede "Sua senha, para confirmar", ela só é conferida, nunca copiada.
• Senha de e-mail no caminho por encaminhamento (Hotmail, Outlook, iCloud ou qualquer outro): esse caminho não usa senha nenhuma.
• Nenhum segredo volta para a tela. Depois de salvo, chave, token ou senha nunca são mostrados de novo. O painel exibe no máximo o final da chave, como "termina em 3f9a".
• Texto cru do provedor nos erros. As mensagens de erro que você vê são textos nossos.

O que guardamos, sempre cifrado

Cada item abaixo é gravado no banco já criptografado (Fernet: AES com verificação de integridade, biblioteca cryptography), com chaves de criptografia separadas por tipo de integração. Se o servidor não tiver a chave de um tipo, essa integração fica desligada por inteiro, em vez de guardar o segredo sem cifra.

Quando você desconecta ou apaga: a credencial é apagada do nosso lado. O que já foi criado (arquivos na sua nuvem, tarefas, transcrições) continua com você. Apagar aqui não revoga o acesso no provedor: para isso, use o "Revogar de vez" de cada seção.

O que a criptografia protege e o que não protege

Ela protege o conteúdo do banco de dados e dos backups: quem copiasse só o arquivo do banco não leria nenhum segredo. Nenhuma criptografia protege contra quem invada o próprio servidor, onde ficam as chaves. Por isso vale também:

• Dê às chaves o menor poder possível: a política mínima do S3, o acesso só de leitura nas plataformas de projetos, um limite de gasto nas chaves de IA.
• Em caso de suspeita de vazamento, revogue primeiro no provedor e só depois apague aqui.
• Nunca cole segredos em e-mail, chat de suporte ou fora dos campos do popup em Integrações.

Telegram (bot próprio), uns 3 minutos

Ter em mãos: o Telegram e a senha da sua conta TranscritorAi (mais o código da verificação em duas etapas, se você usa).

1. No Telegram, procure por @BotFather (o bot oficial, com selo azul de verificado).
2. Envie /newbot.
3. Ele pergunta o nome do bot (pode ser qualquer um) e depois o nome de usuário, que precisa terminar em bot, por exemplo meu_transcritor_bot.
4. O BotFather responde com o token, algo como 123456789:AAH.... Copie. Esse token é a senha do bot: não compartilhe. Ele é guardado cifrado e nunca é mostrado de novo.
5. No TranscritorAi: Integrações, Mensagens, Telegram, Conectar.
6. Cole o token em Token do bot, digite a sua senha para confirmar (e o código da verificação em duas etapas, se pedir) e clique em Conectar.
7. Aparece um código de pareamento, que vale 10 minutos e só pode ser usado uma vez. Clique em Abrir o bot no Telegram e toque em Iniciar, ou envie o código ao bot.
8. O status vira Pronto para usar. Mande ou encaminhe áudios, vídeos, arquivos ou links ao bot e a transcrição volta na mesma conversa.

• Comandos do bot: /status, /creditos, /cancelar, /desconectar.
• Limite: o Telegram aceita arquivos de até 20 MB. Os maiores você envia pelo site.
• Código expirou? Clique em Gerar outro código.
• "Não foi possível conectar": o token foi colado com espaço ou faltou um pedaço, ou é de um bot apagado. Gere um novo com /token no BotFather.
• Revogar de vez: no BotFather, /revoke (gera outro token e derruba o antigo) ou /deletebot.

WhatsApp (conta WhatsApp Business), uns 5 minutos

Ter em mãos: um número do WhatsApp Business (um número só para isso, ou o aplicativo WhatsApp Business; o WhatsApp comum não serve), uma conta de Facebook e a senha do TranscritorAi.

1. Integrações, Mensagens, WhatsApp, Conectar.
2. Digite a sua senha do TranscritorAi e clique em Conectar com a Meta.
3. Na janela da Meta, entre com o Facebook, escolha ou crie a conta do WhatsApp Business, escolha (ou cadastre e verifique por SMS ou ligação) o número e aceite as permissões.
4. De volta ao site aparece um código. Do seu WhatsApp pessoal, envie esse código para o número conectado (o botão Abrir o WhatsApp já abre a conversa).
5. Pronto: mande ou encaminhe áudios, vídeos, arquivos ou links ao número e a transcrição volta na mesma conversa.

• Respostas dentro de 24 horas da sua última mensagem não têm custo de mensagem na Meta.
• "O WhatsApp ainda não foi habilitado neste servidor": o botão aparece, mas a parte do TranscritorAi com a Meta ainda não foi concluída. Não é erro seu. Use o Telegram enquanto isso.
• Revogar de vez: nas configurações do Facebook, em Integrações de negócios, remova o TranscritorAi.

Faz o texto, os anexos e (se você quiser) os links dos e-mails entrarem sozinhos na fila de transcrição, com os mesmos créditos de um envio pelo site. Antes de tudo, confirme o e-mail da sua conta TranscritorAi (a página avisa se faltar). Se aparecer "não está incluída no seu plano", o recurso não está liberado para o seu plano.

Hotmail, Outlook e Live entram pelo login da Microsoft, sem senha guardada, e o Apple iCloud entra por IMAP com senha de app. O encaminhamento serve para qualquer provedor.

Caminho A: encaminhar (qualquer provedor)

Funciona com qualquer provedor e não guarda senha nem autorização. É a escolha para quem não quer entregar acesso à caixa, e a única para um provedor sem POP3, IMAP nem login pela Microsoft.

1. Integrações, E-mail, (seu provedor), Conectar. O painel mostra o endereço do TranscritorAi para onde encaminhar. Use Copiar endereço.
2. Libere o seu endereço de origem. Só e-mails vindos de um endereço verificado são aceitos, e o e-mail da sua conta já vale. Para outro, digite-o em Outro endereço seu, clique em Enviar código, abra o e-mail que chegou nesse endereço e digite os 6 dígitos em Confirmar.
3. Configure o encaminhamento no seu e-mail. No Hotmail/Outlook (Outlook na web): Configurações, Email, Encaminhamento, ligue e cole o endereço copiado, ou crie uma regra que encaminha só o que você escolher. No iCloud: iCloud.com, Mail, engrenagem, Ajustes, Geral, ligue o encaminhamento para o endereço copiado.
4. Escolha as opções e salve: transcrever o texto do e-mail, os anexos, seguir os links, ocultar dados pessoais (LGPD).
5. Teste: envie a si mesmo um e-mail com um áudio anexado. O resultado aparece em Histórico.

Dica: crie a regra de encaminhamento só para um remetente ou uma pasta, senão todo e-mail da caixa gasta créditos.

Caminho B: conectar a caixa por POP3

O servidor e a porta se preenchem ao escolher o provedor. O login é sempre o endereço de e-mail completo. A senha é uma senha de aplicativo, nunca a senha normal. Ela é guardada cifrada, nunca é mostrada de novo e é apagada quando você desconecta a caixa. Como só abre o e-mail por POP3 (não entra na sua conta), você a revoga a qualquer momento sem trocar a senha principal.

Hotmail, Outlook e Live: login da Microsoft

1. Hotmail, Outlook e Live não aceitam senha no POP3. Por isso você entra pela conta da Microsoft: o TranscritorAi nunca vê a sua senha e só recebe a permissão de ler a caixa.
2. No Outlook na web: Configurações > Email > Sincronizar e-mail, e em POP e IMAP escolha "Sim" em "Permitir que dispositivos e aplicativos usem POP". Salve.
3. Aqui no TranscritorAi, digite o seu e-mail Hotmail, Outlook ou Live e informe os remetentes permitidos e/ou uma etiqueta no assunto (por exemplo [transcrever]).
4. Clique em Entrar com a Microsoft, escolha a conta e aceite o acesso de leitura da caixa. Ao voltar, a caixa aparece como conectada. Para revogar, use Desconectar aqui ou remova o acesso em account.live.com/consent/Manage.

Apple iCloud: IMAP

1. O iCloud Mail não oferece POP3, mas aceita IMAP com senha de app: o TranscritorAi só lê a caixa de entrada (imap.mail.me.com, porta 993) e não marca nem muda nada nos seus e-mails.
2. Em account.apple.com > Login e segurança > Senhas de app (ou "Senhas específicas de app"; a autenticação de dois fatores precisa estar ligada), clique em + e dê o nome TranscritorAi. Copie a senha gerada (formato xxxx-xxxx-xxxx-xxxx): ela só aparece uma vez.
3. Aqui no TranscritorAi, escolha Apple iCloud, digite o seu e-mail do iCloud completo (nome@icloud.com, @me.com ou @mac.com) e cole a senha de app. O servidor e a porta já vêm preenchidos.
4. Informe os remetentes permitidos e/ou uma etiqueta no assunto (por exemplo [transcrever]), clique em Testar conexão e depois em Conectar.

Gmail

1. Em myaccount.google.com, abra Segurança e ative a Verificação em duas etapas (obrigatória para criar senha de aplicativo).
2. Ainda em Segurança, busque "Senhas de app" (ou acesse myaccount.google.com/apppasswords). Dê um nome, como "TranscritorAi", e clique em Criar. Copie as 16 letras, sem espaços. Elas só aparecem uma vez.
3. No Gmail: engrenagem, Ver todas as configurações, aba Encaminhamento e POP/IMAP. Em Download POP, escolha ativar o POP para todas as mensagens (ou só para as que chegarem a partir de agora) e salve.
4. No TranscritorAi: Integrações, E-mail, Gmail, Conectar. Preencha o e-mail (login) e a senha de aplicativo.

Yahoo Mail

1. Em login.yahoo.com/account/security, ative a verificação em duas etapas, se ainda não estiver.
2. Na mesma página, gere uma senha de aplicativo ("Outro aplicativo"), dê um nome e copie.
3. Conecte no TranscritorAi com o servidor pop.mail.yahoo.com.

Zoho Mail

1. No Zoho Mail, em Configurações, Contas de e-mail, Acesso POP, ative o POP.
2. Se você usa autenticação em duas etapas, em accounts.zoho.com, Segurança, Senhas específicas de aplicativo, gere uma senha e copie.
3. Conecte com o servidor pop.zoho.com. Contas de outras regiões (como .eu ou .in) usam o servidor POP da região: confira no painel do Zoho.

UOL, Hostinger e domínio próprio

1. Ative o POP3 nas configurações do e-mail (no UOL Mail ou no painel da hospedagem do seu domínio).
2. Use o servidor, a porta e a senha que o provedor informa. Na Hostinger, o login é o e-mail completo.
3. Se o provedor não tiver senha de aplicativo, use a senha da caixa. Quando possível, crie uma caixa só para isso.

Preencher o formulário (todos os provedores POP3)

1. Escolha o provedor, dê um apelido (opcional) e informe o e-mail (login) e a senha de aplicativo.
2. Filtro de segurança: por segurança só lemos o que você escolher. Informe remetentes permitidos, separados por vírgula (por exemplo ana@exemplo.com, @empresa.com), e/ou uma etiqueta no assunto (por exemplo [transcrever]). "Aceitar qualquer e-mail" existe, mas gasta créditos com tudo que chegar: evite.
3. Deixe marcado Ignorar os e-mails que já estão na caixa (recomendado): a primeira leitura só registra o que já existe.
4. "Apagar da caixa o que foi transcrito" é opcional. Deixe desligado se não tiver certeza.
5. Clique em Testar conexão e depois em Conectar.
6. A leitura roda sozinha a cada poucos minutos. Ler agora força uma leitura (agendada em até 1 minuto).

• Falha no teste: quase sempre é senha normal no lugar da senha de aplicativo, POP desligado no provedor, ou espaços na senha.
• Caixa "pausada por erro": o provedor recusou o acesso (senha trocada ou revogada). Gere outra senha de aplicativo e use Corrigir.
• Revogar de vez: apague a senha de aplicativo na segurança da sua conta de e-mail.

Conecte a sua conta de Zoom, Google Meet ou Microsoft Teams para receber a transcrição que a própria plataforma gerou, sem gravar e sem enviar arquivo. O TranscritorAi só lê e nunca entra na chamada. O login é feito no site da plataforma: o TranscritorAi não vê nem guarda a sua senha, só um token de acesso cifrado.

Fluxo: Integrações, Reuniões, (plataforma), Conectar, entre na plataforma na janela que abrir, aceite o acesso e depois ajuste as regras.

O ponto principal: conectar não cria transcrição. A transcrição precisa existir na plataforma. Confira os requisitos da sua antes de conectar.

Zoom

Precisa de: plano pago do Zoom, com gravação em nuvem e transcrição de áudio ligadas.

1. Em zoom.us, abra as configurações de Gravação do anfitrião.
2. Ligue a gravação em nuvem e a opção de criar transcrição de áudio.
3. Grave as reuniões na nuvem (automática ou manualmente). Sem gravação em nuvem, não há transcrição.
4. No TranscritorAi, clique em Conectar e aceite o acesso na janela do Zoom.

Revogar de vez: Zoom Marketplace, Manage, Added Apps.

Google Meet

Precisa de: uma edição paga do Google Workspace que inclua transcrição (por exemplo, Business Standard ou superior). Contas pessoais @gmail.com normalmente não geram transcrição.

1. Conecte com a conta do organizador da reunião: a transcrição fica com quem a organizou.
2. Na reunião, ligue a transcrição (Atividades, Transcrições), ou peça ao administrador do Workspace para ligá-la por padrão.
3. Depois que a reunião acaba, a transcrição leva alguns minutos. O TranscritorAi busca sozinho.
4. No TranscritorAi, clique em Conectar, escolha a conta do organizador e aceite o acesso de leitura às reuniões.

• Aviso "app não verificado" do Google: enquanto a verificação do aplicativo não termina, o Google pode mostrar um aviso. Só prossiga se a página for accounts.google.com e o aplicativo for o TranscritorAi.
• Revogar de vez: myaccount.google.com/permissions, TranscritorAi, Remover acesso.

Microsoft Teams

Precisa de: conta de trabalho ou escola do Microsoft 365 (conta pessoal Hotmail/Outlook não tem transcrição do Teams), com a transcrição de reuniões ligada. Em geral o administrador precisa aprovar o acesso.

1. Peça ao administrador do Microsoft 365 para permitir a transcrição de reuniões do Teams para a sua conta.
2. Na reunião, inicie a transcrição (Mais ações, Gravar e transcrever, Iniciar transcrição).
3. No TranscritorAi, clique em Conectar e entre com a conta da organização. Se a Microsoft pedir aprovação do administrador, envie a solicitação a ele e conecte de novo depois.

Aplicativo próprio (opcional, mas pode ser obrigatório). A Microsoft cobra pelo uso da API de transcrição. Se o painel disser "Para conectar esta plataforma, cadastre o aplicativo da sua organização", ou se você prefere que a cobrança caia na sua assinatura do Azure, registre um aplicativo seu:

1. Em portal.azure.com, abra Microsoft Entra ID, Registros de aplicativo, Novo registro.
2. Nome: "TranscritorAi". Tipo de conta: somente este diretório. Em URI de redirecionamento, tipo Web, informe https://<endereço do site>/api/reunioes/integracoes/teams/callback, trocando o trecho entre sinais pelo domínio do TranscritorAi, o mesmo que você usa no navegador, sem barra no fim. Registre.
3. Copie o ID do aplicativo (cliente) e o ID do diretório (locatário).
4. Em Certificados e segredos, crie um novo segredo do cliente e copie o Valor na hora (ele some depois).
5. Em Permissões de API, adicione Microsoft Graph, permissões delegadas: User.Read, OnlineMeetings.Read, OnlineMeetingTranscript.Read.All e offline_access. Depois, um administrador do locatário precisa conceder o consentimento.
6. No TranscritorAi, no painel do Teams, preencha ID do aplicativo, segredo do aplicativo e organização (o ID do diretório) e clique em Salvar aplicativo. Só então clique em Conectar. Para voltar ao aplicativo do TranscritorAi, use Remover aplicativo.

A cobrança de transcrição da Microsoft cai na assinatura do Azure associada ao aplicativo. Sem assinatura, um volume pequeno funciona em modo de avaliação e depois a Microsoft recusa. Revogar de vez: em myapps.microsoft.com, remova o consentimento (a Microsoft não permite revogar pela API, por isso desconectar só apaga o token do nosso lado).

Depois de conectar: regras e agenda

• Captura: só quando eu pedir, todas as reuniões, ou só as com uma palavra no título.
• Resumo e plano de ação, ocultar dados pessoais (LGPD) e aviso por e-mail quando ficar pronta são opcionais.
• Buscar reuniões agora lista as dos últimos 7 dias. "Próximas reuniões" deixa você escolher uma a uma o que transcrever.
• Avise os participantes de que a reunião será transcrita. Você é o responsável por ter autorização para isso.
• Algumas opções podem gerar cobrança adicional debitada do saldo de reuniões (por exemplo, o Teams pelo aplicativo do TranscritorAi). Nesse caso a página pede o seu aceite. Sem aceite e sem saldo, nada é transcrito. O saldo se compra em Planos.

Robô na reunião (para reuniões que a plataforma não transcreve)

Um participante chamado "TranscritorAi" entra na chamada, e o anfitrião precisa admiti-lo. O robô é de um fornecedor externo (hoje, o Recall.ai) e usa a conta dele. A chave do robô é guardada cifrada.

1. Crie uma conta em recall.ai e gere uma chave de API no painel. Anote a região da conta (por exemplo us-west-2, us-east-1, eu-central-1 ou ap-northeast-1).
2. No bloco Robô na reunião, escolha o fornecedor e a região (a mesma da sua conta), cole a chave em "Chave da sua conta" e clique em Guardar chave.
3. Marque o aceite de cobrança. A cobrança é do fornecedor, direto de você.
4. Cole o link da reunião (Zoom, Meet ou Teams), marque que avisou os participantes e clique em Enviar o robô. Admita o "TranscritorAi" na reunião.

Limites: no máximo 2 robôs ao mesmo tempo e um teto mensal por conta. Sem chave própria, pode ser possível usar o robô descontando do saldo de reuniões, se o servidor oferecer.

O TranscritorAi guarda seus arquivos e transcrições numa pasta chamada transcritorai na sua nuvem, sem usar o armazenamento do seu plano. Você escolhe o que ele pode fazer:

Depois de conectar: Usar como destino define qual nuvem recebe os arquivos novos, Mover meus arquivos para a nuvem envia o que ainda está só no site, e Importar da nuvem busca arquivos para transcrever.

Google Drive, Dropbox e OneDrive (login no provedor)

1. Integrações, Nuvem, (provedor), Conectar.
2. Escolha a permissão e confirme.
3. Na janela do provedor, entre, leia as permissões e aceite. A pasta transcritorai é criada sozinha.

A sua senha nunca passa pelo TranscritorAi: guardamos só o token, cifrado. O que cada provedor concede:

• Google Drive: só os arquivos que o próprio TranscritorAi cria. Para importar, você escolhe os arquivos no seletor do Google.
• Dropbox: no modo só guardar, acesso apenas à pasta Apps/transcritorai.
• OneDrive: no modo só guardar, apenas à pasta do aplicativo (Apps). Importar, ou usar a pasta na raiz, exige acesso aos seus arquivos. Contas de trabalho ou escola podem exigir aprovação do administrador.
• Ampliar a permissão depois exige vincular a conta de novo (Reconectar).
• Revogar de vez: Google em myaccount.google.com/permissions, Dropbox em Configurações, Segurança, Aplicativos conectados, OneDrive em account.microsoft.com/privacy (ou myapps.microsoft.com para contas de trabalho).

Amazon S3 e serviços compatíveis (AWS, Alibaba OSS, iDrive e2 e outros)

É o único que pede chaves, porque não tem "login no site". Crie uma chave só para o TranscritorAi, com permissão mínima. Nunca use a chave raiz da AWS. A chave de acesso e o segredo são guardados cifrados e nunca são mostrados de novo.

Ter em mãos: uma conta no serviço e um bucket (a "pasta raiz" do armazenamento).

1. Crie o bucket, se ainda não tem. Anote o nome e a região (por exemplo us-east-1 ou sa-east-1).
2. No TranscritorAi: Integrações, Nuvem, Amazon S3, Conectar. Escolha o serviço, informe o bucket, a região e a permissão. O popup mostra a política de acesso mínima gerada para o seu bucket: clique em Copiar.
3. Na AWS: IAM, Usuários, Criar usuário (por exemplo transcritorai), sem acesso ao console. Abra o usuário, Permissões, Adicionar permissões, Criar política em linha, aba JSON, cole a política copiada e salve.
4. Ainda no usuário: Credenciais de segurança, Criar chave de acesso (caso de uso "aplicativo fora da AWS"). Copie a Access Key ID e a Secret Access Key. O segredo só aparece agora.
5. De volta ao TranscritorAi, cole a chave de acesso e o segredo e conclua em Conectar.
6. Clique em Testar conexão. "Conexão funcionando" significa pronto. Se aparecer que a chave alcança o bucket inteiro, a política está ampla demais: troque pela copiada do popup.

Outros serviços compatíveis: escolha Alibaba Cloud OSS, iDrive e2 ou "Outro compatível com S3" e preencha também o endereço do serviço (https), que o painel do provedor mostra. Em Região, use a que o provedor indica. No MEGA, só o MEGA S4 (compatível com S3) funciona por aqui.

• "A chave de acesso foi recusada": Access Key ou Secret errados, ou chave desativada.
• "A chave não tem permissão": a política não foi anexada, ou o nome do bucket nela não é o mesmo.
• "O bucket informado não existe nesta região": nome ou região trocados.
• Revogar de vez: no IAM, desative ou apague a chave de acesso.

Provedores que aparecem como indisponíveis

iCloud Drive, Proton Drive e NordLocker: a empresa não oferece acesso a aplicativos externos. MEGA comum: em análise de segurança (use o MEGA S4 pelo S3).

Transforme em texto os documentos que você já guarda na nuvem. Não existe um login novo: a aba Documentos usa a mesma conexão da aba Nuvem, só com a permissão mínima para ler o que você escolher. Cada documento tem o seu botão Conectar, com o passo a passo dele.

Google Docs, Sheets e Slides, uns 2 minutos

Ter em mãos: a conta Google onde estão os documentos.

1. Integrações, Documentos, clique em Conectar na linha do documento e depois em Conectar a conta Google.
2. Na janela do Google, escolha a conta, leia a permissão e clique em Permitir.
3. A janela fecha sozinha e as três linhas do Google ficam verdes, com Conectado.
4. No Início, clique em Integrações › Google Drive, escolha os documentos no seletor do Google e confirme.
5. Os arquivos entram na fila, gastam créditos como qualquer envio e o texto fica em Meus arquivos.

O que o Google concede: só os arquivos que você escolher no seletor, nunca o Drive inteiro. O TranscritorAi não edita, não move e não apaga nenhum documento. Os documentos do Google são exportados na hora (PDF e .xlsx) só para a transcrição.

Como ver e escolher os seus documentos do Google

1. Conecte a conta Google nesta aba (botão Conectar). Quando a linha ficar verde, com “Conectado”, o acesso está liberado.
2. Vá ao Início e clique em Integrações › Google Drive.
3. Abre o seletor do Google, com a lista dos seus arquivos. Para achar o que quer, use a busca no topo ou o menu ao lado (como Recentes, Meu Drive e Compartilhados comigo).
4. Reconheça o tipo pelo ícone: azul é Documento, verde é Planilha e amarelo é Apresentação. Clique no arquivo para marcar (pode marcar vários).
5. Clique em Selecionar. O TranscritorAi só enxerga os arquivos que você marcou aqui; o resto do seu Drive continua fechado para ele.
6. Os arquivos entram na fila e são transcritos. Quando um item ficar pronto, clique em Ver para ler o texto num popup (com o botão Copiar).
7. Os resultados também ficam em Meus arquivos, onde você pode abrir, baixar ou enviar para uma IA. O documento original continua no Google, sem nenhuma alteração.

Word, Excel e PowerPoint, uns 3 minutos

Ter em mãos: a conta Microsoft do OneDrive e o arquivo salvo lá em .docx, .xlsx ou .pptx.

1. Salve o arquivo no OneDrive. Arquivos antigos (.doc, .xls, .ppt) precisam ser salvos como .docx, .xlsx ou .pptx.
2. Integrações, Documentos, clique em Conectar na linha do documento e depois em Conectar a conta Microsoft.
3. Na janela da Microsoft, escolha a conta, entre, leia a permissão (ler os seus arquivos) e aceite.
4. A janela fecha sozinha e as três linhas da Microsoft ficam verdes, com Conectado.
5. Clique em Escolher arquivos para transcrever, marque os arquivos e clique em Transcrever. O botão Integrações, no Início, abre a mesma lista.

O que a Microsoft concede: só a permissão de leitura dos arquivos do seu OneDrive. O TranscritorAi não grava, não edita e não apaga nada, e não lê e-mails, calendário nem contatos. Funciona com conta pessoal e com conta de trabalho ou escola.

Quando algo não funciona

• O botão Integrações › Google Drive não aparece no Início: atualize a página depois de conectar. Se continuar escondido, o seletor de arquivos do Google ainda não foi ativado neste servidor.
• A janela da Microsoft pede aprovação do administrador: é uma conta de trabalho ou escola. Peça a quem administra a conta para liberar o aplicativo do TranscritorAi e tente de novo.
• Arquivo .doc, .xls ou .ppt: o formato antigo não é lido. Abra o arquivo e salve como .docx, .xlsx ou .pptx.
• Arquivo protegido por senha: tire a senha antes de importar.
• O OneDrive está conectado só para guardar: abra um documento da Microsoft, clique em Conectar de novo e aceite a permissão de leitura.
• Quer tirar o acesso: use Gerenciar na aba Nuvem. O que o TranscritorAi já converteu continua em Meus arquivos.

Dois usos, sempre com a sua conta na ferramenta, e o TranscritorAi nunca altera nem apaga tarefas que já existem. Enviar para projeto transforma a ata de uma transcrição em tarefas, e você revisa tudo antes de criar. Importar tarefa pelo link (Trello e Jira) lê uma tarefa cujo link você colou no campo de links do Início e transcreve os anexos que você escolher. Para extrair tarefas é preciso uma chave de IA sua (veja IA e chaves). Plataformas: Trello, Jira, Linear, Asana, ClickUp, monday.com e Azure DevOps. Todas mostram Conectar e o passo a passo; "Disponível" quer dizer que dá para entrar agora, e "Em ativação" que o TranscritorAi ainda está concluindo a ativação (nada a configurar do seu lado). O Jira é só o Jira Cloud, o Azure DevOps exige conta corporativa ou escolar, o ClickUp tem acesso amplo (não há níveis de permissão) e, no monday.com, o Conectar leva primeiro à instalação do app e depois à autorização.

Conectar

1. Integrações, Projetos, (plataforma), Conectar.
2. Em Acesso, escolha Ler e criar tarefas (necessário para criar de verdade) ou Somente leitura.
3. Na janela da plataforma, entre, escolha o workspace ou a equipe (e, onde pedir, os quadros) e aceite. A página mostra a conta conectada.

Usar

1. Em Meus arquivos, abra a transcrição e clique em Enviar para projeto.
2. Escolha a conta conectada e o destino: quadro e lista no Trello, workspace e projeto no Asana, time no Linear, espaço e lista no ClickUp, site e projeto no Jira, quadro e grupo no monday.com, organização e projeto no Azure DevOps.
3. Informe os participantes (opcional, separados por vírgula): ajuda a atribuir cada tarefa à pessoa certa.
4. Clique em Extrair tarefas, revise (título, responsável e prazo), marque só as que quer e crie. Cada tarefa aparece como criada (com link para abrir) ou como "já existia, não duplicada".

Importar tarefa pelo link (Trello e Jira)

1. No Início, cole um link de tarefa no campo de links (vários links continuam indo para a lista). Se você ainda não conectou a ferramenta, o popup oferece Conectar.
2. Na prévia, veja o texto lido (grátis), marque os anexos e confira a estimativa de créditos antes de baixar. Áudio, vídeo e PDF gastam créditos.
3. Clique em importar: o TranscritorAi transcreve e monta o documento final, que você copia ou baixa. Ele só lê: nada é escrito na ferramenta, e o texto lido some do nosso banco em 7 dias.

Trello com o seu próprio app (opcional)

Por padrão o Trello usa o app do TranscritorAi. Para usar um app seu, com limite e acesso seus, cadastre-o em Integrações, IA e chaves, Trello com o meu próprio app:

1. Em trello.com/apps/admin, crie um app com o nome que quiser.
2. Na aba OAuth 2.0, escolha o tipo Confidencial.
3. Em URL de retorno, cole o endereço que o painel do TranscritorAi mostra. Ele precisa ser idêntico, sem barra no fim.
4. Escopos: read:board:trello, write:board:trello e read:member:trello.
5. Copie o Client ID e o Client secret, cole nos campos e salve. Depois conecte o Trello normalmente: ele passa a usar o seu app. O secret é guardado cifrado.

Essa credencial não é testada ao salvar: o Trello só valida o par quando você autoriza o acesso, então conectar já é o teste. Apagar o app daqui desfaz o acesso das contas conectadas com ele.

Revogar de vez: Trello e Jira em id.atlassian.com/manage-profile/security, Asana em Configurações, Aplicativos, Linear em Settings, Account, Applications, ClickUp em Configurações, Apps; no monday.com e no Azure DevOps, na área de aplicativos autorizados da sua conta.

Aqui ficam as suas chaves de IA, usadas para extrair tarefas das transcrições. O custo é seu, cobrado pelo provedor da IA. A chave é guardada cifrada, num cofre com chave de criptografia própria, e nunca é mostrada de novo: o painel exibe só o final dela. Se o servidor não tiver o cofre ligado, o recurso fica desligado em vez de guardar a chave sem cifra.

Regra de ouro: a assinatura (Claude Pro, ChatGPT Plus, Gemini Advanced, Perplexity Pro) não é a chave de API. A chave de API é criada no painel de desenvolvedor do provedor e cobrada à parte, por uso. Coloque um limite de gasto no painel.

O modo padrão é "Eu uso a minha chave (o custo é meu)". O modo "O TranscritorAi cuida de tudo" só aparece se o servidor o ligar e exige que você aceite o preço. O TranscritorAi usa a primeira chave válida, na ordem Anthropic, OpenAI, Gemini, Perplexity, DeepSeek.

Passo a passo (igual para todos)

1. Integrações, IA e chaves, Anthropic (Claude), Conectar. Os outros provedores aparecem no mesmo painel.
2. Gere a chave no painel do provedor e copie na hora: ela só aparece uma vez.
3. Cole em "Cole a chave aqui" e clique em Salvar chave.
4. O TranscritorAi testa a chave na hora, com uma consulta mínima ao provedor. Funcionando: pronto. Não foi possível testar agora: a chave ficou salva, mas o provedor não respondeu (rede, limite ou falta de saldo), use Testar mais tarde. Recusada pelo provedor: chave errada, expirada ou revogada, cadastre uma nova.
5. Apagar remove a chave do TranscritorAi, mas não a revoga no provedor. Para isso, apague-a também no painel dele.

Se a extração de tarefas falhar: "chave recusada" pede uma chave nova, "não foi possível ler a chave guardada" pede que você cadastre de novo, e "sem chave" pede que você cadastre a sua.

Não é uma conexão que você cria aqui: é a lista dos sites em que você pediu para lembrar o login.

1. Transcreva uma página que peça senha.
2. No popup de login que aparecer, entre no site e marque salvar login.
3. Nas próximas transcrições desse site o login entra sozinho, sem popup.
4. Em Integrações, Logins você vê os sites salvos e clica em Remover para apagar um.

O usuário e a senha ficam cifrados, não aparecem de novo na tela e são usados só para esse site. Remover apaga o registro. Se você trocar a senha no site, a próxima transcrição pede o login de novo.

Não resolveu? Abra o Suporte informando a integração e a mensagem exata da tela. Nunca inclua a chave ou a senha.

Resumo: o que você precisa ter em mãos