A forma mais fácil de atualizar os vídeos de documentação do seu SaaS sem regravar a tela

Pela equipe DashCast · · 9 min de leitura
A forma mais fácil de atualizar os vídeos de documentação do seu SaaS sem regravar a tela

Seu produto lança novidades a cada sprint. Seus vídeos tutoriais, não. Em poucas versões, o botão do vídeo mudou de lugar, o menu ganhou outro nome e os clientes que acompanham o vídeo se perdem. Este guia explica por que isso se repete, o que as ferramentas atuais fazem a respeito e uma abordagem diferente: escrever seus vídeos tutoriais em vez de gravá-los, para que atualizar um deles seja só editar uma linha e clicar em Renderizar.

O problema: a documentação em vídeo envelhece mais rápido que a de texto

Documentação em texto é fácil de corrigir. Alguém abre o artigo de ajuda, muda uma frase e salva. Documentação em vídeo não funciona assim. Um vídeo tutorial é a gravação de um momento da vida do seu produto e, no instante em que a interface muda, a gravação fica errada.

Corrigir costuma significar fazer tudo de novo:

Multiplique isso por cada aula que passa pela tela que você acabou de redesenhar. A maioria das equipes não dá conta, e os vídeos ficam desatualizados em silêncio. Os clientes percebem, confiam menos na documentação e abrem um chamado de suporte. Os vídeos que deveriam reduzir o suporte acabam gerando mais trabalho.

O custo real não está em fazer o primeiro vídeo. Está em manter cinquenta vídeos corretos ao longo de cinquenta versões.

O que as ferramentas de “gravar uma vez” resolvem — e o que não resolvem

Uma nova geração de ferramentas promete que você só precisa gravar uma vez. Você percorre um fluxo uma única vez e a IA transforma essa captura em um resultado caprichado: roteiro gerado, voz sintética, efeitos de zoom, legendas e, às vezes, um guia escrito passo a passo.

É uma melhora real em relação a editar gravações brutas à mão. Mas, olhando o fluxo de perto, uma coisa não mudou: uma pessoa ainda precisa clicar pelo seu produto para criar o material de origem. E, quando a interface muda, essa captura já não corresponde ao produto. Dependendo da ferramenta, você grava o fluxo de novo ou corrige as capturas uma a uma.

“Gravar uma vez” muda o trabalho de lugar. Não elimina a gravação e não resolve o problema da atualização.

Uma abordagem diferente: escreva o vídeo e deixe um navegador executá-lo

A DashCast tira a pessoa da gravação por completo. Em vez de capturar sua tela, você descreve o vídeo como um roteiro: o que o narrador diz e o que acontece na tela enquanto ele fala — onde clicar, o que digitar, o que destacar ou ampliar.

Quando você clica em Renderizar:

  1. A voz vem primeiro. Sua narração vira uma fala natural com IA, com o tempo de cada palavra.
  2. Um navegador automatizado grava as cenas. Ele abre seu aplicativo web, entra com uma conta de teste e executa cada ação em sincronia com a voz — com cursor suave, zooms e destaques.
  3. As legendas são sincronizadas palavra por palavra e tudo é montado em um vídeo pronto.
  4. Você revisa e publica em uma página para seus clientes com um clique.

Ninguém toca no mouse nem no microfone. E, como o vídeo nasce de um roteiro, ele pode ser produzido de novo a qualquer momento — do mesmo jeito, com a mesma qualidade — sobre a versão atual do seu produto.

Três formas de obter um roteiro

Um roteiro não é só para desenvolvedores. Cole o link do seu site e deixe a IA do DashCast escrevê-lo, deixe a ferramenta de IA que você já usa escrevê-lo a partir do código, ou desenhe-o você mesmo no Designer de cenas — ou combine: a IA faz o rascunho, você ajusta.

1. Cole o link do seu siteA IA do DashCast entra com a sua conta de teste, lê as páginas, escreve o roteiro e verifica cada clique no seu site real.
2. Seu assistente de programação com IACopie um prompt pronto para a ferramenta de IA que você já usa no projeto. Ela lê suas rotas, templates e botões e escreve o roteiro — ou uma série inteira.
3. Designer de cenasUm editor no estilo de montagem. Ouça a voz real, veja a tela de cada cena e fixe as ações na palavra exata em que devem acontecer.

O link do seu site: a IA escreve e verifica a lição

Dê ao DashCast o link do seu site, um acesso de teste e uma frase sobre o que a lição deve explicar. A IA entra, lê até 15 páginas do seu aplicativo, escreve cada cena e depois verifica cada clique no seu site real, corrigindo o que não encontra. Costuma levar poucos minutos, e o resultado abre no Designer de cenas, pronto para ajustar ou renderizar. Veja como funciona.

Seu assistente de IA: nem o roteiro

O jeito mais rápido é não escrever o roteiro. A DashCast gera um prompt que descreve exatamente como os roteiros funcionam. Você o cola na ferramenta de programação com IA que já usa dentro da pasta do projeto. Como essa ferramenta lê seu código — rotas, templates, IDs de elementos, contas de demonstração —, ela escreve seletores que realmente batem com suas telas e uma narração que descreve o que de fato está lá. Para um curso inteiro, ela pode escrever um único arquivo com muitas aulas, importado em um passo. Depois de uma renderização com falha, o prompt inclui os erros da última execução para que o assistente devolva um arquivo corrigido.

Designer de cenas: edite como um vídeo, não como um formulário

Algumas pessoas pensam em tempo: “o clique precisa acontecer exatamente quando eu disser Exportar”. Designer de cenas mostra cada cena como uma faixa com a voz gerada, as palavras distribuídas no tempo e uma prévia da tela. Você arrasta as ações pela faixa, ouve a voz e ativa Fixar às palavras para que a ação fique presa à sua palavra mesmo que você reescreva a frase ao redor. «Escolher no ecrã» permite escolher um elemento só com um clique, e Carregar pré-visualização captura os seus ecrãs reais e assinala qualquer botão que já não encontra — antes de renderizar.

Por baixo: um pequeno ficheiro de texto

Para os curiosos da parte técnica: cada vídeo fica guardado num pequeno ficheiro de texto (YAML) — nunca precisa de lhe tocar. Eis uma cena completa:

scenes:
  - url: /invoices
    login_as: admin
    narrate: |
      Open Invoices and press New invoice.
      Pick a customer, add a line, and save. That's it.
    actions:
      - { at: 1.0, do: click,     target: "#btn-new" }
      - { at: 3.2, do: type,      target: "#customer", value: "Lisbon Coffee Roasters" }
      - { at: 5.0, do: blur,      target: ".customer-email" }
      - { at: 6.4, do: highlight, target: ".total", for: 2 }
      - { at: 8.0, do: click,     target: "button[type=submit]" }

Lê-se quase como um storyboard: uma página, uma narração e uma lista de ações com tempo marcado. Como é texto puro, você pode guardá-lo no Git ao lado do código e revisar uma mudança num vídeo do mesmo jeito que revisa uma mudança no produto.

Atualizar um vídeo quando a interface muda

É aqui que escrever vence gravar. Imagine que a próxima versão renomeie o botão “Nova fatura” e lhe dê um novo ID. Com uma gravação, a aula precisa ser refeita. Com um roteiro, a mudança é uma linha:

  actions:
-   - { at: 1.0, do: click, target: "#btn-new" }
+   - { at: 1.0, do: click, target: "[data-action=create-invoice]" }

Clique em Renderizar e o navegador executa a aula de novo na nova interface, com a mesma voz, o mesmo ritmo e o mesmo visual. Se o texto também mudou, edite a frase; voz e legendas são geradas de novo para acompanhar. Várias aulas podem renderizar em paralelo, então atualizar uma biblioteca inteira depois de um grande redesenho leva uma tarde de edições, não semanas de regravação.

Dica: dê aos botões importantes do seu aplicativo atributos estáveis como data-test ou data-action. Seus roteiros — e seus testes de ponta a ponta — vão sobreviver a redesenhos sem nenhuma alteração.

Como a DashCast se compara às ferramentas existentes

Cada ferramenta abaixo é boa em alguma coisa. A pergunta é para qual trabalho você a contrata. Se o trabalho é uma biblioteca de tutoriais do produto que continue correta depois de cada versão, a pergunta decisiva é: o que você precisa fazer quando a interface muda?

AbordagemQuem faz os cliquesVoz e legendasQuando a interface mudaMelhor para
Gravadores de telaex.: Loom, Camtasia Você, ao vivo, toda vez Seu próprio microfone; legendas adicionadas depois Gravar o vídeo de novo Explicações rápidas pontuais e mensagens assíncronas
Ferramentas de IA de “gravar uma vez”ex.: Guidde, Scribe, Trupeer, Clueso Você, uma vez por versão do fluxo Voz com IA e legendas geradas a partir da sua captura Capturar o fluxo de novo ou corrigir etapas à mão Transformar rápido uma gravação em guia ou vídeo caprichado
Criadores de demos interativasex.: Arcade, Supademo, Storylane Você, uma vez, para capturar as telas Principalmente balões de texto; voz opcional Capturar de novo as telas afetadas Demos clicáveis de marketing e tours pelo produto
Vídeo com avatar de IAex.: Synthesia, HeyGen Ninguém — mas as telas do produto ainda precisam ser gravadas e inseridas Apresentador e voz com IA Regravar as partes de tela e gerar de novo Treinamentos e comunicados com apresentador
DashCastautomação de navegador por roteiro Ninguém — um navegador automatizado, a partir do seu roteiro Voz com IA e legendas sincronizadas por palavra, geradas juntas Editar uma linha e clicar em Renderizar Bibliotecas de tutoriais para software web que muda com frequência

Para ser justo com os limites: a DashCast grava aplicações web — tudo o que abre em um navegador. Se você precisa filmar um aplicativo de desktop ou celular, ou quer uma explicação rápida e pessoal com seu rosto e sua voz, um gravador de tela continua sendo a ferramenta certa. E se o objetivo é uma demo clicável em um site de marketing, os criadores de demos interativas foram feitos exatamente para isso.

O que você ganha, além de não gravar

Perguntas frequentes

Preciso saber programar para usar a DashCast?

Não. Cole o link do seu site e a IA do DashCast escreve e verifica o roteiro para você; também pode obtê-lo da ferramenta de IA que já usa no projeto, ou criá-lo você mesmo no Designer de cenas — sem código em nenhum caso. Nos bastidores é um arquivo de texto curto (YAML), mas você nunca precisa editá-lo.

Funciona com qualquer aplicação web?

Se abre no navegador, a DashCast consegue gravar: painéis SaaS, sistemas ERP e CRM, painéis de administração, lojas virtuais, ferramentas internas. Aplicativos de desktop e celular não são suportados.

O que acontece quando minha interface muda?

Você altera a linha que aponta para o botão antigo ou a frase que o descreve e clica em Renderizar de novo. Nada é regravado, e as outras cenas continuam como estavam.

Como ela entra no meu aplicativo?

Com uma conta de teste que você fornece. A senha fica guardada como valor secreto e nunca aparece no vídeo nem no roteiro.

Posso esconder dados de clientes que aparecem na tela?

Sim. Uma ação de desfoque esconde qualquer elemento antes de ele aparecer, então nomes, e-mails ou números privados nunca chegam ao vídeo.

Em quais idiomas a narração pode ser feita?

Hoje as aulas podem ser narradas e legendadas em 14 idiomas, entre eles português, inglês, árabe, francês, alemão, espanhol, russo, turco e hindi.

Pare de gravar. Comece a escrever.

Assista a um vídeo tutorial em que nenhuma pessoa clicou — e veja como o roteiro dele é curto.