Blog

Como escrever um relatório de bug com capturas que o dev consegue usar

Publicado em 24 de outubro de 2026 · relatório de bug, QA, capturas de tela

Um relatório de bug acionável tem os passos exatos, uma captura da janela inteira, o texto do erro e uma gravação curta. Um guia prático para QA, suporte e PMs.

Uma captura de tela sozinha raramente resolve alguma coisa. O que faz um bug ser corrigido é um relatório que o desenvolvedor consegue reproduzir: os passos exatos, o que você viu e o que esperava em vez disso. Uma captura torna isso visível, mas só quando mostra contexto suficiente, não um recorte apertado do texto do erro.

Este guia é para testadores de QA, equipes de suporte e product managers. Ele cobre o que capturar, como escrever passos reproduzíveis, como esconder dados pessoais e quando uma gravação curta é a resposta mais rápida.

O que uma captura útil mostra

Capture a janela inteira, incluindo a barra de título, a barra de ferramentas e qualquer caixa de diálogo aberta. Um recorte em volta da mensagem de erro esconde a versão do app, o menu que estava aberto e a página em que você estava — os detalhes de que o desenvolvedor precisa para reproduzir o problema.

Para apps web, inclua o console do navegador: abra as ferramentas de desenvolvedor do navegador e mude para a aba Console. Se uma requisição falhou em segundo plano, o motivo costuma aparecer ali e nunca na página.

Mostre o estado exato: o próprio texto do erro, o campo que rejeitou a sua entrada, o menu que estava aberto. Não redigite a mensagem de memória; copie da tela.

Marque o ponto em vez de descrevê-lo. Um círculo, uma seta ou um número levam o desenvolvedor direto ao problema.

O InSnap torna isso rápido: pressione ⌘1 no Mac ou Ctrl+1 no Windows, passe o mouse sobre a janela que quer e clique. A seleção encaixa na janela e, em muitos apps, no botão sob o cursor. Anote com Formas, Linhas, Texto e Números e depois copie o resultado. Enquanto você escreve, copie a captura e pressione ⌘2 ou Ctrl+2 para fixá-la sobre o seu editor.

Escreva passos que o desenvolvedor consegue repetir

1. Comece de um estado conhecido. "Desconectado, nova aba do navegador, sem extensões" diz ao desenvolvedor o que redefinir.
2. Uma ação por passo, usando os rótulos na tela: "Clique em Salvar", "Escolha Exportar › PDF". Não parafraseie.
3. Registre o que aconteceu e o que você esperava. "A caixa de diálogo fechou sem salvar" é acionável; "não funcionou" não é.
4. Liste o ambiente: a versão do sistema, a versão do app e se o bug acontece sempre ou só às vezes.
5. Coloque a captura ao lado do passo a que ela pertence. Se tirou várias, numere-as do mesmo jeito na tela.

Dê ao relatório um título que declare o sintoma, não um palpite sobre a causa: "Exportar para PDF nunca termina", não "o exportador está quebrado".

Esconda dados pessoais antes de enviar

Nomes de clientes, endereços de e-mail, números de conta, tokens em uma URL, rostos e mensagens privadas não têm lugar em um rastreador de bugs. Desfocque-os ou aplique mosaico antes de anexar o arquivo, e confira também as bordas da tela: abas do navegador, notificações e caminhos de arquivo costumam vazar mais do que a janela principal.

A ferramenta Mosaico do InSnap inclui Desfoque. Para remover algo por completo, o Apagar inteligente preenche a área a partir do plano de fundo ao redor; ele funciona bem em fundos lisos, com gradiente e de interface, mas não é confiável em fotos cheias de detalhes ou quando a cor do objeto está próxima da cor do fundo. O Apagar inteligente faz parte do Pro; mosaico e desfoque são gratuitos.

Tudo isso acontece no seu computador. O InSnap não envia uma captura de tela a lugar nenhum, a menos que você escolha compartilhá-la pela assinatura opcional do Cloud.

Anexe uma gravação curta quando as palavras não bastam

Alguns bugs são uma sequência: uma lista suspensa que pisca, um arrasto que solta no lugar errado, uma página que carrega e então salta. Alguns segundos de vídeo valem mais que um parágrafo.

O InSnap grava uma região da tela com opções de áudio do sistema, microfone, câmera, efeitos de clique ou uma sobreposição de teclas. As sobreposições de clique e de teclas são especialmente úteis aqui: quem assiste vê exatamente o que você pressionou. A Gravação rápida salva um MP4, e a gravação de tela básica é gratuita; saída em GIF e recursos de edição como zoom automático, câmera em picture-in-picture e exportação em qualidade original são Pro.

Mantenha o clipe curto e comece um ou dois passos antes do bug. Mesmo com uma gravação, inclua os passos escritos e uma captura estática: algumas pessoas revisam no celular ou não conseguem reproduzir vídeo.

Perguntas frequentes

O que um relatório de bug deve incluir?

Os passos exatos para reproduzir o problema, o que aconteceu, o que você esperava, as versões do app e do sistema e pelo menos uma captura da janela inteira. Adicione uma gravação curta para qualquer coisa que se mova.

Devo recortar a captura só para a mensagem de erro?

Não. Mantenha a janela inteira. A barra de título, o menu aberto e a página ao redor normalmente trazem a versão e o estado de que o desenvolvedor precisa. Marque o erro com um círculo ou uma seta em vez de recortá-lo.

Como escondo dados pessoais em uma captura de tela?

Desfocque ou aplique mosaico em nomes, e-mails, tokens e rostos antes de anexar o arquivo, e confira as bordas da janela em busca de abas do navegador e notificações. O InSnap edita no seu computador e não envia nada, a menos que você escolha compartilhar.

Um vídeo é melhor que uma captura de tela?

Eles respondem a perguntas diferentes. Uma captura mostra um estado; um vídeo mostra uma sequência. Use uma captura com passos numerados para um problema estático e uma gravação curta quando o bug envolve tempo, animação, arrasto ou cintilação.

Mais do blog