# Gamificación

> La pestaña Gamificación en Miembros, para el propietario y el administrador. Cómo activar y desactivar los puntos de la comunidad, cuánto vale cada acción, qué pasa con los puntos ya ganados y la diferencia con la Clasificación Global.

La **Gamificación** decide si la participación en la comunidad suma puntos y cuánto vale cada acción: publicar, comentar, dar me gusta, ir a un evento, completar una lección. Los puntos alimentan el [Ranking](/espacos/ranking) y los niveles de los miembros.

Está en **Miembros › Gamificación**: *"Puntos por participar, que alimentan el Ranking y los niveles de los miembros."*

![Miembros › Gamificación](/screens/gamificacao.png "El interruptor Activa y los puntos de cada acción, con el valor por defecto.")

## Para qué sirve

| Comunidad | Cómo ajustar los puntos |
|---|---|
| Escuela online | Dar más peso a **Completar lección** que a **Dar me gusta a publicación**, para premiar a quien estudia |
| Comunidad de clientes | Valorar **Responder comentario**, para reconocer a quien ayuda a los demás |
| Comunidad de eventos | Subir **Participar en evento**, para premiar a quien aparece |
| Comunidad que no quiere competición | Desactivar la gamificación |

## Quién puede

El **propietario** y el **administrador**. Los moderadores y finanzas no ven la pestaña.

## Cómo funciona

### Activar y desactivar

El interruptor en la parte superior de la pestaña muestra **Activa** o **Desactivada**. La gamificación ya viene activa cuando se crea la comunidad.

Desactivada, *"ninguna acción suma puntos. Los puntos ya ganados se conservan."* Al activarla de nuevo, las acciones vuelven a contar desde ese momento; lo que pasó mientras estaba desactivada no cuenta.

### Puntos por acción

Cada acción tiene su valor, un número entero de 0 en adelante. Los valores por defecto:

| Acción | Puntos |
|---|---:|
| Inicio de sesión diario | 1 |
| Crear publicación | 10 |
| Dar me gusta a publicación | 1 |
| Comentar publicación | 5 |
| Responder comentario | 3 |
| Recibir me gusta | 2 |
| Crear evento | 20 |
| Participar en evento | 20 |
| Crear curso | 30 |
| Inscribirse en curso | 10 |
| Completar lección | 25 |

Cambiar un valor *"vale a partir de la próxima acción; los puntos ya ganados no cambian."* Una acción con **0** deja de dar puntos, sin desactivar las demás.

### Gamificación y Clasificación Global

Son dos interruptores distintos:

| Interruptor | Dónde | Qué hace |
|---|---|---|
| **Gamificación** | **Miembros › Gamificación** | Si las acciones suman puntos |
| **Clasificación Global** | **Configuración › General** | Si el ranking de toda la comunidad aparece para los miembros |

Con la gamificación desactivada, el ranking deja de cambiar, porque nadie gana puntos nuevos.

## Paso a paso

### Cambiar cuánto vale una acción

*Rol: propietario o administrador.*

1. **Miembros › Gamificación**.
2. En **Puntos por acción**, cambia el número junto a la acción (por ejemplo, **Completar lección** a *40*).
3. **Guardar**. Aparece *"Guardado."*

### Desactivar la gamificación

1. **Miembros › Gamificación**.
2. Haz clic en el interruptor hasta que muestre **Desactivada**. Los campos de puntos quedan bloqueados.
3. **Guardar**.

## Ejemplo

**Una escuela que quiere premiar a quien estudia.** La Escuela Excel sube **Completar lección** de 25 a 40 y baja **Dar me gusta a publicación** de 1 a 0. La semana siguiente, una alumna que completa 5 lecciones gana 200 puntos por ellas; dar me gusta ya no cuenta. Los puntos que ya tenía siguen iguales.

## Errores frecuentes y cómo resolverlos

| Mensaje | Qué hacer |
|---|---|
| *"Usa un número entero de 0 en adelante en …"* | El campo de la acción citada tiene un número negativo, decimal o vacío. Corrígelo y guarda de nuevo |
| *"No se pudo cargar la gamificación."* | Haz clic en **Intentar de nuevo**. Si sigue, recarga la página |
| *"No se pudo guardar. Inténtalo de nuevo."* | No se guardó nada. Inténtalo de nuevo en unos segundos |

## Preguntas frecuentes

**¿Cambiar los puntos recalcula el ranking?**
No. Los puntos ya ganados se quedan como están; el valor nuevo vale para las próximas acciones.

**¿Desactivar borra los puntos?**
No. Se conservan, y las acciones vuelven a contar cuando la reactivas.

**¿Se pueden dar puntos a mano a alguien?**
Todavía no. Los puntos llegan solo de las acciones de la tabla.

## En la API

`GET` y `PUT /api/gamification/config` (propietario y administrador): `isEnabled` y `actionRules`, con los puntos de cada acción. Consulta [Gamification](/api/referencia/gamification).

## Relacionados

- [Ranking](/espacos/ranking)
- [Gestionar miembros](/membros/gerenciar-membros)
- [Configuración general](/configuracoes/configuracoes-gerais)
