Módulos

Combinar mensagens e seleção de cargos

Ambos os formatos oferecem pré-visualização, cores, imagens, várias incorporações e abrir, copiar, remover e ordenar incorporações. V1 usa campos fixos do Discord e V2 blocos livres. As secções seguintes explicam as entradas e diferenças.

Configurar uma composição de cargos

Só são permitidos cargos abaixo do cargo mais alto do bot e do seu. Proprietários do servidor não têm a sua própria limitação hierárquica. @everyone, cargos geridos e cargos com permissões administrativas ou de moderação, incluindo acesso ao registo de auditoria, são excluídos da autoatribuição pública. Escolher cargos numa opção sem rótulo sugere o nome do primeiro cargo, editável. Este módulo não substitui dinamicamente marcadores de membro ou servidor, exceto o token de tempo V2.

Direitos necessários no Discord

Fjord precisa de Ver canal, Enviar mensagens e Incorporar ligações no canal de destino, além de Gerir cargos. O cargo de Fjord deve estar acima de todos os cargos atribuídos. Cargos geridos, @everyone e cargos com permissões administrativas não estão disponíveis.

O nome interno é obrigatório mesmo num rascunho e aceita até 100 caracteres. Sem canal de destino só se guarda. Publicar exige canal acessível e texto visível, incorporação ou pelo menos uma opção de cargo completa. Cada opção criada exige rótulo de 1–80 caracteres e 1–25 cargos atribuíveis. Emoji opcional, descrição até 100 caracteres visível só em menus. O texto antes de selecionar é opcional, até 150 caracteres, com valor predefinido. Em seleção múltipla, defina o máximo simultâneo de opções, até 25. Complete ou remova opções incompletas também nos rascunhos.

Conteúdo e menções

O texto normal admite até 2.000 caracteres. Use as ferramentas de inserção para adicionar cargos, canais e emojis do servidor no cursor. Este módulo publica menções sem notificações. Não substituem uma opção de cargos.

Inserções de design

O Discord só mostra o ícone do autor quando também há um nome de autor. Digite um nome acima para que o ícone apareça na prévia. O Discord só mostra o ícone do rodapé quando também há texto de rodapé. Digite um texto acima para que o ícone apareça na prévia.

V2

Um bloco de imagem pode conter uma galeria de até dez imagens. Use “+ Outra imagem” para adicionar imagens e removê-las individualmente. Cada imagem e miniatura tem uma descrição opcional de até 80 caracteres e uma opção de spoiler. Uma secção permite até três textos de até 4000 caracteres cada. Use “+ Outro texto” para adicionar até dois textos adicionais. Em Acessório, escolha uma miniatura ou um botão de link. O botão exige um rótulo de até 80 caracteres e uma URL HTTP(S) completa de até 512 caracteres. Emoji e desativação são opcionais. Os textos adicionais e o botão acessório contam para o limite de componentes. As imagens individuais de uma galeria não contam como componentes adicionais.

No V2, contêineres e imagens, incluindo miniaturas, podem ser marcados como spoilers. O conteúdo fica oculto até ser clicado.

V2 oferece até dez contentores com cores próprias. Use blocos de texto ou secções com miniatura opcional à direita, cada um com até 4000 caracteres e Markdown. Separadores podem mostrar uma linha ou só espaço, pequeno ou grande. Adicione, copie, remova e ordene blocos com as setas. Blocos de texto e imagem vazios não produzem conteúdo visível. Os textos V2 oferecem seletores de cargos, canais e emojis do servidor.

V2 não tem campos clássicos de autor, entradas de ligação do título, campos em linha, ícones de rodapé ou interruptor de data. Use Markdown para títulos e ligações. O exemplo abaixo cria um rodapé pequeno e o token de tempo uma data. V1 não oferece blocos V2 livremente dispostos. Os dois formatos não se misturam numa mensagem.

-# ... · {time.full}

V2 tem um limite conjunto de 40 componentes por mensagem. Contentores, textos, secções, miniaturas, galerias, separadores, linhas de ações, botões e menus contam individualmente. Opções de menu não contam separadamente. Separadores e controlos adicionados automaticamente também consomem o limite. Por exemplo, um contentor com texto, imagem, separador e botão com a sua linha usa seis componentes. Os dez contentores não podem ser preenchidos sem limite.

Carregar e verificar imagens

Os limites de imagem são por ficheiro. Em V1, ícone de autor, miniatura e ícone de rodapé aceitam 5 MB cada. A imagem grande tem o limite dos blocos V2 indicado abaixo. São aceites PNG, JPG/JPEG, WebP e GIF. Escolher ficheiro substitui a imagem, Remover limpa o espaço. Ícones de autor e rodapé não aparecem sem o texto correspondente.

Escolhe PNG, JPG/JPEG, WebP ou GIF. As imagens são carregadas ao guardar. As miniaturas aceitam até 5 MB e os blocos de imagem até 8 MB.

Grupos de cargos, botões e menus

O nome interno é obrigatório mesmo num rascunho e aceita até 100 caracteres. Sem canal de destino só se guarda. Publicar exige canal acessível e texto visível, incorporação ou pelo menos uma opção de cargo completa. Cada opção criada exige rótulo de 1–80 caracteres e 1–25 cargos atribuíveis. Emoji opcional, descrição até 100 caracteres visível só em menus. O texto antes de selecionar é opcional, até 150 caracteres, com valor predefinido. Em seleção múltipla, defina o máximo simultâneo de opções, até 25. Complete ou remova opções incompletas também nos rascunhos.

Os botões alternam o seu grupo de cargos. Se o membro já possui todos os cargos do grupo, eles são removidos. Caso contrário, apenas os cargos em falta são adicionados. Os outros cargos não mudam. A pré-visualização não altera cargos reais.

Configurar botões

Escolha Botões, adicione uma opção e indique a legenda e os cargos. Escolha opcionalmente um emoji e um dos quatro estilos. Repita para outros grupos e ordene com os controlos de movimento. Cada opção corresponde a um botão, mesmo com vários cargos.

Configurar um menu

A seleção múltipla usa um máximo configurado de 2–25 opções. Se existirem menos, a mensagem enviada limita automaticamente a seleção à quantidade disponível.

Escolha Menu de seleção. Cada opção recebe cargos, uma etiqueta e, opcionalmente, descrição e emoji. A etiqueta do menu aparece antes da seleção. Ative a seleção múltipla com a opção que permite várias escolhas. A seleção máxima limita opções simultâneas, não os cargos de um pacote. Sem seleção múltipla, um membro pode escolher uma opção.

O menu compara toda a seleção enviada com os cargos do membro: adiciona os cargos selecionados em falta e mantém os que já possui. Remove os cargos deste menu que não foram selecionados. Uma seleção vazia remove todos os cargos deste menu. Os cargos externos não mudam. Grupos sobrepostos mantêm os cargos partilhados enquanto alguma opção selecionada precisar deles.

As marcas mostram a seleção no cliente Discord, não necessariamente os cargos atuais. Podem desaparecer após reiniciar o cliente ou utilizar outro. Escolher apenas uma opção mantém ou atribui os seus cargos e remove os restantes cargos deste menu. Selecionar novamente um cargo já existente mantém esse cargo. O bot não repõe o menu após a utilização.

Componentes V1 / V2

V2 também agrupa até cinco botões numa linha. Um menu precisa da sua própria linha. Aplica-se o limite total de componentes em vez das cinco linhas de V1.

Novas composições começam em V2.

Escolha V1 ou V2 antes de guardar pela primeira vez. Depois, a versão é permanente, inclusive em rascunhos e após remover a publicação. Crie uma composição nova para outro formato. Duplicar mantém a versão. Mensagens V1 guardadas não são convertidas nem apagadas automaticamente.

V1 admite várias seleções de cargos independentes abaixo de toda a mensagem. Partilham cinco linhas de ações. Cada menu ocupa uma linha e até cinco botões partilham uma linha. Cinco menus só são possíveis sem linhas adicionais de botões. Cada seleção aceita 25 opções. V2 atribui a cada contentor uma seleção com botões ou menu, dentro do limite comum. Mover uma incorporação V1 não move uma seleção independente. Há botões de cargo azuis, cinzentos, verdes ou vermelhos. Não há um editor separado para linhas adicionais de botões de ligações web nem envio único. Uma secção V2 pode, porém, usar um botão de ligação como acessório em vez de uma miniatura. Abre um site sem alterar cargos.

V1

V1 usa incorporações clássicas do Discord com cor de destaque e áreas fixas. Até dez incorporações. A tabela indica o máximo de caracteres. Autor, título, descrição, rodapé e todos os nomes e valores dos campos podem somar no máximo 6000 caracteres entre todas as incorporações. O texto normal tem um limite separado. Cada incorporação V1 aceita até 25 campos.

Todas as áreas de apresentação são opcionais. Ao adicionar um campo, o nome e o valor tornam-se obrigatórios. Remova campos não usados. Lado a lado ativa campos em linha, cuja disposição final depende do Discord e da largura do ecrã. Ligação ou ícone de autor exige nome de autor, ligação do título exige título e ícone do rodapé exige texto de rodapé. As ligações opcionais devem ser endereços HTTP(S) completos. A data mostra o momento do envio.

Os seletores de cargos e canais existem no texto normal, descrição V1 e valores de campo. Não estão disponíveis em autor, título, rodapé e nomes de campo. Emojis do servidor podem ser usados nesses textos. URL de autor e ligação do título aceitam apenas URL, sem cargos, canais ou emojis. Menções em incorporações clássicas não notificam.

Limites e imagens

Cada servidor permite até 50 composições e cada composição até dez incorporações. Cada seleção de cargos permite até 25 opções. V2 permite 40 componentes no total, incluindo contentores, texto, imagens, linhas de ações e controlos. As opções de menu não contam individualmente. Os ficheiros de imagem podem ter até 8 MB. Confira o orçamento antes de guardar.

Usar a pré-visualização Discord

A pré-visualização mostra texto, ordem, imagens e controlos no formato escolhido. Abra o menu ou prima um botão para simular a seleção. Nenhum membro real recebe cargos. Carregue primeiro os recursos do servidor para disponibilizar cargos e emojis. Teste a atribuição real no Discord após publicar.

Gerir incorporações

Expanda as incorporações para as editar. Pode reordenar, duplicar e remover. Duplicar um contentor V2 copia também os seus controlos de cargos. Remover o contentor remove esses controlos. Uma cópia que ultrapasse os limites de incorporações ou componentes é bloqueada.

As composições têm um nome interno de até 100 caracteres, mostrado apenas no painel. Uma cópia é independente do original. Confira o canal e as opções antes de publicar. Guardar aplica as alterações. Cancelar descarta as pendentes.

Guarde ou descarte alterações pendentes antes de editar outra composição, criar uma nova, duplicar ou eliminar.

Gerir rascunhos e publicações

Guarde sem canal de destino para manter um rascunho. Com um canal, guardar publica a mensagem e alterações posteriores atualizam a mesma mensagem. Ao mudar de canal, publica-se primeiro no novo canal e depois remove-se a publicação antiga. Guardar novamente recria uma mensagem Discord em falta. As alterações têm efeito após guardar.

Remover publicação elimina apenas a mensagem Discord e mantém o rascunho. Eliminar composição também remove a publicação associada. Duplicar cria uma cópia independente cuja publicação configura separadamente.

Resolver problemas

Se faltarem cargos, verifique Gerir cargos, a hierarquia e as permissões administrativas dos cargos de destino. Se a publicação falhar, confira o canal e as permissões. Remova elementos se ultrapassar o orçamento. Teste com um membro normal no Discord. A pré-visualização do painel não altera os cargos dos membros.

Requisitos e limites

Uma apresentação válida não exige todas as áreas opcionais. Só cor ou blocos vazios não fornecem conteúdo visível para publicar. A pré-visualização não envia mensagens nem substitui um teste no canal. Nenhum editor oferece sondagens, stickers, formulários ou ações programáveis. Dados e opções de edição dependem também das permissões concedidas no painel.

Pré-visualização, spoilers e ficheiros de imagem

Na pré-visualização V2, uma imagem de galeria mantém a sua proporção. Várias imagens formam uma grelha com recortes iguais de 16:9. Duas ou quatro imagens usam duas colunas, três e entre cinco e dez usam três colunas. A miniatura aparece à direita do texto da secção. A descrição fornece texto alternativo, não uma legenda visível adicional.

Os interruptores de spoiler de imagem e contentor pertencem ao editor V2. As imagens de galeria e miniaturas podem ser ocultadas separadamente. Um spoiler de contentor oculta o conteúdo, mantendo a moldura exterior visível. Um clique revela a pré-visualização sem alterar a definição guardada. Os membros também podem revelar spoilers com um clique no Discord.

As imagens de mensagens aceitam PNG, JPG/JPEG, WebP e GIF. O tipo de ficheiro deve corresponder ao conteúdo. Alterar a extensão de um ficheiro HTML ou SVG não o transforma numa imagem suportada. Os limites das tabelas continuam a aplicar-se a cada ficheiro. Se uma imagem local for rejeitada ou deixar de poder ser lida, selecione novamente o ficheiro original e volte a guardar.

As áreas de texto Markdown aceitam ligações web e de correio eletrónico. A pré-visualização abre ligações HTTP(S) e mailto, mas não ficheiros locais nem endereços Blob. Ligações de autor, título e botões de ligação exigem URL HTTP(S) completos. A pré-visualização não publica mensagens. Verifique o resultado guardado no Discord, cuja apresentação pode variar com o cliente e a largura do ecrã.