> For the complete documentation index, see [llms.txt](https://doc.3va.app.br/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://doc.3va.app.br/motivos-de-perda-configuracao-e-gerenciamento.md).

# Motivos de Perda — Configuração e Gerenciamento

Os **Motivos de Perda** são categorias personalizadas que a equipe usa para registrar **por que uma negociação não foi concluída**. Ao marcar um card como "Perda", a seleção de um motivo é obrigatória — o usuário não consegue concluir a ação sem escolher um.

Essa funcionalidade está disponível **exclusivamente em painéis do tipo Vendas**.

### Quem pode gerenciar os Motivos de Perda?

Somente **administradores da conta** ou **administradores do painel** podem adicionar, editar ou excluir motivos de perda.

Usuários sem perfil administrativo visualizam o link "Gerenciar motivos de perda" desabilitado (em cinza). Ao passar o mouse sobre ele, a mensagem exibida é: *"Apenas administradores podem gerenciar os motivos"*.

### Como acessar o gerenciamento

Há dois caminhos:

* **Pelas configurações do painel:** Na tela de criação ou edição do painel de Vendas, no bloco **"Motivos de perda"**, clique em **"Gerenciar motivos de perda"**.
* **Ao marcar um card como perda:** Dentro do modal de seleção de motivo, administradores verão o link **"Gerenciar motivos de perda"** ativo e clicável.

### Como adicionar um novo motivo

{% stepper %}
{% step %}

### Clique em **"+ Adicionar motivo"**.

{% endstep %}

{% step %}

### Digite o nome do motivo (limite de **100 caracteres**).

{% endstep %}

{% step %}

### Clique em **"Adicionar"**.

{% endstep %}

{% step %}

### O motivo aparece na lista com a indicação **"Pendente"** (em amarelo) — ainda não foi salvo.

{% endstep %}

{% step %}

### Clique em **"Salvar"** para confirmar.

{% endstep %}
{% endstepper %}

{% hint style="warning" %}
Motivos com status "Pendente" só são gravados após clicar em **"Salvar"**. Fechar a janela sem salvar descarta as alterações — o sistema pedirá confirmação antes de sair.
{% endhint %}

### Como excluir um motivo

A exclusão segue um processo com camadas de segurança para proteger o histórico:

{% stepper %}
{% step %}

### Clique no **ícone de lixeira** ao lado do motivo.

{% endstep %}

{% step %}

### Um pop-up de confirmação informa que o motivo deixará de estar disponível para novas seleções, mas **continuará visível nos cards e relatórios históricos**.

{% endstep %}

{% step %}

### Confirme. O motivo recebe a indicação **"Excluído"** (em vermelho) na lista.

{% endstep %}

{% step %}

### Clique em **"Salvar"**.

{% endstep %}

{% step %}

### O sistema envia um **código de verificação (OTP) por e-mail** para o usuário logado.

{% endstep %}

{% step %}

### Insira o código para concluir a exclusão.

{% endstep %}
{% endstepper %}

{% hint style="info" %}
Motivos excluídos **não somem dos registros históricos**. Eles continuam visíveis nos cards que já usavam esse motivo e nos relatórios de auditoria. Apenas deixam de aparecer como opção para novas perdas.
{% endhint %}

### Proteção contra alterações não salvas

Se você tentar fechar a janela de gerenciamento com alterações pendentes (adições ou exclusões não salvas), o sistema exibe o alerta:

> *"Atenção: Há alterações não salvas, deseja continuar?"*

Opções:

* **Cancelar** — mantém a janela aberta para finalizar as edições.
* **Sair sem salvar** — descarta todas as alterações e fecha a janela.

### Perda automática por inatividade

Para painéis de Vendas, é possível configurar uma regra que **marca cards como perdidos automaticamente** após um período sem movimentação. Essa opção fica nas configurações do painel, no bloco **"Marcar como perdido automaticamente"**.

| Período                    | Padrão?  |
| -------------------------- | -------- |
| 7 dias                     |          |
| 15 dias                    |          |
| 30 dias                    | ✅ Padrão |
| 60 dias                    |          |
| 90 dias                    |          |
| Não marcar automaticamente |          |


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://doc.3va.app.br/motivos-de-perda-configuracao-e-gerenciamento.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.