> ## Documentation Index > Fetch the complete documentation index at: https://wiki.petto.sbs/llms.txt > Use this file to discover all available pages before exploring further. # Paginación > Un mensaje con varias páginas de embeds y botones para pasarlas. ## Resumen Un mensaje con páginas es un solo mensaje de Petto que guarda hasta **25 páginas**, con botones debajo para moverse entre ellas. Sirve para reglas divididas en secciones, una guía, una lista de roles o cualquier cosa demasiado larga para un solo embed. `!pagination` (también `!pn` y `!pages`) es un comando de prefijo. Necesita **Gestionar mensajes** en el canal del mensaje, y `reset` necesita **Administrador**. > [!WARNING] > > Solo los mensajes que envió Petto pueden tener páginas: un bot no puede editar los mensajes de otros bots o miembros. Publica uno nuevo con `!pagination create`, o usa uno enviado con `!embed send`. Donde un comando pide ``, puedes dar cualquiera de estos: * El enlace del mensaje (clic derecho o mantener pulsado el mensaje, y luego **Copiar enlace del mensaje**). * `#canal` seguido del ID del mensaje. * Solo el ID del mensaje, cuando el mensaje está en el canal donde escribes. * Nada, cuando **respondes** al mensaje con el comando. ## Configuración **1. Empieza el mensaje** Publica un mensaje nuevo con su primera página, aquí o en otro canal: ```javascript Sintaxis theme={null} !pagination create [#channel] [--private] ``` O convierte un mensaje que Petto ya envió en la página 1, tal como está ahora: ```javascript Sintaxis theme={null} !pagination set [--private] ``` ```javascript Ejemplo theme={null} !pagination create #reglas reglas_generales !pagination set https://discord.com/channels/123/456/789 ``` ![liam usa !pagination create en el canal de reglas con reglas\_generales y Petto responde que publicó el mensaje, con el comando add para usar después](https://mintcdn.com/wikipetto/s2csZscuSJC9o9j0/images/discord/resources/es/pagination-step-1-create.webp?fit=max\&auto=format\&n=s2csZscuSJC9o9j0\&q=85\&s=b7b487a2a9525bdf9a69b4c6e6514482) En Discord: !pagination create publica la página 1 y dice cómo agregar la siguiente. ![liam usa !pagination set con el enlace de un mensaje y Petto confirma que ahora es la página 1 de una paginación](https://mintcdn.com/wikipetto/s2csZscuSJC9o9j0/images/discord/resources/es/pagination-step-1-set.webp?fit=max\&auto=format\&n=s2csZscuSJC9o9j0\&q=85\&s=f4141cabd5cea478401f9dba4113648e) En Discord: !pagination set convierte un mensaje que envió Petto en la página 1. **2. Añade las siguientes páginas** Cada página va al final. Repítelo para cada página que quieras, hasta 25. ```javascript Sintaxis theme={null} !pagination add ``` ```javascript Ejemplo theme={null} !pagination add https://discord.com/channels/123/456/789 reglas_voz !pagination add https://discord.com/channels/123/456/789 {embed}$v{title: Staff}$v{description: Pídenos ayuda cuando quieras} ``` ![liam agrega la página 2 con un embed guardado y la página 3 con un código, y Petto confirma cada una](https://mintcdn.com/wikipetto/s2csZscuSJC9o9j0/images/discord/resources/es/pagination-step-2-add.webp?fit=max\&auto=format\&n=s2csZscuSJC9o9j0\&q=85\&s=2abacf6837deb89162fd1032c5a4c58f) En Discord: !pagination add con un embed guardado y luego con un código de embed. **3. Cambia una página** Pone otro embed o código en una página por su número. `edit` funciona igual que `update`. ```javascript Sintaxis theme={null} !pagination update ``` ```javascript Ejemplo theme={null} !pagination update https://discord.com/channels/123/456/789 2 reglas_voz_v2 ``` ![liam cambia la página 2 y Petto responde que la página 2 cambió](https://mintcdn.com/wikipetto/s2csZscuSJC9o9j0/images/discord/resources/es/pagination-step-3-update.webp?fit=max\&auto=format\&n=s2csZscuSJC9o9j0\&q=85\&s=0feca2776f8780b55e7e4db37b0f17b1) En Discord: !pagination update pone otro embed en la página 2. **4. Quita una página** Saca una página por su número. La única página que queda no se puede quitar: usa `delete` para detener la paginación. ```javascript Sintaxis theme={null} !pagination remove ``` ```javascript Ejemplo theme={null} !pagination remove https://discord.com/channels/123/456/789 3 ``` ![liam quita la página 3 y Petto dice que quedan 2 páginas](https://mintcdn.com/wikipetto/s2csZscuSJC9o9j0/images/discord/resources/es/pagination-step-4-remove.webp?fit=max\&auto=format\&n=s2csZscuSJC9o9j0\&q=85\&s=912b1863b63e4ace1b416cd5d4f853cd) En Discord: !pagination remove quita la página 3 y dice cuántas quedan. ![kira intenta quitar la única página y Petto responde en rojo con el comando delete para usar en su lugar](https://mintcdn.com/wikipetto/s2csZscuSJC9o9j0/images/discord/resources/es/pagination-step-4-last-page.webp?fit=max\&auto=format\&n=s2csZscuSJC9o9j0\&q=85\&s=8248dd0a79f82dfb2479ee2b196733e8) En Discord: la única página no se puede quitar: Petto indica delete. Después de cualquier cambio el mensaje vuelve a la página 1, con el nuevo número de páginas. ## Comandos relacionados > [accordion] Detener una paginación o borrar su mensaje > > Los botones se quitan y el mensaje se queda con la página que muestra. Añade `--message` para borrar también el mensaje. `del` funciona igual que `delete`. > > ```javascript Sintaxis theme={null} > !pagination delete [--message] > ``` > > ![liam detiene una paginación y Petto dice que el mensaje ya no tiene páginas y se queda con la que mostraba](https://mintcdn.com/wikipetto/s2csZscuSJC9o9j0/images/discord/resources/es/pagination-delete.webp?fit=max\&auto=format\&n=s2csZscuSJC9o9j0\&q=85\&s=4537357c673ee1a8b22d0e0b9173ab17) > > En Discord: !pagination delete quita los botones; el mensaje se queda con su página. > > ![liam usa !pagination delete con --message y Petto confirma que se borró el mensaje](https://mintcdn.com/wikipetto/s2csZscuSJC9o9j0/images/discord/resources/es/pagination-delete-message.webp?fit=max\&auto=format\&n=s2csZscuSJC9o9j0\&q=85\&s=1d045ddb252847b5cea1c2eafd7a3e30) > > En Discord: con --message también se borra el mensaje. > [accordion] Detener todas las paginaciones del servidor > > Solo administradores. Petto pregunta antes con un botón **Detenerlos todos**; los mensajes se quedan con la página que muestran. > > ```javascript Sintaxis theme={null} > !pagination reset > ``` > > ![liam usa !pagination reset y Petto pregunta en rojo si detiene los 2 mensajes con páginas, con botones para detenerlos y cancelar](https://mintcdn.com/wikipetto/s2csZscuSJC9o9j0/images/discord/resources/es/pagination-reset.webp?fit=max\&auto=format\&n=s2csZscuSJC9o9j0\&q=85\&s=d79dc06735ad33851a2646c4fdbb7ee2) > > En Discord: !pagination reset pregunta primero, con un botón para detenerlas todas. > > ![La pregunta cambia a Listo: 2 mensajes con páginas detenidos](https://mintcdn.com/wikipetto/s2csZscuSJC9o9j0/images/discord/resources/es/pagination-reset-done.webp?fit=max\&auto=format\&n=s2csZscuSJC9o9j0\&q=85\&s=b8a5444a6e823cbc7b83df92f67e3925) > > En Discord: después del clic: todas las paginaciones se detienen. > [accordion] Ver la lista de mensajes con páginas > > Todos los mensajes con páginas del servidor con su canal, número de páginas, si son privados y un enlace, 10 por página. > > ```javascript Sintaxis theme={null} > !pagination list > ``` > > ![Petto lista dos mensajes con páginas: reglas con 3 páginas y guia-del-servidor con 7 páginas privadas](https://mintcdn.com/wikipetto/s2csZscuSJC9o9j0/images/discord/resources/es/pagination-list.webp?fit=max\&auto=format\&n=s2csZscuSJC9o9j0\&q=85\&s=3bc2682ee9b773ed589dcdd0345ba447) > > En Discord: !pagination list: cada mensaje con su canal, páginas, si es privado y un enlace. > [accordion] Ver las páginas de un mensaje > > Las páginas en orden (el embed guardado de cada una, o que es un código), su tipo y si es compartido o privado. `show` e `info` funcionan igual que `view`. > > ```javascript Sintaxis theme={null} > !pagination view > ``` > > ![Petto muestra las 4 páginas de un mensaje: tres embeds guardados y un código, compartidas](https://mintcdn.com/wikipetto/s2csZscuSJC9o9j0/images/discord/resources/es/pagination-view.webp?fit=max\&auto=format\&n=s2csZscuSJC9o9j0\&q=85\&s=ac53ae260ef66931b38dced19cb18846) > > En Discord: !pagination view: las páginas en orden y su tipo. > [accordion] Mover una página > > ```javascript Sintaxis theme={null} > !pagination move > ``` > > ```javascript Ejemplo theme={null} > !pagination move https://discord.com/channels/123/456/789 5 2 > ``` > > ![liam mueve la página 5 al lugar 2 y Petto lo confirma](https://mintcdn.com/wikipetto/s2csZscuSJC9o9j0/images/discord/resources/es/pagination-move.webp?fit=max\&auto=format\&n=s2csZscuSJC9o9j0\&q=85\&s=2546156463c7f31f9a7a61d7c86e0a80) > > En Discord: !pagination move: la página 5 pasa a ser la 2. > [accordion] Páginas compartidas o privadas > > Mira [Compartido o privado](#compartido-o-privado). > > ```javascript Sintaxis theme={null} > !pagination mode shared|private > ``` > > ![liam pone una paginación en privado y Petto explica lo que hace](https://mintcdn.com/wikipetto/s2csZscuSJC9o9j0/images/discord/resources/es/pagination-mode.webp?fit=max\&auto=format\&n=s2csZscuSJC9o9j0\&q=85\&s=b72989e62755ef441b8ba64802bd342e) > > En Discord: !pagination mode private: cada clic muestra la página solo a quien hizo clic. > [accordion] Volver a poner los botones > > Muestra otra vez la página 1 con sus botones, para cuando se quitaron o el mensaje se cambió con otra cosa (como `!editembed`). `restorereactions` y `rr` funcionan igual que `restore`. > > ```javascript Sintaxis theme={null} > !pagination restore > ``` > > ![liam restaura una paginación y Petto dice que los botones volvieron, mostrando la página 1](https://mintcdn.com/wikipetto/s2csZscuSJC9o9j0/images/discord/resources/es/pagination-restore.webp?fit=max\&auto=format\&n=s2csZscuSJC9o9j0\&q=85\&s=42ba0c0b05c2d522d0d09ea1218608dc) > > En Discord: !pagination restore vuelve a poner los botones en la página 1. ## Cómo funcionan los botones Petto usa botones, no reacciones, así que no necesita **Añadir reacciones**, la página actual siempre se ve y los botones siguen funcionando después de que Petto se reinicia. | Páginas | Lo que hay debajo del mensaje | | - | - | | 1 | Sin botones (aparecen cuando añades una segunda página) | | 2 a 5 | ◀ · **Página X/Y** · ▶ | | 6 o más | ⏮ ◀ **Página X/Y** ▶ ⏭, y un menú **Ir a una página…** en una segunda fila | > [accordion] De 2 a 5 páginas > > ![La primera página de reglas de Petto con los botones atrás, Página 1/3 y siguiente debajo](https://mintcdn.com/wikipetto/s2csZscuSJC9o9j0/images/discord/resources/es/pagination-buttons-few.webp?fit=max\&auto=format\&n=s2csZscuSJC9o9j0\&q=85\&s=5a8edd2934b07fdef2113cef16157812) > > En Discord: tres páginas: ◀ Página 1/3 ▶. > [accordion] Después de un clic en ▶ > > ![El mismo mensaje ahora muestra la página de canales de voz y Página 2/3](https://mintcdn.com/wikipetto/s2csZscuSJC9o9j0/images/discord/resources/es/pagination-buttons-next.webp?fit=max\&auto=format\&n=s2csZscuSJC9o9j0\&q=85\&s=31ca34be6820bebeb3b96c2e239f7fbb) > > En Discord: un clic en ▶ pasa el mensaje a la página 2 para todos. > [accordion] 6 páginas o más > > ![Una guía de 7 páginas con los botones primera, atrás, Página 1/7, siguiente y última, y el menú para saltar abierto con sus 7 páginas](https://mintcdn.com/wikipetto/s2csZscuSJC9o9j0/images/discord/resources/es/pagination-buttons-many.webp?fit=max\&auto=format\&n=s2csZscuSJC9o9j0\&q=85\&s=aab6651d0ff8ad01327c9161509713c8) > > En Discord: siete páginas: botones de primera y última, y el menú para saltar a una página. El botón **Página X/Y** solo muestra dónde estás y no se puede pulsar. Cualquiera que vea el mensaje puede pasar sus páginas. ## Compartido o privado * **Compartido** (lo predeterminado): un clic pasa la página del propio mensaje, para todos. Las variables de una página compartida se rellenan con el miembro que creó la paginación, así que el mensaje no cambia con cada persona que hace clic. Va bien para un mensaje que presenta un moderador. * **Privado** (`--private` en `create` o `set`, o `!pagination mode private`): un clic muestra la página solo a quien hizo clic, como un mensaje que solo ve esa persona, con las variables rellenadas para ella. Sus propios botones siguen pasando esa copia, y el mensaje del canal se queda en la página 1. Va bien para reglas o una guía que mucha gente lee a la vez. ![La guía del canal se queda en la página 1 mientras Mia recibe la página 2 como un mensaje que solo ella ve](https://mintcdn.com/wikipetto/s2csZscuSJC9o9j0/images/discord/resources/es/pagination-private-click.webp?fit=max\&auto=format\&n=s2csZscuSJC9o9j0\&q=85\&s=8418658d5149213ac0eac7528fb9d7aa) En Discord: en un mensaje privado un clic responde con una copia que solo ve ese miembro. ## Qué puede ser una página Donde un comando pide ``: * **El nombre de un embed guardado**, como `reglas_generales` (una sola palabra, mira [Embeds](https://wiki.petto.sbs/es/resources/scripting/embeds.md)). Se dibuja cada vez que se muestra la página, así que sus [variables](https://wiki.petto.sbs/es/resources/scripting/variables.md) se rellenan en ese momento y un cambio del embed guardado se ve en la página enseguida. * **Un código de embed**, como `{embed}$v{title: ...}$v{description: ...}`, que se lee igual que en `!embed create` y `!editembed`. Lo que no se puede usar se avisa. * **Un código `p2.`**, un diseño [Components V2](https://wiki.petto.sbs/es/resources/scripting/embeds.md#embeds-v2) copiado del dashboard o del Embed Builder. Con `!pagination set`, la página 1 es lo que el mensaje ya muestra. > [!NOTE] > > **Un solo tipo por mensaje.** Discord no puede convertir un mensaje clásico (texto y embeds) en uno de Components V2 ni al revés, así que todas las páginas de un mensaje son embeds clásicos o todas son diseños V2, según la primera página. Petto rechaza una página del otro tipo. Si un embed guardado que usa una página se cambia luego al otro tipo, esa página muestra un error hasta que la cambies con `update`. ![liam agrega rules\_v2 a un mensaje de embeds y Petto responde en rojo que un mensaje no puede mezclar los dos tipos](https://mintcdn.com/wikipetto/s2csZscuSJC9o9j0/images/discord/resources/es/pagination-kind-refused.webp?fit=max\&auto=format\&n=s2csZscuSJC9o9j0\&q=85\&s=82d7a034eaf57f2bc253d88b03848611) En Discord: un diseño V2 rechazado en un mensaje de embeds clásicos. Una página clásica conserva como máximo **3 filas** de sus propios botones de enlace, porque los botones de página y el menú para saltar ocupan las otras dos. ## Límites | | Gratis | Premium | | - | - | - | | Páginas por mensaje | 25 | 25 | | Mensajes con páginas por servidor | 25 | 50 | Cuando un servidor llega a su número, `create` y `set` lo dicen; detén uno con `delete` para hacer espacio. Mira [Premium](https://wiki.petto.sbs/es/overview/premium.md). ![liam intenta crear uno más y Petto dice que el servidor tiene sus 25 mensajes con páginas, y Premium da 50](https://mintcdn.com/wikipetto/s2csZscuSJC9o9j0/images/discord/resources/es/pagination-limit.webp?fit=max\&auto=format\&n=s2csZscuSJC9o9j0\&q=85\&s=305032b487c69c1903152a9e096133bd) En Discord: un servidor gratis con sus 25 mensajes con páginas. ## Dashboard En el dashboard, la página **Embeds** tiene una sección **Mensajes con páginas** debajo del editor. * **La lista** muestra cada mensaje con páginas con su canal, sus páginas en orden, una etiqueta **Privado** o **V2** y **Abrir en Discord**. Cada uno tiene **Volver a poner los botones**, **Detener** (quita los botones, el mensaje se queda) y **Borrar mensaje** (lo borra de Discord). * **Nuevo mensaje con páginas** crea uno a partir de embeds guardados: elige un **Canal**, escoge el embed guardado de cada página en **Páginas, en orden** (con **Añadir una página**, **Subir**, **Bajar** y quitar), marca **Páginas privadas** si quieres y pulsa **Publicar**. ![Tres mensajes con páginas: reglas con 4 páginas, guia-del-servidor con 7 páginas privadas y uno V2 en anuncios, cada uno con Volver a poner los botones, Detener y Borrar mensaje](https://mintcdn.com/wikipetto/NNb0rgWpeffY0EDH/images/dashboard/resources/es/pagination-dashboard-list.webp?fit=max\&auto=format\&n=NNb0rgWpeffY0EDH\&q=85\&s=3e51dd9e5c4186f25c045570471e1516) Dashboard → Diseño → Embeds → Mensajes con páginas: cada mensaje con su canal, páginas y etiquetas, y sus tres botones. ![El constructor con el canal guia-del-servidor, tres páginas en orden con botones para mover y quitar, la casilla Páginas privadas y el botón Publicar](https://mintcdn.com/wikipetto/NNb0rgWpeffY0EDH/images/dashboard/resources/es/pagination-dashboard-new.webp?fit=max\&auto=format\&n=NNb0rgWpeffY0EDH\&q=85\&s=8850e99bf0ba317e50cba37195ff16a0) Dashboard → Diseño → Embeds → Nuevo mensaje con páginas: el canal, el embed guardado de cada página, Páginas privadas y Publicar. El dashboard necesita el mismo **Gestionar mensajes** que el comando. Los códigos de embed, los códigos `p2.` y cambiar una página a la vez se hacen con el comando. ## Problemas comunes > [accordion] Solo puedo añadir páginas a mensajes que yo envié > > El mensaje lo envió un miembro, un webhook u otro bot. Envíalo de nuevo con `!embed send` y luego usa `!pagination set`, o empieza con `!pagination create`. > > ![kira usa !pagination set en su propio mensaje y Petto responde en rojo que solo puede agregar páginas a sus propios mensajes](https://mintcdn.com/wikipetto/s2csZscuSJC9o9j0/images/discord/resources/es/pagination-not-mine.webp?fit=max\&auto=format\&n=s2csZscuSJC9o9j0\&q=85\&s=7748205defc0244a8334b62ddf54697e) > > En Discord: un mensaje de un miembro no puede tener páginas. > [accordion] Necesito estos permisos en ese canal > > Petto necesita **Ver canal** y **Leer el historial de mensajes** en el canal del mensaje, y para publicar uno nuevo con `create` también **Enviar mensajes** e **Insertar enlaces**. La respuesta dice cuáles faltan. Tú necesitas **Gestionar mensajes** en ese canal. > > ![Petto responde en rojo que necesita Leer el historial de mensajes en ese canal](https://mintcdn.com/wikipetto/s2csZscuSJC9o9j0/images/discord/resources/es/pagination-bot-permissions.webp?fit=max\&auto=format\&n=s2csZscuSJC9o9j0\&q=85\&s=1cb3754f0209a98b53858120dd468351) > > En Discord: la respuesta nombra el permiso que le falta a Petto. > [accordion] Ese mensaje o su canal ya no existe > > Borrar un mensaje con páginas, o su canal, también quita sus páginas de Petto, así que deja de contar para el límite. Un comando que lo señala dice que las páginas se quitaron. > > ![Petto responde que el mensaje ya no existe, así que sus páginas se quitaron](https://mintcdn.com/wikipetto/s2csZscuSJC9o9j0/images/discord/resources/es/pagination-gone.webp?fit=max\&auto=format\&n=s2csZscuSJC9o9j0\&q=85\&s=2a2f4151dbc42f4279ae91fbd0d45e06) > > En Discord: un mensaje borrado: sus páginas también se quitaron. > [accordion] Los botones desaparecieron > > Alguien editó el mensaje con otra cosa. Usa `!pagination restore `, o **Volver a poner los botones** en el dashboard. Si la paginación se detuvo con `delete`, sus páginas ya no están: empieza de nuevo con `!pagination set` y vuelve a añadirlas. > [accordion] Una página muestra un error > > Su embed guardado se borró, o se cambió al otro tipo (clásico o V2). Dale otro embed a la página con `!pagination update`. > > ![Debajo del mensaje de reglas Petto le dice a Mia, solo a ella, que el embed guardado de esa página se borró y cómo cambiar la página](https://mintcdn.com/wikipetto/s2csZscuSJC9o9j0/images/discord/resources/es/pagination-page-error.webp?fit=max\&auto=format\&n=s2csZscuSJC9o9j0\&q=85\&s=c949f9761b2a4707c92ec69575b2f0d7) > > En Discord: el embed guardado de la página 2 se borró: el clic responde con el error. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.