# Mute & Timeout

## ¿Qué es Mute/Timeout?

Son herramientas que **silencian a un miembro temporalmente**. No puede escribir ni hablar durante el timeout.

### Diferencias

| Feature         | Mute              | Timeout                |
| --------------- | ----------------- | ---------------------- |
| **Duración**    | Permanente        | Temporal (máx 28 días) |
| **Visibilidad** | Normal, sin voz   | No ve/no escribe nada  |
| **Uso**         | Moderación básica | Castigo temporal       |

### Casos de Uso

* ✅ Castigar sin banear
* ✅ Dar tiempo para reflexionar
* ✅ Escalar disciplina
* ✅ Respuesta rápida a problemas

***

## 🚀 Configuración Básica

### Dar Timeout (Temporal)

```bash
/timeout @Usuario duración:1h razón:"Spam"
```

**Resultado:**

* Usuario aislado por 1 hora
* No puede escribir/hablar
* Se registra en logs

### Dar Mute (Permanente)

```bash
/mute @Usuario razón:"Spam repetido"
```

### Ver Duración Restante

```bash
/timeout @Usuario
```

### Remover Timeout

```bash
/timeout @Usuario duración:0
```

***

## ⏱️ Duraciones Disponibles

```
1m (1 minuto)
5m (5 minutos)
10m (10 minutos)
30m (30 minutos)
1h (1 hora)
1d (1 día)
3d (3 días)
7d (1 semana)
14d (2 semanas)
28d (4 semanas - máximo)
```

***

## 📝 Comandos

### Timeout

```bash
/timeout @Usuario duración:1h razón:"Spam"
/timeout @Usuario duración:3d razón:"Acoso"
/timeout @Usuario duración:0  [para remover]
```

### Mute (Sin duración)

```bash
/mute @Usuario razón:"Comportamiento"
```

### Unmute

```bash
/mute @Usuario  [sin razón = toggle]
```

***

## 🔍 Solución de Problemas

| Problema                     | Solución                         |
| ---------------------------- | -------------------------------- |
| **No se aplica**             | Bot necesita permisos de timeout |
| **Error "Usuario too high"** | Bot debe estar más arriba        |
| **No se registra**           | Falta canal de logs              |

***

## ⚙️ Integración con Warns

Los timeouts pueden ser **automáticos** con warns:

```
2 warns → Timeout 1 hora (automático)
4 warns → Timeout 1 día
6 warns → Kick automático
```

***

## 💡 Mejores Prácticas

### ✅ Haz

* Usa timeouts para castigos leves
* Progresa a ban solo si es necesario
* Ten razones claras
* Comunica al usuario

### ❌ No hagas

* Timeouts sin razón
* Discriminar
* Abuses de poder
* Permanentes (usa ban)

***

## 📞 ¿Problemas?

Pide ayuda en [soporte](https://discord.gg/2ZKdT6SRsZ)

***

## 🔗 Relacionado

* [Warns](broken://pages/84350817fde515a31b64001b282e27ff1dba86d9)
* [Kick/Ban](broken://pages/d62fb7264ef8741f6b43364834679a338c1ab784)


---

# Agent Instructions: 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:

```
GET https://okaa.gitbook.io/okaa-wiki/moderacion/mute-and-timeout.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.
