> ## 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. # Embeds > Crie modelos de mensagem ricos uma vez e use-os em todo lugar. ## Visão geral Os embeds do Petto são modelos salvos: crie um (no Discord ou no dashboard), dê um nome a ele e depois aponte comandos personalizados, respostas automáticas, mensagens de boas-vindas/saída/impulso, mensagens de sorteio ou painéis de ticket para ele pelo nome. Mude o modelo uma vez e tudo o que o usa é atualizado. > [!TIP] > > A [página Embeds do dashboard](https://petto.sbs/dash) tem um construtor visual completo: uma prévia ao vivo fiel ao Discord, até 10 embeds e 5 fileiras de botões de link por modelo, atalhos de formatação markdown e uma referência de [variáveis](https://wiki.petto.sbs/pt-br/resources/scripting/variables.md) com busca. Tudo abaixo também funciona direto pelo Discord. ![A página Embeds com welcome\_embed aberto: a prévia com um embed e três botões, as reações, o conteúdo da mensagem e os campos do embed](https://mintcdn.com/wikipetto/NNb0rgWpeffY0EDH/images/dashboard/resources/pt-br/embeds-dashboard-editor.webp?fit=max\&auto=format\&n=NNb0rgWpeffY0EDH\&q=85\&s=65263c627d49fcb7595c1f468f6797c0) Dashboard → Design → Embeds: o editor visual, com a prévia ao vivo acima dos campos da mensagem. ## Criando e gerenciando ```javascript Sintaxe theme={null} !embed create !embed preview !embed send [channel] !embed delete !embed list !embed vars [page] ``` ```javascript Exemplo theme={null} !embed create welcome_embed !embed preview welcome_embed !embed send welcome_embed #anúncios ``` > [accordion] !embed create > > ![liam usa !embed create announcement\_embed e o Petto responde com o painel: botões para o título, a descrição, a cor, o autor, o rodapé, as imagens, o horário, os campos, e Salvar, Redefinir e Cancelar](https://mintcdn.com/wikipetto/jIyurMB5tJ_ItdvE/images/discord/resources/pt-br/embeds-create-panel.webp?fit=max\&auto=format\&n=jIyurMB5tJ_ItdvE\&q=85\&s=04215feb04d7924c3602b02beb874ea0) > > No Discord: !embed create abre o painel de edição do embed novo. > [accordion] !embed preview > > ![liam usa !embed preview welcome\_embed e o Petto mostra o embed com liam mencionado e 1840 membros](https://mintcdn.com/wikipetto/jIyurMB5tJ_ItdvE/images/discord/resources/pt-br/embeds-preview.webp?fit=max\&auto=format\&n=jIyurMB5tJ_ItdvE\&q=85\&s=719755c5fa7aa877e5a8c356f7aef13e) > > No Discord: !embed preview monta o embed salvo com você como membro. > [accordion] !embed preview (não existe) > > ![kira pede a prévia de welcome e o Petto diz que não há embed com esse nome e como criá-lo](https://mintcdn.com/wikipetto/jIyurMB5tJ_ItdvE/images/discord/resources/pt-br/embeds-preview-missing.webp?fit=max\&auto=format\&n=jIyurMB5tJ_ItdvE\&q=85\&s=9a3ad20eb4c096ea5b67465c72067b27) > > No Discord: um nome que não está salvo recebe uma dica para criá-lo. > [accordion] !embed send > > ![liam envia welcome\_embed para o canal de anúncios e o Petto confirma](https://mintcdn.com/wikipetto/3u3rcvq-SHcYvmo0/images/discord/resources/pt-br/embeds-send.webp?fit=max\&auto=format\&n=3u3rcvq-SHcYvmo0\&q=85\&s=c3ab54a39789dbed46d76fcbb2eb642e) > > No Discord: !embed send confirma para onde o embed foi. > > ![O embed de boas-vindas publicado pelo Petto no canal de anúncios](https://mintcdn.com/wikipetto/3u3rcvq-SHcYvmo0/images/discord/resources/pt-br/embeds-send-message.webp?fit=max\&auto=format\&n=3u3rcvq-SHcYvmo0\&q=85\&s=a98c8f16f31e6bd90a2f7807820561e6) > > No Discord: o embed como os membros o veem no canal. > [accordion] !embed delete > > ![liam apaga old\_rules e o Petto confirma](https://mintcdn.com/wikipetto/jIyurMB5tJ_ItdvE/images/discord/resources/pt-br/embeds-delete.webp?fit=max\&auto=format\&n=jIyurMB5tJ_ItdvE\&q=85\&s=0a40e024908d6574ac7416164f18e20a) > > No Discord: !embed delete apaga um embed salvo. > [accordion] !embed list > > ![O Petto lista em ordem os cinco embeds salvos do servidor](https://mintcdn.com/wikipetto/jIyurMB5tJ_ItdvE/images/discord/resources/pt-br/embeds-list.webp?fit=max\&auto=format\&n=jIyurMB5tJ_ItdvE\&q=85\&s=909ab17cf38bda80a7a5a26943bf2d97) > > No Discord: !embed list mostra os embeds salvos do servidor. > [accordion] !embed vars > > ![chu usa !embed vars e o Petto mostra as variáveis do usuário com o que cada uma dá, página 1 de 10](https://mintcdn.com/wikipetto/3u3rcvq-SHcYvmo0/images/discord/resources/pt-br/embeds-vars.webp?fit=max\&auto=format\&n=3u3rcvq-SHcYvmo0\&q=85\&s=3949e7ff663572bb9d046e8ace24de31) > > No Discord: !embed vars, a primeira página de variáveis, com botões para passar as páginas. > [!NOTE] > > `!embed create` abre um painel de edição interativo com botões para cada campo (título, descrição, cor, campos e assim por diante), e não uma resposta de texto simples. `vars` mostra a referência de variáveis direto no Discord, em páginas. ## Criando a partir de um código ```javascript Sintaxe theme={null} !embed create ``` ```javascript Exemplo theme={null} !embed create welcome {embed}&v{title: Boas-vindas, {user.display_name}}&v{description: Leia as regras}&v{color: #ff91c2} ``` ![liam cria welcome com um código e o Petto confirma e mostra o embed com o título Boas-vindas, liam](https://mintcdn.com/wikipetto/jIyurMB5tJ_ItdvE/images/discord/resources/pt-br/embeds-create-code.webp?fit=max\&auto=format\&n=jIyurMB5tJ_ItdvE\&q=85\&s=6b7b7e86da062ff71246efc2865a0ea2) No Discord: um embed feito com um código é salvo e mostrado na hora. O embed inteiro pode ser escrito como um único código e é salvo e mostrado na hora, sem o painel do editor. Os blocos são unidos por `&v` (`$v` também é lido), `&&` fica entre os valores de um bloco, e o texto antes de `{embed}` ou `{message: ...}` é o texto da mensagem. Um código pode ter até 10 embeds: `{embed}&v{...}&v{embed}&v{...}`. Um design de **Components V2** também pode ser criado a partir de um código: cole o código que começa com `p2.` (o que o dashboard e o Embed Builder dão a você) no mesmo lugar, e o design é salvo e mostrado na hora. ![liam cola um código p2. e o Petto salva o design rules\_v2 e o mostra: as regras, uma imagem e os botões Aceito e petto.sbs](https://mintcdn.com/wikipetto/jIyurMB5tJ_ItdvE/images/discord/resources/pt-br/embeds-create-v2-code.webp?fit=max\&auto=format\&n=jIyurMB5tJ_ItdvE\&q=85\&s=b154ce1779d030d8aa3f8a7ffefa2bde) No Discord: um código p2. salva um design Components V2 e o mostra. | Bloco | Uso | | - | - | | `title`, `url`, `description`, `color` | Os campos básicos | | `thumbnail`, `image` | Imagens | | `author`, `footer` | Autor e rodapé, com `&&` para o texto e o ícone | | `field` | Um nome e um valor (e `inline`) | | `timestamp` | Mostra o horário | | `button` | Um botão de link, ou um botão com ações (cargos, embeds salvos) | | `message` | O texto da mensagem fora do embed | O [gerador de código de embed](https://petto.sbs/embed-code) do site monta uma mensagem com prévia e a copia como um código de uma linha. Tudo o que não é suportado é informado e deixado de fora, nada é salvo se o Discord fosse recusar o embed, e variáveis como `{user}` funcionam dentro dos valores. O Discord não permite quebras de linha reais em uma opção de comando, então escreva `{newline}`. `!embed create` sem código abre o painel do editor como antes. Com o comando slash, o código vai na opção `code` (`/embed create name code:`). Um código com texto de mensagem ou botões é salvo no formato do dashboard e é editado lá. Veja `!embed vars` para a página de códigos. ![O gerador de códigos de embed com um título, uma descrição, uma cor e um botão verde Aceitar, a prévia e o código de uma linha](https://mintcdn.com/wikipetto/NNb0rgWpeffY0EDH/images/dashboard/resources/pt-br/embeds-code-generator.webp?fit=max\&auto=format\&n=NNb0rgWpeffY0EDH\&q=85\&s=1a20ebef55ee2064a306be4d2519af84) Gerador de códigos de embed (petto.sbs/embed-code): o formulário, a prévia e o código para copiar. ![chu usa !embed vars 10 e o Petto lista cada bloco de um código de embed com um exemplo e o link para o gerador](https://mintcdn.com/wikipetto/3u3rcvq-SHcYvmo0/images/discord/resources/pt-br/embeds-vars-code.webp?fit=max\&auto=format\&n=3u3rcvq-SHcYvmo0\&q=85\&s=f57225049d18801f45b7d5fbe7c2e88c) No Discord: a página do código de !embed vars (página 10). ## Enviando e mudando um código Um código de embed funciona em mais lugares além do `!embed create`: * **Respostas automáticas**: escreva o código como a resposta, `!autoresponder add test, {embed}$v{description: Oi, {user.mention}} --reply`. Veja [Resposta automática](https://wiki.petto.sbs/pt-br/automation/autoresponder.md#flags) para as flags. * **Mudar uma mensagem que o Petto já enviou**: `!editembed` a substitui por um novo código. ```javascript Sintaxe theme={null} !editembed !editembed (as a reply to the message) ``` ```javascript Exemplo theme={null} !editembed https://discord.com/channels/123/456/789 {embed}$v{description: Texto novo}$v{embed}$v{description: Um segundo embed} ``` ![liam usa !editembed com o link de uma mensagem e um código com dois embeds, e o Petto confirma que mudou a mensagem em anúncios](https://mintcdn.com/wikipetto/jIyurMB5tJ_ItdvE/images/discord/resources/pt-br/embeds-editembed-done.webp?fit=max\&auto=format\&n=jIyurMB5tJ_ItdvE\&q=85\&s=cce6a61ff7ac7b7748304fd441a555d3) No Discord: !editembed confirma a mudança com um link para a mensagem. ![A mensagem do Petto em anúncios agora tem dois embeds, Texto novo e Um segundo embed](https://mintcdn.com/wikipetto/jIyurMB5tJ_ItdvE/images/discord/resources/pt-br/embeds-editembed-result.webp?fit=max\&auto=format\&n=jIyurMB5tJ_ItdvE\&q=85\&s=47b5ce263ff42186af52be113e3f3563) No Discord: a mensagem depois de !editembed: exatamente o que o código novo diz. Ele precisa de **Gerenciar mensagens** nesse canal e só funciona em mensagens que o Petto enviou. O que o novo código não define é limpo, então a mensagem fica exatamente como o código diz. Uma mensagem feita com Components V2 não pode virar uma mensagem de embed normal; envie uma nova com `!embed send`. ![liam aponta !editembed para uma mensagem de kira e o Petto responde em vermelho que só pode mudar as próprias mensagens](https://mintcdn.com/wikipetto/jIyurMB5tJ_ItdvE/images/discord/resources/pt-br/embeds-editembed-notmine.webp?fit=max\&auto=format\&n=jIyurMB5tJ_ItdvE\&q=85\&s=9adb7049910604571743bb5021c66dc6) No Discord: !editembed recusa uma mensagem que o Petto não enviou. > [!TIP] > > Se um bloco perder a chave de fechamento, por exemplo `{message: {user.mention}$v{description: ...}`, o bloco termina onde o próximo começa e o Petto avisa você, em vez de ler o resto do código como texto. ![liam usa um código cujo bloco message perdeu a chave; o Petto muda a mensagem e adiciona uma linha dizendo que um bloco foi fechado antes do próximo](https://mintcdn.com/wikipetto/jIyurMB5tJ_ItdvE/images/discord/resources/pt-br/embeds-editembed-warning.webp?fit=max\&auto=format\&n=jIyurMB5tJ_ItdvE\&q=85\&s=491a35e9400804282eaa59749d98db85) No Discord: um bloco sem a chave de fechamento: a mensagem é mudada e o Petto diz onde o bloco foi fechado. ## Botões com ação Além dos botões de link, um código pode ter botões que **fazem algo** quando são clicados: ```javascript Sintaxe theme={null} {button: && && [&& ...] [&& emoji:] [&& disabled]} ``` ```javascript Exemplo theme={null} {embed}$v{title: Regras}$v{description: Clique para aceitar.}$v{button: green && Aceitar && role:@Membros}$v{button: blurple && Ver as regras && embed:regras:ephemeral}$v{button: grey && No privado && embed:regras:dm} ``` ![Um embed Regras do Petto com um botão verde Aceitar, um azul Ver as regras e um cinza No privado](https://mintcdn.com/wikipetto/jIyurMB5tJ_ItdvE/images/discord/resources/pt-br/embeds-buttons-message.webp?fit=max\&auto=format\&n=jIyurMB5tJ_ItdvE\&q=85\&s=78c2a843da34ffac85a0ced7f04de586) No Discord: o código de exemplo enviado no canal de regras: três botões com ações. | Cor | Aparência | | - | - | | `blurple`, `green`, `grey`, `red` | Azul, verde, cinza ou vermelho (cinza se você não colocar cor) | | Ação | O que faz | | - | - | | `role:` | Dá o cargo, ou tira se a pessoa já o tem | | `addrole:` | Só dá o cargo | | `removerole:` | Só tira o cargo | | `embed:` | Responde com um embed salvo, **só para quem clicou** | | `embed::public` | Publica no canal (com uma pausa de 5 segundos por pessoa) | | `embed::dm` | Envia no privado de quem clicou | > [accordion] role: > > ![Abaixo da mensagem de regras o Petto responde para Mia, só para ela, que o cargo Membros foi adicionado](https://mintcdn.com/wikipetto/jIyurMB5tJ_ItdvE/images/discord/resources/pt-br/embeds-buttons-role.webp?fit=max\&auto=format\&n=jIyurMB5tJ_ItdvE\&q=85\&s=62e6c06411d763b7256e2838a6033e0f) > > No Discord: um clique em Aceitar dá o cargo, e só quem clicou vê a resposta. > [accordion] embed:\ > > ![O Petto mostra para Mia o embed salvo de regras com as quatro regras, como uma mensagem que só ela vê](https://mintcdn.com/wikipetto/jIyurMB5tJ_ItdvE/images/discord/resources/pt-br/embeds-buttons-ephemeral.webp?fit=max\&auto=format\&n=jIyurMB5tJ_ItdvE\&q=85\&s=c1e175d556c9ad291110d5eb8e0323c7) > > No Discord: Ver as regras responde com o embed salvo, só para quem clicou. > [accordion] embed:\:dm > > ![O Petto diz para Mia, só para ela, que enviou o embed na DM dela](https://mintcdn.com/wikipetto/jIyurMB5tJ_ItdvE/images/discord/resources/pt-br/embeds-buttons-dm.webp?fit=max\&auto=format\&n=jIyurMB5tJ_ItdvE\&q=85\&s=9d00b2f7573c50420631f7fb3e763faf) > > No Discord: No privado envia o embed por mensagem direta e avisa. > > ![O embed de regras em uma mensagem direta do Petto](https://mintcdn.com/wikipetto/jIyurMB5tJ_ItdvE/images/discord/resources/pt-br/embeds-buttons-dm-message.webp?fit=max\&auto=format\&n=jIyurMB5tJ_ItdvE\&q=85\&s=c35a1d453c389c2a855f2f2cf295b02e) > > No Discord: o embed salvo nas mensagens diretas de quem clicou. `` é uma menção, um ID ou o nome do cargo. Um botão pode ter até **4 ações** (por exemplo dar um cargo e mostrar um embed ao mesmo tempo) e um código até 5 botões, em uma linha. O Petto só muda cargos que estejam **abaixo do seu cargo mais alto**, que não sejam de uma integração, e precisa da permissão **Gerenciar cargos**. O que cada botão faz fica dentro do próprio botão, então continua funcionando depois que o Petto reinicia. > [!NOTE] > > Os botões com ação também se fazem sem escrever código: no [gerador de códigos](https://petto.sbs/embed-code) e no criador de embeds do dashboard, cada botão pode ser **Link** ou **Ação** (com cor, cargo ou embed salvo). ![A seção Botões do editor: Aceitar as regras dá um cargo, Ver as regras mostra um embed salvo e petto.sbs é um link](https://mintcdn.com/wikipetto/NNb0rgWpeffY0EDH/images/dashboard/resources/pt-br/embeds-dashboard-buttons.webp?fit=max\&auto=format\&n=NNb0rgWpeffY0EDH\&q=85\&s=5bcdbb1f2c3bf440cc290c4cba7335e9) Dashboard → Design → Embeds: cada botão é um Link ou uma Ação, com sua cor, emoji e ações. ## Enviar mensagens com !send ```javascript Sintaxe theme={null} !send [#canal] ``` ```javascript Exemplo theme={null} !send #anuncios Oi @Membros, veja https://petto.sbs !send #regras {embed}$v{title: Regras}$v{description: Seja gentil}$v{button: green && Aceitar && role:@Membros} ``` Só membros com **Gerenciar mensagens** no servidor podem usar `!send` (e `petto send`, `!message send` e `/message send`). A permissão é verificada primeiro, em todas as formas de enviar, e sem ela o Petto recusa em particular. O Petto também precisa ver e escrever no canal. > [accordion] !send (texto e um cargo) > > ![liam envia um texto que menciona o cargo Membros para anúncios e o Petto confirma](https://mintcdn.com/wikipetto/3u3rcvq-SHcYvmo0/images/discord/resources/pt-br/embeds-send-text.webp?fit=max\&auto=format\&n=3u3rcvq-SHcYvmo0\&q=85\&s=dbf5718a117b1226fe9127cae69446cf) > > No Discord: !send confirma com um link para a mensagem. > > ![A mensagem do Petto em anúncios com a menção de Membros e o link](https://mintcdn.com/wikipetto/3u3rcvq-SHcYvmo0/images/discord/resources/pt-br/embeds-send-text-message.webp?fit=max\&auto=format\&n=3u3rcvq-SHcYvmo0\&q=85\&s=19291aecfd752fa0b1cc7414aa66d40c) > > No Discord: a mensagem como o Petto a enviou. > [accordion] !send (um código de embed) > > ![liam envia um embed Regras com um botão Aceitar para regras e o Petto confirma](https://mintcdn.com/wikipetto/3u3rcvq-SHcYvmo0/images/discord/resources/pt-br/embeds-send-code.webp?fit=max\&auto=format\&n=3u3rcvq-SHcYvmo0\&q=85\&s=555105e424cea940beec1024fd8d257d) > > No Discord: um código de embed com um botão enviado ao canal de regras. > > ![O embed Regras com o botão verde Aceitar](https://mintcdn.com/wikipetto/3u3rcvq-SHcYvmo0/images/discord/resources/pt-br/embeds-send-code-message.webp?fit=max\&auto=format\&n=3u3rcvq-SHcYvmo0\&q=85\&s=2e92d770f06ac2b697ba341d00cb9b4d) > > No Discord: o embed e o botão no canal. Envia uma mensagem **como o Petto**. Pode ser texto com quebras de linha, links, menções de cargos, um código de embed, e as imagens, vídeos ou arquivos que você **anexar ao comando** (até 10). Sem canal, é enviada no atual; se você responder a uma mensagem desse canal, a mensagem enviada também responde a ela. * Você precisa de **Gerenciar mensagens** nesse canal, e o Petto precisa poder escrever lá (e **Anexar arquivos** ou **Inserir links** quando necessário). * Os **pings** seguem as suas permissões: pessoas sempre, um cargo só se puder ser mencionado, e `@everyone` ou cargos bloqueados só se você tiver **Mencionar todos**. * As [variáveis](https://wiki.petto.sbs/pt-br/resources/scripting/variables.md) como `{user.mention}` e `{server_name}` são preenchidas com você como membro. * Um código com botões que dão ou tiram cargos exige que você tenha **Gerenciar cargos** e que esses cargos estejam abaixo do seu cargo mais alto; um botão que mostra um embed exige que esse embed exista. ![kira tenta enviar um botão que dá o cargo Admin e o Petto diz que esse cargo não está abaixo do cargo mais alto dela](https://mintcdn.com/wikipetto/3u3rcvq-SHcYvmo0/images/discord/resources/pt-br/embeds-send-refused.webp?fit=max\&auto=format\&n=3u3rcvq-SHcYvmo0\&q=85\&s=2ed2ab2c8ad5aedc800269a4f0997112) No Discord: um botão com um cargo acima do seu cargo mais alto é recusado. ## Editando campos ```javascript Sintaxe theme={null} !embed edit title [url] !embed edit description <embed> <description> !embed edit color <embed> <color> !embed edit author <embed> <text> [icon] [url] !embed edit footer <embed> <text> [icon] !embed edit thumbnail <embed> <image> !embed edit image <embed> <image> !embed edit timestamp <embed> <true|false> ``` ```javascript Exemplo theme={null} !embed edit title welcome_embed "Boas-vindas!" https://petto.sbs !embed edit color welcome_embed #8399ff !embed edit description welcome_embed "Que bom que você está aqui, {user}!{newline}Confira o #regras para começar." ``` > [accordion] !embed edit title > > ![liam usa !embed edit title em welcome\_embed, o Petto diz que foi atualizado e a prévia mostra a mudança](https://mintcdn.com/wikipetto/jIyurMB5tJ_ItdvE/images/discord/resources/pt-br/embeds-edit-title.webp?fit=max\&auto=format\&n=jIyurMB5tJ_ItdvE\&q=85\&s=8edc702eaa762f0f7e656b8b6a803b65) > > No Discord: !embed edit title, e depois !embed preview mostra o título novo, com o link, na prévia. > [accordion] !embed edit description > > ![liam usa !embed edit description em welcome\_embed, o Petto diz que foi atualizado e a prévia mostra a mudança](https://mintcdn.com/wikipetto/jIyurMB5tJ_ItdvE/images/discord/resources/pt-br/embeds-edit-description.webp?fit=max\&auto=format\&n=jIyurMB5tJ_ItdvE\&q=85\&s=0560ccb5245966233fe68b563809e838) > > No Discord: !embed edit description, e depois !embed preview mostra a descrição nova, com a quebra de linha. > [accordion] !embed edit color > > ![liam usa !embed edit color em welcome\_embed, o Petto diz que foi atualizado e a prévia mostra a mudança](https://mintcdn.com/wikipetto/jIyurMB5tJ_ItdvE/images/discord/resources/pt-br/embeds-edit-color.webp?fit=max\&auto=format\&n=jIyurMB5tJ_ItdvE\&q=85\&s=5f4f9c566d2671d8e47c6d37e29939e1) > > No Discord: !embed edit color, e depois !embed preview mostra a cor nova da barra lateral. > [accordion] !embed edit author > > ![liam usa !embed edit author em welcome\_embed, o Petto diz que foi atualizado e a prévia mostra a mudança](https://mintcdn.com/wikipetto/jIyurMB5tJ_ItdvE/images/discord/resources/pt-br/embeds-edit-author.webp?fit=max\&auto=format\&n=jIyurMB5tJ_ItdvE\&q=85\&s=fd385349a3e9fa95c88c839cd917447e) > > No Discord: !embed edit author, e depois !embed preview mostra a linha do autor com o ícone. > [accordion] !embed edit footer > > ![liam usa !embed edit footer em welcome\_embed, o Petto diz que foi atualizado e a prévia mostra a mudança](https://mintcdn.com/wikipetto/jIyurMB5tJ_ItdvE/images/discord/resources/pt-br/embeds-edit-footer.webp?fit=max\&auto=format\&n=jIyurMB5tJ_ItdvE\&q=85\&s=a20232817d62fbae6e4e75eb577c7855) > > No Discord: !embed edit footer, e depois !embed preview mostra o rodapé, com uma variável preenchida. > [accordion] !embed edit thumbnail > > ![liam usa !embed edit thumbnail em welcome\_embed, o Petto diz que foi atualizado e a prévia mostra a mudança](https://mintcdn.com/wikipetto/jIyurMB5tJ_ItdvE/images/discord/resources/pt-br/embeds-edit-thumbnail.webp?fit=max\&auto=format\&n=jIyurMB5tJ_ItdvE\&q=85\&s=ae4ba1e71ec97baead37dcc9501bd5b2) > > No Discord: !embed edit thumbnail, e depois !embed preview mostra a imagem pequena no canto superior direito, de \{user\_avatar}. > [accordion] !embed edit image > > ![liam usa !embed edit image em welcome\_embed, o Petto diz que foi atualizado e a prévia mostra a mudança](https://mintcdn.com/wikipetto/jIyurMB5tJ_ItdvE/images/discord/resources/pt-br/embeds-edit-image.webp?fit=max\&auto=format\&n=jIyurMB5tJ_ItdvE\&q=85\&s=ce489cf1156d5b820058e5e6c36b5b1b) > > No Discord: !embed edit image, e depois !embed preview mostra a imagem grande embaixo do embed. > [accordion] !embed edit timestamp > > ![liam usa !embed edit timestamp em welcome\_embed, o Petto diz que foi atualizado e a prévia mostra a mudança](https://mintcdn.com/wikipetto/jIyurMB5tJ_ItdvE/images/discord/resources/pt-br/embeds-edit-timestamp.webp?fit=max\&auto=format\&n=jIyurMB5tJ_ItdvE\&q=85\&s=a5c7b9fa03ef96d3eafbcf44d7d283c8) > > No Discord: !embed edit timestamp, e depois !embed preview mostra o horário da mensagem no rodapé. ## Campos (os pares de nome/valor) ```javascript Sintaxe theme={null} !embed field add <embed> <name> <value> [inline] !embed field remove <embed> <position> ``` ```javascript Exemplo theme={null} !embed field add welcome_embed Regras "Veja o #regras" true !embed field remove welcome_embed 1 ``` ![liam adiciona o campo Regras a welcome\_embed, o Petto conta 2 de 25 e a prévia mostra os dois campos](https://mintcdn.com/wikipetto/jIyurMB5tJ_ItdvE/images/discord/resources/pt-br/embeds-field-add.webp?fit=max\&auto=format\&n=jIyurMB5tJ_ItdvE\&q=85\&s=8681df78e736fe1f8e36bdd607078b9f) No Discord: !embed field add: o segundo campo, Regras, na prévia. ![liam remove o campo 1 de welcome\_embed e a prévia não tem mais o campo Membros](https://mintcdn.com/wikipetto/jIyurMB5tJ_ItdvE/images/discord/resources/pt-br/embeds-field-remove.webp?fit=max\&auto=format\&n=jIyurMB5tJ_ItdvE\&q=85\&s=47e848309984f9a881a446ac022ec748) No Discord: !embed field remove 1: o primeiro campo sumiu. Até 25 campos por embed. `position` começa em 1, na ordem mostrada pelo `!embed preview`. ## Usando um embed salvo > [accordion] Em um comando personalizado > > Aponte o `!customcommand` para um embed salvo em vez de um texto de resposta simples; `embed_template` tem prioridade sobre `response`. > [accordion] Em uma resposta automática > > Uma resposta automática pode enviar um embed salvo (`--embed_template`), um código de embed escrito como resposta, ou o modo de embed embutido mais leve (cor, título, rodapé). > [accordion] Em mensagens de boas-vindas/saída/impulso/DM ao entrar > > Todo subcomando `setup` (`!welcome setup`, `!leave setup`, `!boost setup`, `!dmonjoin setup`) tem uma opção `embed` que tem prioridade sobre a `message` simples. O `message` também pode ser **um código de embed** escrito ali mesmo, assim você configura o canal e o embed (com seus botões) em um só comando. > [accordion] Em um painel ou categoria de ticket > > Tanto `!ticket panel create` quanto `!ticket category add` aceitam um embed salvo para a mensagem do painel ou para a mensagem de boas-vindas do ticket. > [accordion] Em uma mensagem com páginas > > Vários embeds salvos (ou códigos de embed) podem ser as páginas de uma mesma mensagem, com botões para passá-las: `!pagination create #regras regras_gerais` e depois `!pagination add`. Veja [Paginação](https://wiki.petto.sbs/pt-br/resources/scripting/pagination.md). ## Reações Um embed salvo pode levar até **5 reações**: emojis que o Petto adiciona à mensagem quando a envia. No editor do dashboard, elas vão no campo **Reações**, separadas por espaços (um emoji personalizado é escrito `<:name:id>`). É o mesmo que escrever `{reactreply:emoji}` no texto para cada uma, e os dois podem ser usados juntos. Elas são colocadas na mensagem quando ela é enviada com `!embed send`, por respostas automáticas e comandos personalizados, em mensagens fixas, painéis, respostas de parceria, nas boas-vindas de uploads e em uma mensagem de honeypot. ![O embed da noite de jogos do Petto em anúncios com as reações ✅, 🤔 e ❌ já colocadas](https://mintcdn.com/wikipetto/jIyurMB5tJ_ItdvE/images/discord/resources/pt-br/embeds-reactions.webp?fit=max\&auto=format\&n=jIyurMB5tJ_ItdvE\&q=85\&s=72645e908430abb7f228dab9260655e5) No Discord: um embed salvo com três reações, enviado com !embed send. ## Dashboard e o Embed Builder Uma mensagem feita no dashboard pode ser enviada ao Embed Builder com um código de compartilhamento, e uma mensagem enviada pelo Embed Builder pode ser aberta no dashboard para continuar a edição. O dashboard também pode enviar uma mensagem de teste a um canal antes de você salvar. ![A caixa Testar e compartilhar com o seletor de canal, Enviar teste, Copiar código para compartilhar, Copiar JSON e Abrir no Embed Generator](https://mintcdn.com/wikipetto/NNb0rgWpeffY0EDH/images/dashboard/resources/pt-br/embeds-dashboard-test-share.webp?fit=max\&auto=format\&n=NNb0rgWpeffY0EDH\&q=85\&s=01d6261012cfdd3acb883a49159ed348) Dashboard → Design → Embeds: Testar e compartilhar: envie um teste para um canal ou sua DM, copie o código para compartilhar ou o JSON, ou abra no Embed Generator. ## Embeds V2 A página Embeds do dashboard também tem um **editor V2** para as mensagens de Components V2 do Discord: contêineres, texto, imagens, seções, divisórias e fileiras de botões. Um design V2 é salvo como qualquer outro embed e pode ser usado em alertas de missões, punições, no starboard, em mensagens de verificação e de bump, e com `!embed send` e `!embed preview`. Os textos e links dele usam as variáveis de sempre. Tudo o que o Discord recusaria é limpo antes do envio. ![O design rules\_v2 aberto no editor V2, com a prévia e os primeiros componentes do contêiner](https://mintcdn.com/wikipetto/NNb0rgWpeffY0EDH/images/dashboard/resources/pt-br/embeds-dashboard-v2.webp?fit=max\&auto=format\&n=NNb0rgWpeffY0EDH\&q=85\&s=f3a9f6415ea1d7b34e613f889f4302b8) Dashboard → Design → Embeds: o editor V2: a prévia, depois o contêiner com texto, divisor, imagem e fileira de botões. Um design V2 é compartilhado com o Embed Builder por um código que começa com `p2.`. Um botão de um design V2 (em uma linha de botões, ou ao lado de uma seção) é um **link** ou uma **ação**. Um botão de ação tem uma cor (azul, verde, cinza ou vermelho), um emoji opcional e até quatro ações: dar, tirar ou alternar um cargo, ou mostrar um embed salvo (só para quem clicou, no canal ou na mensagem direta), igual aos [botões com ação](#botões-com-ação) dos códigos de embed. Um botão cujos cargos não existem mais é deixado de fora. ![liam usa !embed preview rules\_v2 e o Petto mostra o contêiner com as regras do Petto Land, a imagem e dois botões](https://mintcdn.com/wikipetto/3u3rcvq-SHcYvmo0/images/discord/resources/pt-br/embeds-v2-preview.webp?fit=max\&auto=format\&n=3u3rcvq-SHcYvmo0\&q=85\&s=dde8bf10fb213189d1e170ed7b0b9feb) No Discord: um design V2 mostrado com !embed preview. Os blocos de texto de um design V2 também aceitam [menções silenciosas](https://wiki.petto.sbs/pt-br/concepts/variables-engine.md#menções-silenciosas): `!@Cargo` mostra a menção sem notificar ninguém. ## Variáveis dentro de embeds Todo texto de um embed (texto da mensagem, título, descrição, campos, autor, rodapé, rótulos de botões) e todo link (URL, miniatura, imagem, ícones) aceita as [variáveis](https://wiki.petto.sbs/pt-br/resources/scripting/variables.md). Quais delas têm dados depende do que envia o embed: umas boas-vindas preenchem o novo membro, um sorteio as `{gw.*}`, uma punição as `{case.*}`. ```javascript Exemplo theme={null} !embed create profile {embed}$v{author: {user.display_name} && {user.avatar}}$v{description: 👋 Membro do **{server_name}** desde {user.joined_at}{newline}🎖️ Cargo mais alto: {user.top_role}}$v{thumbnail: {user.display_avatar}}$v{footer: ID {user.id}}$v{color: #8399ff} ``` ```text Resultado (para !embed preview profile) theme={null} Liam 👋 Membro do Cozy Corner desde 19/10/2026 🎖️ Cargo mais alto: Booster ID 293504726505357312 ``` ![chu cria profile com o código e pede a prévia: o nome e a foto de chu, Membro do Petto Land desde uma data, o cargo mais alto Moderadores e o ID de chu](https://mintcdn.com/wikipetto/3u3rcvq-SHcYvmo0/images/discord/resources/pt-br/embeds-variables-profile.webp?fit=max\&auto=format\&n=3u3rcvq-SHcYvmo0\&q=85\&s=a1e82bb7d1c7c65508a691036e988b8c) No Discord: o código de profile, e depois !embed preview profile com chu como membro. Algumas coisas para ter em mente: * `!embed preview` preenche as variáveis com **você** como membro e com o canal atual, para você ver um resultado real. As variáveis de um evento (um nível, um caso, um sorteio) ficam vazias ali. * A prévia ao vivo do dashboard as preenche com dados de exemplo (um membro chamado Liam), e uma mensagem de teste enviada pelo dashboard usa a sua conta real. * Os timestamps do Discord (`{timestamp}`, `{gw.ends}`, `{case.expires}`, `<t:…>`) aparecem formatados no texto da mensagem, nas descrições e nos valores dos campos. Em títulos, rodapés e nomes de autor o Discord mostra o código cru, então use `{date}` ou palavras normais ali. * Um campo cujo nome ou valor fica vazio é omitido, então um campo feito só de uma variável desaparece quando essa variável não tem dados. * Um link de imagem que fica vazio ou não é um link válido é simplesmente omitido. No texto da mensagem de um código de embed e no texto de um design V2, um `!` antes de uma menção (`!@everyone`, `!@Cargo`, `!<@&id>`, `!{user.mention}`) a mostra sem notificar ninguém, e `\!@everyone` mostra o texto. No título, na descrição, nos campos e no rodapé de um embed uma menção nunca notifica, então o `!` só é removido. Veja [Menções silenciosas](https://wiki.petto.sbs/pt-br/concepts/variables-engine.md#menções-silenciosas). This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.