# Gamificação

> A aba Gamificação em Membros, para o proprietário e o administrador. Como ligar e desligar os pontos da comunidade, quanto vale cada ação, o que acontece com os pontos já conquistados e a diferença para o Ranking Global.

A **Gamificação** decide se a participação na comunidade vale pontos e quanto vale cada ação: publicar, comentar, curtir, ir a um evento, completar uma aula. Os pontos alimentam o [Ranking](/espacos/ranking) e os níveis dos membros.

Fica em **Membros › Gamificação**: *"Pontos por participação, que alimentam o Ranking e os níveis dos membros."*

![Membros › Gamificação](/screens/gamificacao.png "A chave Ativa e os pontos de cada ação, com o valor padrão.")

## Para que serve

| Comunidade | Como ajustar os pontos |
|---|---|
| Escola online | Dar mais peso a **Completar aula** do que a **Curtir publicação**, para premiar quem estuda |
| Comunidade de clientes | Valorizar **Responder comentário**, para reconhecer quem ajuda os outros |
| Comunidade de eventos | Subir **Participar de evento**, para premiar quem aparece |
| Comunidade que não quer competição | Desligar a gamificação |

## Quem pode

**Proprietário** e **administrador**. Moderador e financeiro não veem a aba.

## Como funciona

### Ligar e desligar

A chave no alto da aba mostra **Ativa** ou **Desligada**. A gamificação já vem ativa quando a comunidade é criada.

Desligada, *"nenhuma ação conta ponto. Os pontos já conquistados continuam guardados."* Ao ligar de novo, as ações voltam a contar a partir dali; o que aconteceu enquanto estava desligada não conta.

### Pontos por ação

Cada ação tem o seu valor, um número inteiro de 0 para cima. Os valores padrão:

| Ação | Pontos |
|---|---:|
| Login diário | 1 |
| Criar publicação | 10 |
| Curtir publicação | 1 |
| Comentar publicação | 5 |
| Responder comentário | 3 |
| Receber curtida | 2 |
| Criar evento | 20 |
| Participar de evento | 20 |
| Criar curso | 30 |
| Inscrever-se em curso | 10 |
| Completar aula | 25 |

Mudar um valor *"vale a partir da próxima ação; os pontos já conquistados não mudam."* Uma ação com **0** deixa de dar pontos, sem desligar as outras.

### Gamificação e Ranking Global

São duas chaves diferentes:

| Chave | Onde | O que faz |
|---|---|---|
| **Gamificação** | **Membros › Gamificação** | Se as ações contam pontos |
| **Ranking Global** | **Configurações › Geral** | Se o ranking da comunidade inteira aparece para os membros |

Com a gamificação desligada, o ranking para de mudar, porque ninguém ganha pontos novos.

## Passo a passo

### Mudar quanto vale uma ação

*Papel: proprietário ou administrador.*

1. **Membros › Gamificação**.
2. Em **Pontos por ação**, mude o número ao lado da ação (por exemplo, **Completar aula** para *40*).
3. **Salvar**. Aparece *"Salvo."*

### Desligar a gamificação

1. **Membros › Gamificação**.
2. Clique na chave até ela mostrar **Desligada**. Os campos de pontos ficam bloqueados.
3. **Salvar**.

## Exemplo

**Uma escola que quer premiar quem estuda.** A Escola Excel sobe **Completar aula** de 25 para 40 e baixa **Curtir publicação** de 1 para 0. Na semana seguinte, uma aluna que completa 5 aulas ganha 200 pontos por elas; curtir posts não conta mais. Os pontos que ela já tinha continuam iguais.

## Erros comuns e como resolver

| Mensagem | O que fazer |
|---|---|
| *"Use um número inteiro de 0 para cima em …"* | O campo da ação citada tem número negativo, decimal ou vazio. Corrija e salve de novo |
| *"Não foi possível carregar a gamificação."* | Clique em **Tentar novamente**. Se persistir, recarregue a página |
| *"Não foi possível salvar. Tente de novo."* | Nada foi salvo. Tente de novo em alguns segundos |

## Perguntas frequentes

**Mudar os pontos recalcula o ranking?**
Não. Os pontos já conquistados ficam como estão; o valor novo vale para as próximas ações.

**Desligar apaga os pontos?**
Não. Eles ficam guardados, e as ações voltam a contar quando você religar.

**Dá para dar pontos à mão para alguém?**
Ainda não. Os pontos vêm só das ações da tabela.

## Na API

`GET` e `PUT /api/gamification/config` (proprietário e administrador): `isEnabled` e `actionRules`, com os pontos de cada ação. Ver [Gamification](/api/referencia/gamification).

## Relacionados

- [Ranking](/espacos/ranking)
- [Gerenciar membros](/membros/gerenciar-membros)
- [Configurações gerais](/configuracoes/configuracoes-gerais)