> ## 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 de links de mensagens

> Quando alguém posta o link de uma mensagem do servidor, o Petto mostra o que ela diz em um embed, só para quem já pode vê-la. Desligado até você ligar.

## Visão geral

Quando um membro posta o link de uma mensagem deste servidor (`https://discord.com/channels/...`, copiado com **Copiar link da mensagem**), o Petto responde com um embed dessa mensagem: quem a escreveu, o texto, a primeira imagem, os outros arquivos, as figurinhas, a quem ela responde, o canal e a hora, e um botão **Ir para a mensagem**. Serve para trazer uma mensagem para uma conversa sem mandar o pessoal procurá-la.

Ele vem **desligado em todos os servidores** até que um membro com **Gerenciar servidor** o ligue. Um servidor que nunca o liga não vê nenhuma mudança.

## Comandos

```javascript Sintaxe theme={null}
!messagelinks
!messagelinks on
!messagelinks off
!messagelinks status
!messagelinks ignore <channel>
!messagelinks unignore <channel>
```

```javascript Exemplo theme={null}
!messagelinks on
!messagelinks ignore #chat-staff
!messagelinks status
```

Precisa de **Gerenciar servidor**. `!messagelinks` também funciona como `!msglinks`, `!linkembed` e `!mlinks`, e como o comando slash `/messagelinks`. Sem subcomando mostra o estado.

* **`on`** e **`off`** ligam ou desligam a função no servidor. Ao ligar, o Petto avisa se falta **Inserir links** no canal em que você está.
* **`status`** mostra se está ligada, os canais ignorados e as regras abaixo.
* **`ignore`** faz o Petto não abrir links postados nesse canal, nem mensagens que vivem nele. Um tópico é ignorado quando o canal dele é. Até 50 canais.
* **`unignore`** tira um canal dessa lista.

O mesmo interruptor e a lista de canais ignorados estão no dashboard: **Comunidade**, **Configurações**, o cartão **Embeds de links de mensagens**.

## Quem pode ver o quê

Esta função mostra o conteúdo de uma mensagem, então segue regras estritas, e quando uma não é cumprida o Petto não faz nada e não diz nada.

* **Só o que o membro que postou o link já pode ver.** O Petto confere as permissões desse membro no canal (ou tópico) linkado: ele precisa de **Ver canal** e **Ver histórico de mensagens** ali. Um tópico privado só é mostrado a quem está nele ou pode gerenciar tópicos.
* **O Petto precisa das mesmas permissões** no canal linkado, e de **Inserir links** e **Enviar mensagens** onde o link foi postado. Sem Inserir links ele não mostra nada e anota isso uma vez no registro dele.
* **Só o mesmo servidor.** Um link para uma mensagem de outro servidor é ignorado.
* **Canais NSFW** nunca são mostrados em um canal que não é NSFW.
* **Canais ignorados** não são lidos nem mostrados, em nenhum dos sentidos.

## O que é deixado quieto

* Links dentro de código (`` `assim` `` ou um bloco de código), dentro de um spoiler, ou escritos como `<https://...>`, o jeito que o Discord pede para não mostrar prévia.
* Links postados por um bot ou um webhook, e links para mensagens do sistema, para mensagens que só viu quem usou um comando ou para mensagens que foram apagadas.
* Um link para a própria mensagem que o contém.
* Uma mensagem com mais de 3 links: só os 3 primeiros são mostrados, em uma única resposta.

## O que o embed mostra

* O nome e o avatar do autor, com um link para a mensagem.
* O texto, cortado no limite de um embed. Uma mensagem de um bot que só tem um embed mostra o título e o texto desse embed.
* A primeira imagem anexada (ou, se não houver, a primeira imagem de um embed da mensagem) como imagem. Uma imagem enviada como spoiler aparece só como link.
* Os outros arquivos, e as outras imagens de embeds, em uma lista com o nome e o link.
* Uma nota para cada figurinha, e uma linha com a quem a mensagem responde.
* O canal e a hora no rodapé, e o botão **Ir para a mensagem**.

Vídeos, áudio, enquetes e música não são tocados nem desenhados: um vídeo aparece como um arquivo na lista.

## Limites e privacidade

* No máximo **3 links por mensagem** e uma resposta a cada **3 segundos em cada canal**, para que uma enxurrada de links não sirva para fazer spam. Não há outro limite, e nenhum depende de um plano.
* A resposta é uma resposta à mensagem com o link, **não avisa ninguém** (nem o autor da mensagem mostrada nem o membro que postou o link), e nunca apaga nem edita a mensagem do membro, mesmo que ela só tenha o link.
* O Petto não guarda nada: ele lê a única mensagem linkada, monta o embed e o solta. Só o interruptor e a lista de canais ignorados são salvos.

> [!NOTE]
>
> A mudança feita no dashboard chega ao bot em instantes; com o comando é imediata.


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