PangobotDocumentação
PT

Embeds e variáveis

Como o criador de embeds funciona, quais variáveis existem e como emojis e a formatação do Discord entram em uma mensagem.

Onde quer que o bot publique uma mensagem sua - mensagens de boas-vindas, menus de cargos, painéis de tickets, posts de feeds, mensagens agendadas -, você a monta no mesmo criador de embeds, com uma prévia que se parece com o Discord.

O criador de embeds: Autor, Texto, Campos, Imagens e Rodapé como seções, com a prévia à direita.
O criador de embeds: Autor, Texto, Campos, Imagens e Rodapé como seções, com a prévia à direita.

O que um embed pode conter

  • Linha de autor com ícone e link, título com link, texto, uma cor.
  • Até 25 campos, cada um com nome e valor, lado a lado se você marcar Lado a lado.
  • Uma imagem grande, uma miniatura pequena, um rodapé com ícone e um carimbo de data/hora.
  • O Discord permite 6.000 caracteres para todo o texto de um embed; os contadores mostram quanto falta.
  • Os endereços de imagens e links precisam começar com https:// - ou ser uma única variável, como {user.avatar}, onde um módulo oferecer uma.
  • Imagens nos servidores do próprio Discord aparecem na prévia na hora. Uma imagem em qualquer outro site espera um clique em Carregar imagens abaixo da prévia, porque carregá-la diria a esse site o seu endereço IP. Os membros no Discord não são afetados: o Discord carrega as imagens dos embeds pelo próprio proxy.

Importar e exportar uma mensagem: { } JSON

Ao lado da prévia há um botão { } JSON. Ele mostra a mensagem inteira - o texto acima do embed e o próprio embed - no formato do próprio Discord, o mesmo que outros bots, webhooks e os criadores de embeds na web usam. Copie para guardar uma mensagem ou levá-la para outro servidor, ou cole uma e clique em Usar: todos os campos do criador são preenchidos de uma vez e a prévia mostra o resultado. Botões, arquivos, enquetes e um nome de remetente ficam de fora, e ele avisa quando deixa algo de fora - o Pangobot não envia isso daqui. Um JSON que não pode ser lido diz por quê, e nada é aplicado até que possa. Tudo é verificado de novo quando você salva a página.

Variáveis

Uma variável é substituída quando a mensagem é publicada. Quais existem depende do módulo; cada campo de texto informa as suas logo abaixo. As mais comuns:

VariávelVira
{user}Uma menção ao membro
{user.name}O nome do membro, sem menção
{server}O nome do servidor
{membercount}Quantos membros o servidor tem
{server.boosts}Quantos impulsos o servidor tem
{server.boostlevel}O nível de impulso do servidor, de 0 a 3
{level}O nível que acabou de ser alcançado (Níveis)
{title} {author} {url}De um vídeo, post ou item de feed (Notificações sociais)
{name} {days} {hours} {date}De uma contagem regressiva (Contagens regressivas)
{ticket}O número do ticket (Tickets)

Emojis e formatação

  • O botão de carinha em um campo de texto abre o seletor de emojis: os emojis padrão e os do seu próprio servidor, com busca e os seus recentes.
  • A formatação do Discord funciona como no chat: **bold**, *italic*, __underline__, ~~strike~~, ||spoiler||, # Heading, > quote, listas e blocos de código. A prévia mostra o resultado.
  • Mencione um canal ou cargo escolhendo-o no Discord e copiando a menção, por exemplo <#123...> - a prévia mostra o nome.