> ## 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. # Paginação > Uma mensagem com várias páginas de embeds e botões para passá-las. ## Visão geral Uma mensagem com páginas é uma única mensagem do Petto que guarda até **25 páginas**, com botões embaixo para ir de uma a outra. Serve para regras divididas em seções, um guia, uma lista de cargos ou qualquer coisa longa demais para um só embed. `!pagination` (também `!pn` e `!pages`) é um comando de prefixo. Ele precisa de **Gerenciar mensagens** no canal da mensagem, e `reset` precisa de **Administrador**. > [!WARNING] > > Só as mensagens que o Petto enviou podem ter páginas: um bot não pode editar as mensagens de outros bots ou membros. Publique uma nova com `!pagination create`, ou use uma enviada com `!embed send`. Onde um comando pede ``, dê qualquer um destes: * O link da mensagem (clique com o botão direito ou toque e segure na mensagem, depois **Copiar link da mensagem**). * `#canal` seguido do ID da mensagem. * Só o ID da mensagem, quando a mensagem está no canal em que você está digitando. * Nada, quando você **responde** à mensagem com o comando. ## Configuração **1. Comece a mensagem** Publique uma mensagem nova com a primeira página, aqui ou em outro canal: ```javascript Sintaxe theme={null} !pagination create [#channel] [--private] ``` Ou transforme uma mensagem que o Petto já enviou na página 1, do jeito que ela está agora: ```javascript Sintaxe theme={null} !pagination set [--private] ``` ```javascript Exemplo theme={null} !pagination create #regras regras_gerais !pagination set https://discord.com/channels/123/456/789 ``` ![liam usa !pagination create no canal de regras com regras\_gerais e o Petto responde que publicou a mensagem, com o comando add para usar depois](https://mintcdn.com/wikipetto/3u3rcvq-SHcYvmo0/images/discord/resources/pt-br/pagination-step-1-create.webp?fit=max\&auto=format\&n=3u3rcvq-SHcYvmo0\&q=85\&s=12b5786ac9b969b13329514937485a11) No Discord: !pagination create publica a página 1 e diz como adicionar a próxima. ![liam usa !pagination set com o link de uma mensagem e o Petto confirma que agora é a página 1 de uma paginação](https://mintcdn.com/wikipetto/3u3rcvq-SHcYvmo0/images/discord/resources/pt-br/pagination-step-1-set.webp?fit=max\&auto=format\&n=3u3rcvq-SHcYvmo0\&q=85\&s=f502875af73c359e690007748cd62cee) No Discord: !pagination set transforma uma mensagem que o Petto enviou na página 1. **2. Adicione as próximas páginas** Cada página vai para o final. Repita para cada página que quiser, até 25. ```javascript Sintaxe theme={null} !pagination add ``` ```javascript Exemplo theme={null} !pagination add https://discord.com/channels/123/456/789 regras_voz !pagination add https://discord.com/channels/123/456/789 {embed}$v{title: Staff}$v{description: Peça ajuda para qualquer um de nós} ``` ![liam adiciona a página 2 com um embed salvo e a página 3 com um código, e o Petto confirma cada uma](https://mintcdn.com/wikipetto/3u3rcvq-SHcYvmo0/images/discord/resources/pt-br/pagination-step-2-add.webp?fit=max\&auto=format\&n=3u3rcvq-SHcYvmo0\&q=85\&s=33f28d9ab4258fae60d446b5d0ddc463) No Discord: !pagination add com um embed salvo e depois com um código de embed. **3. Mude uma página** Coloca outro embed ou código em uma página pelo número dela. `edit` funciona igual a `update`. ```javascript Sintaxe theme={null} !pagination update ``` ```javascript Exemplo theme={null} !pagination update https://discord.com/channels/123/456/789 2 regras_voz_v2 ``` ![liam muda a página 2 e o Petto responde que a página 2 mudou](https://mintcdn.com/wikipetto/3u3rcvq-SHcYvmo0/images/discord/resources/pt-br/pagination-step-3-update.webp?fit=max\&auto=format\&n=3u3rcvq-SHcYvmo0\&q=85\&s=297b39910fd473b98fd38d36ac0204d7) No Discord: !pagination update coloca outro embed na página 2. **4. Remova uma página** Tira uma página pelo número dela. A única página que sobra não pode ser removida: use `delete` para parar a paginação. ```javascript Sintaxe theme={null} !pagination remove ``` ```javascript Exemplo theme={null} !pagination remove https://discord.com/channels/123/456/789 3 ``` ![liam remove a página 3 e o Petto diz que restam 2 páginas](https://mintcdn.com/wikipetto/3u3rcvq-SHcYvmo0/images/discord/resources/pt-br/pagination-step-4-remove.webp?fit=max\&auto=format\&n=3u3rcvq-SHcYvmo0\&q=85\&s=5d8fcd63ec7496dcddc71e91e43fa75f) No Discord: !pagination remove tira a página 3 e diz quantas restam. ![kira tenta remover a única página e o Petto responde em vermelho com o comando delete para usar no lugar](https://mintcdn.com/wikipetto/3u3rcvq-SHcYvmo0/images/discord/resources/pt-br/pagination-step-4-last-page.webp?fit=max\&auto=format\&n=3u3rcvq-SHcYvmo0\&q=85\&s=5c15ad1c944bd28f0f38b361ea0b8373) No Discord: a única página não pode ser removida: o Petto indica delete. Depois de qualquer mudança a mensagem volta para a página 1, com o novo número de páginas. ## Comandos relacionados > [accordion] Parar uma paginação ou apagar a mensagem > > Os botões saem e a mensagem fica com a página que está mostrando. Adicione `--message` para apagar a mensagem também. `del` funciona igual a `delete`. > > ```javascript Sintaxe theme={null} > !pagination delete [--message] > ``` > > ![liam para uma paginação e o Petto diz que a mensagem não tem mais páginas e fica com a que mostrava](https://mintcdn.com/wikipetto/3u3rcvq-SHcYvmo0/images/discord/resources/pt-br/pagination-delete.webp?fit=max\&auto=format\&n=3u3rcvq-SHcYvmo0\&q=85\&s=c2600545bd5de3074617a98156c1aa59) > > No Discord: !pagination delete tira os botões; a mensagem fica com sua página. > > ![liam usa !pagination delete com --message e o Petto confirma que a mensagem foi apagada](https://mintcdn.com/wikipetto/3u3rcvq-SHcYvmo0/images/discord/resources/pt-br/pagination-delete-message.webp?fit=max\&auto=format\&n=3u3rcvq-SHcYvmo0\&q=85\&s=5cc107e049875f46defeabb4dcbe920f) > > No Discord: com --message a mensagem também é apagada. > [accordion] Parar todas as paginações do servidor > > Só administradores. O Petto pergunta antes com um botão **Parar todas**; as mensagens ficam com a página que mostram. > > ```javascript Sintaxe theme={null} > !pagination reset > ``` > > ![liam usa !pagination reset e o Petto pergunta em vermelho se para as 2 mensagens com páginas, com botões para parar e cancelar](https://mintcdn.com/wikipetto/3u3rcvq-SHcYvmo0/images/discord/resources/pt-br/pagination-reset.webp?fit=max\&auto=format\&n=3u3rcvq-SHcYvmo0\&q=85\&s=81c0747cd0ffbe7a6c7c56022280afab) > > No Discord: !pagination reset pergunta antes, com um botão para parar todas. > > ![A pergunta muda para Pronto: 2 mensagens com páginas paradas](https://mintcdn.com/wikipetto/3u3rcvq-SHcYvmo0/images/discord/resources/pt-br/pagination-reset-done.webp?fit=max\&auto=format\&n=3u3rcvq-SHcYvmo0\&q=85\&s=03e8f8bdc96645f6d5fb1d4b2eeeb2d8) > > No Discord: depois do clique: todas as paginações param. > [accordion] Ver a lista de mensagens com páginas > > Todas as mensagens com páginas do servidor com o canal, o número de páginas, se são privadas e um link, 10 por página. > > ```javascript Sintaxe theme={null} > !pagination list > ``` > > ![O Petto lista duas mensagens com páginas: regras com 3 páginas e guia-do-servidor com 7 páginas privadas](https://mintcdn.com/wikipetto/3u3rcvq-SHcYvmo0/images/discord/resources/pt-br/pagination-list.webp?fit=max\&auto=format\&n=3u3rcvq-SHcYvmo0\&q=85\&s=3dfe2f2c2364abf986572094504ecfb4) > > No Discord: !pagination list: cada mensagem com o canal, as páginas, se é privada e um link. > [accordion] Ver as páginas de uma mensagem > > As páginas em ordem (o embed salvo de cada uma, ou que é um código), o tipo e se é compartilhada ou privada. `show` e `info` funcionam igual a `view`. > > ```javascript Sintaxe theme={null} > !pagination view > ``` > > ![O Petto mostra as 4 páginas de uma mensagem: três embeds salvos e um código, compartilhadas](https://mintcdn.com/wikipetto/3u3rcvq-SHcYvmo0/images/discord/resources/pt-br/pagination-view.webp?fit=max\&auto=format\&n=3u3rcvq-SHcYvmo0\&q=85\&s=97fec96bec4352cf03605cc49068b10a) > > No Discord: !pagination view: as páginas em ordem e o tipo. > [accordion] Mover uma página > > ```javascript Sintaxe theme={null} > !pagination move > ``` > > ```javascript Exemplo theme={null} > !pagination move https://discord.com/channels/123/456/789 5 2 > ``` > > ![liam move a página 5 para o lugar 2 e o Petto confirma](https://mintcdn.com/wikipetto/3u3rcvq-SHcYvmo0/images/discord/resources/pt-br/pagination-move.webp?fit=max\&auto=format\&n=3u3rcvq-SHcYvmo0\&q=85\&s=69b41fd5c27e70d6577175ed28c057f8) > > No Discord: !pagination move: a página 5 vira a página 2. > [accordion] Páginas compartilhadas ou privadas > > Veja [Compartilhado ou privado](#compartilhado-ou-privado). > > ```javascript Sintaxe theme={null} > !pagination mode shared|private > ``` > > ![liam deixa uma paginação privada e o Petto explica o que isso faz](https://mintcdn.com/wikipetto/3u3rcvq-SHcYvmo0/images/discord/resources/pt-br/pagination-mode.webp?fit=max\&auto=format\&n=3u3rcvq-SHcYvmo0\&q=85\&s=c2aae9f2a830c01e78073799a9fcef9c) > > No Discord: !pagination mode private: cada clique mostra a página só para quem clicou. > [accordion] Colocar os botões de volta > > Mostra de novo a página 1 com os botões, para quando eles foram tirados ou a mensagem foi mudada com outra coisa (como `!editembed`). `restorereactions` e `rr` funcionam igual a `restore`. > > ```javascript Sintaxe theme={null} > !pagination restore > ``` > > ![liam restaura uma paginação e o Petto diz que os botões voltaram, mostrando a página 1](https://mintcdn.com/wikipetto/3u3rcvq-SHcYvmo0/images/discord/resources/pt-br/pagination-restore.webp?fit=max\&auto=format\&n=3u3rcvq-SHcYvmo0\&q=85\&s=5c6f0899e52200acf1158cefbf8a5590) > > No Discord: !pagination restore coloca os botões de volta na página 1. ## Como os botões funcionam O Petto usa botões, não reações, então não precisa de **Adicionar reações**, a página atual sempre aparece e os botões continuam funcionando depois que o Petto reinicia. | Páginas | O que fica embaixo da mensagem | | - | - | | 1 | Sem botões (eles aparecem quando você adiciona uma segunda página) | | 2 a 5 | ◀ · **Página X/Y** · ▶ | | 6 ou mais | ⏮ ◀ **Página X/Y** ▶ ⏭, e um menu **Ir para uma página…** em uma segunda linha | > [accordion] De 2 a 5 páginas > > ![A primeira página de regras do Petto com os botões voltar, Página 1/3 e próxima embaixo](https://mintcdn.com/wikipetto/3u3rcvq-SHcYvmo0/images/discord/resources/pt-br/pagination-buttons-few.webp?fit=max\&auto=format\&n=3u3rcvq-SHcYvmo0\&q=85\&s=42060322fb75ded4bdf3fff0ef0cd423) > > No Discord: três páginas: ◀ Página 1/3 ▶. > [accordion] Depois de um clique em ▶ > > ![A mesma mensagem agora mostra a página de canais de voz e Página 2/3](https://mintcdn.com/wikipetto/3u3rcvq-SHcYvmo0/images/discord/resources/pt-br/pagination-buttons-next.webp?fit=max\&auto=format\&n=3u3rcvq-SHcYvmo0\&q=85\&s=56fddf7be21355c13435cff36ecc9f9c) > > No Discord: um clique em ▶ passa a mensagem para a página 2 para todos. > [accordion] 6 páginas ou mais > > ![Um guia de 7 páginas com os botões primeira, voltar, Página 1/7, próxima e última, e o menu de pular aberto com as 7 páginas](https://mintcdn.com/wikipetto/3u3rcvq-SHcYvmo0/images/discord/resources/pt-br/pagination-buttons-many.webp?fit=max\&auto=format\&n=3u3rcvq-SHcYvmo0\&q=85\&s=e9f6495ad5e7773144d41f300b5d0f04) > > No Discord: sete páginas: botões de primeira e última, e o menu para pular para uma página. O botão **Página X/Y** só mostra onde você está e não pode ser clicado. Qualquer pessoa que vê a mensagem pode passar as páginas. ## Compartilhado ou privado * **Compartilhado** (o padrão): um clique passa a página da própria mensagem, para todos. As variáveis de uma página compartilhada são preenchidas com o membro que criou a paginação, então a mensagem não muda a cada pessoa que clica. Bom para uma mensagem que um moderador apresenta. * **Privado** (`--private` em `create` ou `set`, ou `!pagination mode private`): um clique mostra a página só para quem clicou, como uma mensagem que só essa pessoa vê, com as variáveis preenchidas para ela. Os botões dela continuam passando essa cópia, e a mensagem do canal fica na página 1. Bom para regras ou um guia que muita gente lê ao mesmo tempo. ![O guia no canal fica na página 1 enquanto Mia recebe a página 2 como uma mensagem que só ela vê](https://mintcdn.com/wikipetto/3u3rcvq-SHcYvmo0/images/discord/resources/pt-br/pagination-private-click.webp?fit=max\&auto=format\&n=3u3rcvq-SHcYvmo0\&q=85\&s=3d4a6b586a94e94797929224348f82e5) No Discord: em uma mensagem privada um clique responde com uma cópia que só aquele membro vê. ## O que uma página pode ser Onde um comando pede ``: * **O nome de um embed salvo**, como `regras_gerais` (uma só palavra, veja [Embeds](https://wiki.petto.sbs/pt-br/resources/scripting/embeds.md)). Ele é desenhado toda vez que a página aparece, então as [variáveis](https://wiki.petto.sbs/pt-br/resources/scripting/variables.md) são preenchidas nessa hora e uma mudança no embed salvo aparece na página na mesma hora. * **Um código de embed**, como `{embed}$v{title: ...}$v{description: ...}`, lido do mesmo jeito que em `!embed create` e `!editembed`. O que não pode ser usado é avisado. * **Um código `p2.`**, um design [Components V2](https://wiki.petto.sbs/pt-br/resources/scripting/embeds.md#embeds-v2) copiado do dashboard ou do Embed Builder. Com `!pagination set`, a página 1 é o que a mensagem já mostra. > [!NOTE] > > **Um só tipo por mensagem.** O Discord não consegue transformar uma mensagem clássica (texto e embeds) em uma de Components V2 nem o contrário, então todas as páginas de uma mensagem são embeds clássicos ou todas são designs V2, conforme a primeira página. O Petto recusa uma página do outro tipo. Se um embed salvo usado por uma página for mudado depois para o outro tipo, essa página mostra um erro até você mudá-la com `update`. ![liam adiciona rules\_v2 a uma mensagem de embeds e o Petto responde em vermelho que uma mensagem não pode misturar os dois tipos](https://mintcdn.com/wikipetto/3u3rcvq-SHcYvmo0/images/discord/resources/pt-br/pagination-kind-refused.webp?fit=max\&auto=format\&n=3u3rcvq-SHcYvmo0\&q=85\&s=c2db1270c03e61e146aa96473cf56de2) No Discord: um design V2 recusado em uma mensagem de embeds clássicos. Uma página clássica mantém no máximo **3 linhas** dos próprios botões de link, porque os botões de página e o menu para pular ocupam as outras duas. ## Limites | | Grátis | Premium | | - | - | - | | Páginas por mensagem | 25 | 25 | | Mensagens com páginas por servidor | 25 | 50 | Quando um servidor chega ao número dele, `create` e `set` avisam; pare uma com `delete` para abrir espaço. Veja [Premium](https://wiki.petto.sbs/pt-br/overview/premium.md). ![liam tenta criar mais uma e o Petto diz que o servidor tem suas 25 mensagens com páginas, e o Premium dá 50](https://mintcdn.com/wikipetto/3u3rcvq-SHcYvmo0/images/discord/resources/pt-br/pagination-limit.webp?fit=max\&auto=format\&n=3u3rcvq-SHcYvmo0\&q=85\&s=b17e12e4ffa90ecf381d7ef5e2a9c5ae) No Discord: um servidor grátis com suas 25 mensagens com páginas. ## Dashboard No dashboard, a página **Embeds** tem uma seção **Mensagens com páginas** embaixo do editor. * **A lista** mostra cada mensagem com páginas com o canal, as páginas em ordem, uma etiqueta **Privado** ou **V2** e **Abrir no Discord**. Cada uma tem **Colocar os botões de volta**, **Parar** (tira os botões, a mensagem fica) e **Apagar mensagem** (apaga do Discord). * **Nova mensagem com páginas** cria uma a partir de embeds salvos: escolha um **Canal**, escolha o embed salvo de cada página em **Páginas, em ordem** (com **Adicionar uma página**, **Subir**, **Descer** e remover), marque **Páginas privadas** se quiser e aperte **Publicar**. ![Três mensagens com páginas: regras com 4 páginas, guia-do-servidor com 7 páginas privadas e uma V2 em anúncios, cada uma com Colocar os botões de volta, Parar e Apagar mensagem](https://mintcdn.com/wikipetto/NNb0rgWpeffY0EDH/images/dashboard/resources/pt-br/pagination-dashboard-list.webp?fit=max\&auto=format\&n=NNb0rgWpeffY0EDH\&q=85\&s=0c289b39ef0ff9187a59d91cb58c0268) Dashboard → Design → Embeds → Mensagens com páginas: cada mensagem com o canal, as páginas e as etiquetas, e seus três botões. ![O construtor com o canal guia-do-servidor, três páginas em ordem com botões de mover e remover, a caixa Páginas privadas e o botão Publicar](https://mintcdn.com/wikipetto/NNb0rgWpeffY0EDH/images/dashboard/resources/pt-br/pagination-dashboard-new.webp?fit=max\&auto=format\&n=NNb0rgWpeffY0EDH\&q=85\&s=88dc67ae917ccc901276a4eac1a835e2) Dashboard → Design → Embeds → Nova mensagem com páginas: o canal, o embed salvo de cada página, Páginas privadas e Publicar. O dashboard precisa do mesmo **Gerenciar mensagens** que o comando. Códigos de embed, códigos `p2.` e mudar uma página de cada vez são feitos com o comando. ## Problemas comuns > [accordion] Só posso adicionar páginas a mensagens que eu enviei > > A mensagem foi enviada por um membro, um webhook ou outro bot. Envie de novo com `!embed send` e depois use `!pagination set`, ou comece com `!pagination create`. > > ![kira usa !pagination set na própria mensagem e o Petto responde em vermelho que só pode adicionar páginas às próprias mensagens](https://mintcdn.com/wikipetto/3u3rcvq-SHcYvmo0/images/discord/resources/pt-br/pagination-not-mine.webp?fit=max\&auto=format\&n=3u3rcvq-SHcYvmo0\&q=85\&s=cd50cf9cec6db44aeca7ab514fa454a8) > > No Discord: uma mensagem de um membro não pode ter páginas. > [accordion] Preciso destas permissões nesse canal > > O Petto precisa de **Ver canal** e **Ver histórico de mensagens** no canal da mensagem, e para publicar uma nova com `create` também de **Enviar mensagens** e **Inserir links**. A resposta diz quais faltam. Você precisa de **Gerenciar mensagens** nesse canal. > > ![O Petto responde em vermelho que precisa de Ler histórico de mensagens nesse canal](https://mintcdn.com/wikipetto/3u3rcvq-SHcYvmo0/images/discord/resources/pt-br/pagination-bot-permissions.webp?fit=max\&auto=format\&n=3u3rcvq-SHcYvmo0\&q=85\&s=7b62b17190e9225e7c5186246b115ba0) > > No Discord: a resposta diz qual permissão falta ao Petto. > [accordion] Essa mensagem ou o canal dela não existe mais > > Apagar uma mensagem com páginas, ou o canal dela, também remove as páginas do Petto, então ela deixa de contar para o limite. Um comando que aponta para ela avisa que as páginas foram removidas. > > ![O Petto responde que a mensagem não existe mais, então as páginas foram removidas](https://mintcdn.com/wikipetto/3u3rcvq-SHcYvmo0/images/discord/resources/pt-br/pagination-gone.webp?fit=max\&auto=format\&n=3u3rcvq-SHcYvmo0\&q=85\&s=41e59c231760b1cfc1346bc5086b6ebf) > > No Discord: uma mensagem apagada: as páginas também foram removidas. > [accordion] Os botões sumiram > > Alguém editou a mensagem com outra coisa. Use `!pagination restore `, ou **Colocar os botões de volta** no dashboard. Se a paginação foi parada com `delete`, as páginas não existem mais: comece de novo com `!pagination set` e adicione-as outra vez. > [accordion] Uma página mostra um erro > > O embed salvo dela foi apagado, ou mudado para o outro tipo (clássico ou V2). Dê outro embed para a página com `!pagination update`. > > ![Abaixo da mensagem de regras o Petto diz para Mia, só para ela, que o embed salvo daquela página foi apagado e como mudar a página](https://mintcdn.com/wikipetto/3u3rcvq-SHcYvmo0/images/discord/resources/pt-br/pagination-page-error.webp?fit=max\&auto=format\&n=3u3rcvq-SHcYvmo0\&q=85\&s=ff935e31c63330936c9233a219b9772a) > > No Discord: o embed salvo da página 2 foi apagado: o clique responde com o erro. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.