> For the complete documentation index, see [llms.txt](https://docs.yoplanning.support/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.yoplanning.support/pt/academia-yoplanning/yoplanning-au-quotidien/gerer-les-reservations-avec-yoplanning/suivre-les-niveaux-obtenus-par-vos-clients.md).

# Acompanhe os níveis alcançados por seus clientes

O recurso **Níveis** permite acompanhar o progresso dos seus clientes. Você define a lista de níveis para sua academia (por exemplo, **1ª Estrela**, **2ª Estrela**, **Filhote de Urso**, etc.), indica a qual nível cada produto leva e, ao final da sessão, seus instrutores registram quem **teve sucesso** ou **não conseguiu**. Dessa forma, cada cliente mantém seu histórico de níveis, que pode ser visualizado em seu perfil.

***

### Defina seus níveis

#### Crie a lista de níveis.

1. No menu à esquerda, clique em **Administração** e, em seguida, em **Configuração**.
2. Na seção **Clientes**, clique em **Níveis**.
3. Clique em **Adicionar** e insira as seguintes informações:
   * **Nome interno**: o nome do nível conforme sua equipe o verá no Yoplanning (registros de clientes, filtros, exportações).
   * **Rótulo**: o nome do nível em cada um dos seus idiomas.
4. Clique em **Salvar**.

Para alterar a ordem de exibição dos níveis nas listas, abra o menu **"três pontos"** na lista de níveis e escolha **Classificar**, depois arraste os níveis para a ordem desejada.

#### Associar um nível a um produto

Um produto pode permitir que você alcance um nível.

1. No menu à esquerda, clique em **Administração** e, em seguida, em **Produtos**.
2. Abra o produto em questão.
3. Na seção **Descrição do Produto**, em **Categoria**, escolha o nível na lista **Nível Alcançado**.
4. Salve o produto.

O nível se aplica imediatamente a todas as sessões deste produto, passadas e futuras. Selecione **---** para impedir que um produto conceda qualquer nível.

***

### Insira os resultados ao final de uma sessão.

1. Na programação, clique na sessão para abrir os detalhes.
2. Um cartão de **Níveis** aparece abaixo do produto quando ele permite que você alcance um nível. Ele exibe:
   * uma marca de seleção verde e o número de sucessos (por exemplo, **3/5 sucessos**) se os resultados já tiverem sido inseridos;
   * Caso contrário, será exibido um aviso: **Ainda não inserido**.
3. Clique em **Editar**: a lista de participantes da sessão será exibida.
4. Para cada participante, escolha **Sucesso** ou **Falha**.
5. Para adicionar um comentário (por exemplo, "Ele está quase lá, só mais um esforço"), clique no ícone de balão de fala no final da linha e digite seu texto.
6. Clique em **Salvar**.

Abaixo do nome do nível, a janela pop-up indica o número de participantes e a data da última gravação (**Gravado em...**), ou **Nunca gravado** se nenhum resultado tiver sido inserido ainda.

{% hint style="info" %}
**Primeira entrada**: enquanto nenhum resultado tiver sido registrado, todos os participantes serão marcados como **Bem-sucedidos** por padrão. Você só precisa indicar as falhas.

**Entradas subsequentes**: Cada participante exibe o resultado registrado. Um participante adicionado à sessão após a primeira entrada não tem um resultado selecionado: você deve escolher **Sucesso** ou **Falha** para ele; caso contrário, a entrada será rejeitada.
{% endhint %}

Nomeadamente:

* Para um curso com duração de vários dias, a data utilizada para o nível é a da **última sessão** do curso.
* Ao salvar novamente, os resultados anteriores desses participantes para esta sessão serão substituídos. Os resultados de outras sessões nunca serão alterados.
* Um cliente pode ter vários resultados para o mesmo nível, por exemplo, uma reprovação seguida de um sucesso em um curso subsequente.

***

### Veja os níveis de um cliente

Abra o **Perfil do Cliente** de um participante: o cartão **Níveis** lista, para cada nível tentado, o **último resultado** (**Aprovado** ou **Reprovado**), a data e quaisquer comentários. Os níveis são listados do mais antigo para o mais recente.

* A data **em azul** é um link: clique nela para abrir a sessão onde o nível foi avaliado. A seta para voltar na sessão o levará de volta ao registro do cliente.
* Uma data **em cinza** corresponde a um nível inserido manualmente (veja abaixo).

O cartão **Níveis** só aparece se o cliente tiver pelo menos um resultado.

***

### Adicione um nível obtido em outro lugar.

Um cliente pode ter alcançado um nível fora das suas sessões: em outra escola ou antes de você usar o Yoplanning. Você pode adicioná-lo manualmente ao perfil dele.

1. Abra o **Arquivo do Cliente**.
2. Clique no menu **"três pontinhos"** no canto superior direito e escolha **Gerenciar níveis**.
3. A janela pop-up exibe o **histórico completo** dos níveis do cliente, conforme consta no registro do cliente.
4. Clique em **Adicionar** e insira as seguintes informações:
   * **Nível** ;
   * **Data de obtenção**;
   * **Comentário** (opcional).
5. Clique em **Salvar**. O nível será salvo como **Concluído com Sucesso**.

Nesta janela pop-up, os níveis inseridos manualmente têm um botão de **editar** (ícone de lápis) e um botão de **excluir** (ícone de lixeira). Os resultados inseridos durante uma sessão não podem ser modificados ou excluídos aqui: abra a sessão (clicando na data) e edite-os no cartão **Níveis** correspondente.

***

### Encontre seus participantes por nível

#### Na lista de sessões

1. No menu à esquerda, clique em **Sessões** e, em seguida, abra a **Lista de sessões**.
2. Clique em **Mais filtros** e escolha um **Nível**: somente as sessões de produtos que permitem atingir esse nível serão exibidas.

#### Na lista de participantes

1. No menu à esquerda, clique em **Sessões** e, em seguida, abra a **Lista de participantes**.
2. Clique em **Mais filtros** e escolha um **Nível**. Um segundo filtro, **Resultado**, aparecerá ao lado (ambos os filtros ficarão destacados em azul):
   * **Todos**: todos os participantes nas sessões que permitem alcançar este nível;
   * **Sucesso**: participantes que atingiram o nível exigido durante esta sessão;
   * **Reprovados**: participantes que não obtiveram êxito nesta sessão;
   * **Não inserido**: participantes para os quais ainda não foram inseridos resultados para esta sessão.

#### Na exportação da lista de participantes

A partir da lista de participantes, o menu **"três pontos"**, seguido de **Exportar dados**, gera um arquivo contendo duas colunas adicionais, logo após a coluna **Produto**:

* **Nível**: o nível que o produto da sessão permite alcançar;
* **Nível alcançado**: **Sim**, **Não** ou **N/A** se ainda não houver resultados inseridos para este participante e esta sessão.

As duas colunas permanecem vazias para um produto que não permite nenhum nivelamento. Elas só aparecem na exportação se a sua estrutura tiver criado pelo menos um nível.

***

### Quem pode fazer o quê?

O acesso depende dos direitos de função de cada membro da equipe (**Administração** > **Funções**):

| Ação                                                                         | Direito necessário                                                                            |
| ---------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------- |
| Criar, editar, classificar ou excluir níveis                                 | **Gerenciamento de equipe**                                                                   |
| Insira os resultados de uma sessão.                                          | Veja a sessão e **veja os clientes** (arquivo completo ou apenas os clientes dessas sessões). |
| Verifique os níveis no arquivo do cliente.                                   | **Ver clientes** (arquivo completo ou apenas clientes destas sessões)                         |
| Use a opção **Gerenciar níveis** (adicione, modifique e exclua manualmente). | **Criar/editar clientes**                                                                     |

***

### Dicas de utilização e boas práticas

* **Verificação semanal**: na **Lista de participantes**, filtre a semana passada com **Resultado** = **Não inserido** para identificar as sessões cujos resultados ainda não foram inseridos.
* **Cursos de treinamento com vários dias de duração:** Insira os resultados ao final do curso, de qualquer uma de suas sessões. O registro se aplica ao curso inteiro.
* **Comentários**: Essas informações constam no registro do cliente. Elas são úteis para o instrutor que orientará o cliente durante o próximo curso.
* **Remover um nível**: ele é removido dos produtos que permitiram sua obtenção e não aparece mais nos registros de clientes, em filtros ou em exportações.

***

### Erros comuns e soluções

#### O cartão de Níveis não aparece nos detalhes da sessão.

* **Motivo**: O produto da sessão não permite que você obtenha nenhum nível, a sessão é uma sessão de **Planejamento de IA** (modelo de sessão potencial, sem participantes) ou você não tem o direito de atender os clientes.
* **Solução**: associe um nível ao produto (**Nível obtido** na **Descrição do Produto**), ou abra a sessão reservada gerada pela Agenda de IA.

#### O registo dos resultados é recusado.

* **Causa**: Um ou mais participantes não selecionaram **Sucesso** ou **Falha**. Isso ocorre quando um participante é adicionado à sessão após uma entrada inicial.
* **Solução**: Escolha um resultado para cada participante e salve novamente.

#### A opção "Gerenciar níveis" não aparece no menu do registro do cliente.

* **Causa**: Sua estrutura ainda não criou nenhum nível ou sua função não tem permissão para **Criar/editar clientes**.
* **Solução**: crie seus níveis (**Administração** > **Configuração** > **Níveis**) ou peça a um administrador para alterar sua função.

#### Não é possível modificar ou excluir um nível em "Gerenciar Níveis".

* **Causa**: Este resultado foi inserido a partir de uma sessão (a data está em azul).
* **Solução**: Clique na data para abrir a sessão e modificar o resultado no cartão **Níveis**.

#### Um nível que acabei de criar não está aparecendo nos filtros.

* **Causa**: A lista de níveis de filtro é carregada quando o Yoplanning é aberto.
* **Solução**: Recarregue a página do seu navegador.


---

# 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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.yoplanning.support/pt/academia-yoplanning/yoplanning-au-quotidien/gerer-les-reservations-avec-yoplanning/suivre-les-niveaux-obtenus-par-vos-clients.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
