---
title: Reportar um bug
description: Envie um relatório de bug do admin à equipe NexCMP como ticket: formulário, o que é enviado, o que nunca é enviado, limites e soluções para erros comuns.
url: https://nexcmp.com/pt/docs/administration/report-a-bug/
applies_to: NexCMP 1.6.1
updated: 2026-11-02
---

# Reportar um bug {#report-a-bug}

> **Onde no admin:** Top bar › **Report a bug** (ao lado de Docs; exibido apenas para o administrador principal).

Encontrou uma falha no NexCMP? Clique em **Report a bug**, descreva o problema e envie. O relatório chega à equipe NexCMP como um ticket na conta da sua licença em uma única etapa — sem precisar fazer login em outro lugar nem copiar arquivos de log manualmente. Todos os planos podem usar: o NexCMP Free inclui correções de bugs, assim como o NexCMP Source.

::: info Relatórios de bug não são solicitações de suporte
O NexCMP Free não inclui suporte técnico; portanto, use este formulário para falhas no software. Ajuda com configuração e migrações fazem parte do [NexCMP Source](https://nexcmp.com/pricing).
:::

## Requisitos {#requirements}

| Item | Requisitos |
|---|---|
| Versão | NexCMP 1.5.2 ou superior |
| Quem pode enviar | A conta de administrador principal. Contas de equipe (somente leitura), consoles de revenda, clientes e a demo somente leitura não podem enviar |
| Licença | Uma licença ativada (Free ou Source) que não esteja suspensa |
| Rede | O servidor precisa alcançar `https://nexcmp.com` via HTTPS (o mesmo endereço usado para verificação de licença e atualizações) |

## Enviar um relatório {#send-a-report}

1. Clique em **Report a bug** na barra superior. No celular, abra o menu e escolha **Report a bug**.
2. Insira um **Subject** curto.
3. Em **What happened**, descreva o que você fez, o que viu e o que esperava.
4. Opcionalmente, liste os **Steps to reproduce**.
5. Escolha o **Impact**: **Blocking** (você não consegue trabalhar), **Major** (um recurso principal está quebrado) ou **Minor** (um problema pequeno ou cosmético).
6. Mantenha **Attach diagnostics** ativado (recomendado) e leia o quadro **What will be sent**.
7. Clique em **Send report**.

Na versão 1.6.1, o corpo do formulário rola enquanto os botões de ação permanecem visíveis, inclusive no celular. Valores de senha após `password:` ou `password=` são mascarados sem remover o restante do relatório. Revise seu texto antes de enviar e omita dados de clientes e credenciais.

![A caixa de diálogo Report a bug com título, descrição, impacto e a lista do que será enviado](https://nexcmp.com/pt/docs/images/administration/report-a-bug-01-dialog.webp)

Quando o relatório é aceito, a caixa de diálogo exibe o número do ticket e um link. As respostas, caso a equipe envie alguma, vão para o endereço de e-mail da sua conta de licença em nexcmp.com, e o ticket também é listado em **Support** quando você faz login como titular da licença.

## O que é enviado {#what-is-sent}

O quadro **What will be sent** mostra exatamente o seguinte antes de clicar em Send:

| Enviado | Detalhes |
|---|---|
| Seu texto | Título, descrição, etapas e impacto |
| Versão, plano, domínio | Sua versão do NexCMP, Free ou Source, e o domínio da instalação |
| Página atual | A página em que você está no admin, sem nada após `?` ou `#` |
| Navegador | O texto de user-agent do seu navegador (nome, versão e sistema operacional), limitado a 200 caracteres |
| Erros recentes | Até os últimos 5 erros nesta aba do navegador. Para erros de script, apenas a mensagem; para requisições com falha, apenas o método, o caminho e o código de status |

Você pode desativar **Attach diagnostics**; nesse caso, apenas o seu texto, a versão, o plano e o domínio serão enviados.

## O que nunca é enviado {#what-is-never-sent}

- Senhas, tokens, cookies e chaves de API. Qualquer item no seu texto ou em uma mensagem de erro que se pareça com um deles é mascarado (exibido como `***` ou `[redacted]`) no seu servidor antes do envio.
- O conteúdo de requisições e respostas — requisições com falha são registradas apenas como método, caminho e status.
- Dados dos seus clientes (nomes, e-mails, pedidos, faturas) e seus endereços IP.
- O endereço IP do seu navegador e qualquer arquivo do seu servidor. Como em toda verificação de licença, o servidor de licenças vê o endereço IP a partir do qual o seu servidor se conecta.

O ticket é vinculado à sua instalação pelo token de licença que o servidor já possui, portanto a versão, o domínio e a instalação são definidos pelo servidor e não podem ser alterados pelo navegador.

## Limites {#limits}

| Limite | Valor |
|---|---|
| Assunto | 150 caracteres |
| Descrição e etapas | 8 KB somados |
| Reports | 5 por hora e 20 por dia para toda a instalação |

O envio do mesmo relatório duas vezes (por exemplo, após um erro de rede) não cria um segundo ticket.

## Resolução de problemas {#troubleshooting}

| Mensagem | Causa | Correção |
|---|---|---|
| Ative sua licença primeiro | A instalação não possui uma licença ativada | Abra **License & updates** e ative, depois envie novamente |
| Não foi possível acessar o servidor de licenças | O servidor não consegue acessar `nexcmp.com` | Verifique o HTTPS e DNS de saída no servidor e clique em **Send report** novamente — seu texto será mantido |
| Muitos relatórios de bug desta instalação | Você atingiu 5 por hora ou 20 por dia | Aguarde e tente novamente; em vez disso, adicione novas informações ao ticket aberto |
| Esta licença está suspensa | A licença está suspensa ou foi reembolsada | Consulte [Licença e compra](https://nexcmp.com/pt/docs/getting-started/license-and-purchase/) |
| Esta instalação foi revogada | A instalação foi revogada no portal de licenças | Ative-a novamente em **License & updates** |
| Não foi possível atualizar o token de licença | O servidor não conseguiu renovar seu token de licença | Abra **License & updates**, clique em **Refresh** e envie novamente |
| Nenhum botão Report a bug | Você está conectado com uma conta de equipe, revendedor ou cliente, ou na demo somente leitura | Faça login como o administrador principal |

::: tip Para o assistente de IA e chaves de API
O assistente no admin e as chaves de API de admin não podem enviar relatórios de bug em seu nome: o botão requer uma pessoa conectada como o administrador principal.
:::