Fjord

Documentação Fjord

Módulos

04

Incorporações

Crie mensagens estruturadas no editor visual sem escrever JSON.

Funções incluídas

  • Títulos, descrições, campos e multimédia
  • Pré-visualização durante a edição
  • Guardar e voltar a editar

O que pode criar com incorporações?

Crie mensagens Discord no editor visual e confira-as na pré-visualização. Combine texto, campos, imagens e cores, guarde rascunhos ou publique mensagens num canal e atualize-as mais tarde.

Compreender as composições

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.

O nome de uma composição é usado apenas para gerenciamento no dashboard e não é enviado ao Discord. Até 50 composições com nomes de no máximo 50 caracteres cada podem ser armazenadas por servidor.

EstadoComportamento
RascunhoSem um canal de destino, a composição será salva, mas não publicada no Discord.
Publicação gerenciadaCom o canal de destino, salvar cria uma mensagem do Discord permanentemente associada à composição. Outras alterações atualizarão esta mensagem exata.
Enviar uma vezEnvia a mensagem atual sem salvar a composição ou criar um link posterior. Esta opção só existe antes do primeiro salvamento.

Componentes V1 / V2

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

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.

EntradaLimite de caracteresEstado
Autor256Opcional
URL do autor512Opcional
Título256Opcional
Link do título (opcional)512Opcional
Descrição4096Opcional
Texto do rodapé2048Opcional
Nome do campo256Obrigatório após adicionar
Valor do campo1024Obrigatório após adicionar

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.

V2 agrupa até cinco botões de ligação numa linha de ações. Aplica-se o limite total de componentes em vez das cinco linhas de V1.

Botões de ligação abrem páginas web e não atribuem cargos. Cada botão adicionado exige rótulo de até 80 caracteres e URL HTTP(S) completo de até 512 caracteres. Emoji opcional. Podem ser ordenados e removidos. V1 mostra-os abaixo das incorporações com cinco botões por linha e cinco linhas no total, até 25 botões. V2 coloca-os no contentor respetivo e conta botões e linhas no orçamento de 40.

Criar composição

O nome interno é obrigatório mesmo ao guardar só um rascunho. O editor aceita até 50 caracteres. Novas composições recebem um nome sugerido editável. Só aparece no painel. Publicar exige canal acessível e texto visível, incorporação ou botão de ligação completo. Uma descrição ou imagem não exige título. Um rascunho vazio ainda não precisa de conteúdo.

Direitos necessários no Discord

Ver canal Enviar mensagens Incorporar links Anexar arquivos Mencionar @everyone, @here e todos os cargos

Em V1, as menções do texto normal podem notificar, mas as incorporações clássicas não. Em V2, blocos de texto também podem gerar menções. Para @everyone, @here e cargos não mencionáveis por todos, o Fjord precisa da permissão Discord correspondente. Reveja as menções antes de publicar.

Ver canal e Enviar mensagens são necessários para publicar. Incorporar ligações é necessário para incorporações clássicas e suas imagens. Anexar ficheiros é exigido no envio único de imagens locais. Guardar um rascunho ainda não publica uma mensagem Discord.

  1. Abra Incorporações no painel.
  2. Selecione Nova composição e atribua um nome interno.
  3. Adicione conteúdo normal da mensagem, se necessário.
  4. Projete a primeira incorporação e adicione incorporações adicionais, se necessário.
  5. Confira o resultado na visualização do Discord.
  6. Escolha um canal de destino para publicação ou deixe o canal em branco para salvar apenas um rascunho.
Nome da composiçãoObrigatório

É usado exclusivamente para administração no dashboard e pode conter no máximo 50 caracteres.

Conteúdo da mensagemOpcional

O texto normal é opcional e limitado a 2.000 caracteres. Uma publicação pode conter apenas texto. É necessário conteúdo visível. Verifique também os limites do formato e de componentes.

IncorporaçãoOpcional

As incorporações são opcionais. Pode criar até dez. Em V2, o orçamento partilhado também limita a quantidade e o conteúdo.

Canal de destinoOpcional

Sem um canal de destino, um rascunho é salvo. Um canal de destino acessível é obrigatório para publicação.

Conteúdo da mensagem

O conteúdo normal da mensagem aparece acima das incorporações e pode conter até 2.000 caracteres. Funções, canais e emojis de servidor podem ser usados através da seleção no editor.

Em V1, as menções do texto normal podem notificar, mas as incorporações clássicas não. Em V2, blocos de texto também podem gerar menções. Para @everyone, @here e cargos não mencionáveis por todos, o Fjord precisa da permissão Discord correspondente. Reveja as menções antes de publicar.

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}

Contentor

Cores rápidas · 10

Bloco de texto

Markdown · 4000

Secção com miniatura

Markdown · 4000 · Thumbnail ≤ 5 MB

Imagem

PNG · JPG/JPEG · WebP · GIF ≤ 10 MB

Separador

Mostrar linha divisória · Pequeno / Grande

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.

Usar 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é 10 MB. O envio único no módulo de incorporações permite dez imagens locais com um total de 20 MB.

Thumbnail5 MB
Imagem10 MB

Salvar e publicar

Se a mensagem gerida já não existir no Discord, guardar novamente volta a publicá-la. Uma composição duplicada mantém o formato, começa sem canal de publicação e é independente do original.

Salvar como rascunho

Deixe a seleção do canal em branco e salve. O rascunho permanece disponível no painel sem criar uma mensagem no Discord.

Publicar permanentemente

Selecione um canal e salve. A mensagem Discord criada permanece vinculada à composição. As alterações subsequentes serão atualizadas na mesma mensagem quando salvas.

Adiar publicação

Se você escolher um canal diferente para uma composição que já foi publicada, na próxima vez que salvá-la, a nova mensagem será criada primeiro e depois a antiga será removida.

Remover publicação

Remover postagem exclui apenas a mensagem gerenciada do Discord. A composição permanece como um rascunho salvo.

Excluir composição

Apagar uma composição remove o registo guardado e as imagens armazenadas. Não apaga uma mensagem Discord já enviada, que pode perder referências de imagens. Para remover também a mensagem gerida, retire explicitamente a publicação primeiro. Mensagens de envio único não são geridas depois.

Gerenciar e duplicar

As composições salvas podem ser abertas, renomeadas, duplicadas e excluídas. Até dez incorporações podem ser criadas, reorganizadas e duplicadas em uma composição. A duplicação é evitada se isso exceder os limites de número ou texto do Discord.

Pode alternar entre as composições e a vista geral dentro do módulo. As alterações não guardadas são mantidas. Antes de sair do módulo, guarde ou descarte todas as alterações pendentes. A barra de gravação comum permanece visível na vista geral. Guardar aplica todas as alterações pendentes das composições. Cancelar descarta-as. Isto inclui composições que não estão abertas nesse momento.

Corrigir erros

ObservaçãoExame
A mensagem não pode ser publicada.Um canal de texto acessível foi selecionado e o Fjord tem permissão para enviar mensagens e incorporações nele?
Uma imagem foi rejeitada.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é 10 MB. O envio único no módulo de incorporações permite dez imagens locais com um total de 20 MB.
Enviar uma vez não está disponível.A função só está disponível antes do primeiro salvamento e é limitada a dez anexos locais.
Uma função não é mencionada.Em V1, as menções do texto normal podem notificar, mas as incorporações clássicas não. Em V2, blocos de texto também podem gerar menções. Para @everyone, @here e cargos não mencionáveis por todos, o Fjord precisa da permissão Discord correspondente. Reveja as menções antes de publicar.
O canal salvo não está mais disponível.Selecione um canal existente no qual o Fjord possa publicar e salve novamente.

Marcadores de composições

Use os marcadores seguintes no texto normal das duas versões e nos campos clássicos V1. São substituídos ao enviar ou atualizar, não continuamente. Atualmente os marcadores de servidor, canal e bot não são substituídos nos blocos V2. O token de tempo descrito acima funciona aí. Marcadores de membro e avatares dinâmicos pertencem a boas-vindas.

{member.guild.member_count}Número de membros
{guild.owner.mention}Menção do proprietário
{member.guild.name}Nome do servidor
{guild.owner.id}ID do proprietário
{channel.mention}Menção do canal de destino
{time.relative}Tempo relativo
{channel.id}ID do canal de destino
{bot.mention}Menção do bot
{time.full}Data e hora
{guild.id}ID do servidor
{bot.name}Nome do bot
{bot.id}ID do bot

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ã.