> ## Documentation Index
> Fetch the complete documentation index at: https://docs.headlesslabs.xyz/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Mensajes persistentes

> Sticky mantiene un aviso de canal destacado. Tras actividad de una persona, Headless espera el intervalo configurado y vuelve a publicar el aviso; no ejecuta mensajes con un horario de reloj.

## Temporización por actividad

`refresh_seconds` tiene un valor inicial de 8 segundos y acepta 2–300 mediante `.sticky interval` o el Dashboard. Cada mensaje que no se ignore programa o reinicia la espera. `min_interval_seconds` limita las publicaciones consecutivas, comienza en 12 segundos y admite valores normalizados de 0–600; puedes cambiarlo en los ajustes de Sticky del Dashboard. Si aún no pasó ese mínimo, Headless vuelve a programar el refresco para más adelante.

### `.sticky mode`

```headless-command Syntax theme={null}
.sticky mode <mode> [channel]
```

```headless-command Example theme={null}
.sticky mode embed #anuncios
```

### `.sticky interval`

```headless-command Syntax theme={null}
.sticky interval <seconds> [channel]
```

```headless-command Example theme={null}
.sticky interval 8 #anuncios
```

## Qué ocurre al refrescar

`ignore_bots` está activo de forma predeterminada: los mensajes de bots no reinician el temporizador. Headless tampoco toma su propio sticky como nueva actividad. Cuando termina la espera normal, publica un nuevo aviso y después intenta borrar el anterior si `delete_previous` está activo (también es el valor inicial). Los comandos de configuración y `refresh` fuerzan una actualización del mensaje existente cuando está disponible. Un fallo de envío o borrado se guarda en el estado y puede requerir revisar permisos.

### `.sticky refresh`

```headless-command Syntax theme={null}
.sticky refresh [channel]
```

```headless-command Example theme={null}
.sticky refresh #anuncios
```

## Formato, contenido y permisos

Elige embed o texto. El texto se limita a 1900 caracteres; la configuración normalizada limita título a 120, mensaje a 1800, pie a 180 y etiqueta de enlace a 80. Los nuevos valores iniciales son `Important notice` y `Review this information before continuing in the channel.`; la etiqueta predeterminada del botón es `Open link`. Al leer configuraciones guardadas, Headless traduce solo los antiguos valores integrados que coinciden exactamente y conserva el texto personalizado. La imagen admite URL HTTP(S); el enlace puede ser HTTP(S) o discord://. Configurar comandos requiere Manage Messages; el bot necesita enviar mensajes, Insertar enlaces para embeds y gestionar mensajes para reemplazar o borrar publicaciones.

### `.sticky set`

```headless-command Syntax theme={null}
.sticky set <channel> <message>
```

```headless-command Example theme={null}
.sticky set #anuncios Información importante
```

### `.sticky title`

```headless-command Syntax theme={null}
.sticky title <channel> <title>
```

```headless-command Example theme={null}
.sticky title #anuncios Reglas del servidor
```

### `.sticky image`

```headless-command Syntax theme={null}
.sticky image <channel> <url>
```

```headless-command Example theme={null}
.sticky image #anuncios https://example.com/banner.png
```

### `.sticky link`

```headless-command Syntax theme={null}
.sticky link <channel> <url> [label=Open link]
```

```headless-command Example theme={null}
.sticky link #anuncios https://example.com/rules Reglas
```

### `.sticky`

```headless-command Syntax theme={null}
/sticky [action:<action>] [channel:<channel>] [message:<message>] [mode:<mode>] [seconds:<seconds>] [url:<url>] [label:<label>]
```

```headless-command Example theme={null}
/sticky action:set channel:#announcements message:Important
```

> [!WARNING]
>
> remove elimina el registro por canal e intenta borrar la publicación actual. off solo la desactiva y conserva su configuración. Antes de limpiar un canal, comprueba que seleccionaste el correcto.

**Nota:**

La demora de refresh es una espera tras la actividad, no una publicación periódica. Si el canal está quieto, Sticky no vuelve a enviar el aviso. `refresh_seconds`, `min_interval_seconds`, `ignore_bots` y `delete_previous` son controles distintos: el primero espera después de la actividad; el segundo separa publicaciones; los otros deciden qué actividad se ignora y si se elimina el aviso anterior.

## Variables de Sticky

El título, mensaje y pie admiten solo {server}, {channel}, {channel_name}, {member_count}, {members}, {date} y {time}. La hora se presenta en UTC. Las menciones están desactivadas en el envío; un token no puede provocar un ping.

## Almacenamiento y canales

La configuración se mantiene por servidor y canal. `set` y `here` crean o habilitan un sticky; `off` lo conserva apagado; `remove` borra la configuración y trata de borrar la publicación actual. `list` muestra los canales guardados y `show` consulta el actual o uno indicado. Si desactivas `delete_previous`, los avisos antiguos pueden permanecer en el canal.

### `.sticky here`

```headless-command Syntax theme={null}
.sticky here <message>
```

```headless-command Example theme={null}
.sticky here Lee las reglas antes de publicar
```

### `.sticky show`

```headless-command Syntax theme={null}
.sticky show [channel]
```

```headless-command Example theme={null}
.sticky show #anuncios
```

### `.sticky off`

```headless-command Syntax theme={null}
.sticky off [channel]
```

```headless-command Example theme={null}
.sticky off #anuncios
```

### `.sticky remove`

```headless-command Syntax theme={null}
.sticky remove [channel]
```

```headless-command Example theme={null}
.sticky remove #anuncios
```

## Pasos

**1. Configura el aviso**

Usa .sticky set #anuncios texto o .sticky here texto en el canal actual.

**2. Personaliza el aspecto**

Elige embed/text, y configura título, imagen o enlace URL.

**3. Prueba el refresco**

Envía un mensaje humano en el canal; después consulta .sticky show o fuerza una actualización con .sticky refresh.

> **Comandos de prefijo**
>
> El grupo acepta el alias .stick. Comandos: .sticky (estado del canal actual); .sticky set #canal mensaje; .sticky here mensaje; .sticky title #canal título; .sticky message #canal texto; .sticky on \[#canal]; .sticky off \[#canal]; .sticky remove \[#canal]; .sticky refresh \[#canal]; .sticky mode embed|text \[#canal]; .sticky image #canal URL; .sticky link #canal URL \[etiqueta]; .sticky interval segundos \[#canal]; .sticky list; .sticky show \[#canal]. Alias de remove: delete y clear; alias de refresh: repost y fix.

> **Slash command**
>
> /sticky permite status, set, here, on, off, refresh, mode, interval, image y link, con campos channel, message, mode, seconds, url y label. Requiere Manage Messages por defecto. No incluye acción remove; para borrar el registro usa el comando de prefijo .sticky remove.

> **Ajustes del Dashboard sin comando de prefijo**
>
> El editor de Sticky también expone mínimo intervalo, ignorar bots y borrar publicación anterior; no hay subcomandos de prefijo para cambiarlos. Ignorar bots está activo de forma predeterminada. Si desactivas borrar anterior, las publicaciones previas pueden permanecer en el canal cuando haya actividad.

## Usos y contenido

> **Uso recomendado**
>
> Avisos compactos que se mantienen accesibles sin programar publicaciones periódicas.
>
> <ul>
>   <li>Reglas resumidas.</li>
>   <li>Avisos de soporte.</li>
>   <li>Recordatorios de canales de ayuda.</li>
> </ul>

> **Contenido rico**
>
> Elige texto o embed y añade material útil para la comunidad.
>
> <ul>
>   <li>Agrega una imagen HTTPS.</li>
>   <li>Agrega un enlace o botón.</li>
>   <li>Usa texto limpio si el canal no necesita un embed.</li>
> </ul>

> **Dashboard**
>
> El editor del Dashboard permite ajustar el mensaje y su comportamiento por canal.
>
> <ul>
>   <li>Edita el mensaje.</li>
>   <li>Cambia el canal.</li>
>   <li>Prueba el preview antes de activar.</li>
> </ul>

## Páginas relacionadas

* [Mensajes](/docs/server/messages.md)
* [Welcome](/docs/server/welcome.md)
* [Auto Responders](/docs/server/auto-responders.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.