Documentação Fjord
Módulos
01
Boas-vindas
Dê as boas-vindas, despeça-se e atribua cargos automaticamente.
Funções incluídas
- Mensagens personalizadas de boas-vindas e despedida
- Cartões de boas-vindas com design próprio
- Cargos automáticos para novos membros
- Canais separados para entradas e saídas
O que pode ser bem-vindo?
Com Bem-vindo você pode cumprimentar automaticamente novos membros, dizer adeus aos membros que estão saindo e atribuir funções ao ingressar. Todas as três áreas podem ser usadas independentemente umas das outras.
Direitos necessários no Discord
“Anexar arquivos” é necessário para o cartão de boas-vindas. Gerenciar funções só é necessário para funções automáticas.
Configuração
- Selecione o servidor que deseja gerenciar.
- Abra Bem-vindo.
- Ative as mensagens de boas-vindas, as mensagens de despedida ou os cargos automáticos.
- Selecione um canal de texto acessível ou pelo menos uma função.
- Verifique a pré-visualização e guarde as alterações.
Para funções automáticas, a função Fjord deve estar acima de todas as funções a serem atribuídas.
Mensagem de boas-vindas
O interruptor e o canal podem ser editados separadamente. Desativar mantém o canal escolhido. Nenhum canal apenas limpa a seleção inicialmente, o editor continua acessível. Guardar sem canal desativa o serviço correspondente e fecha o seu editor. Isto aplica-se a boas-vindas e despedida.
A mensagem de boas-vindas é enviada assim que um membro entra no servidor. O canal, o texto da mensagem e o cartão de boas-vindas são salvos juntos. Uma visualização mostra como o texto e o cartão interagem antes de salvar.
Ativa ou desativa a saudação automática.
Determina em qual canal de texto acessível a saudação é publicada.
Contém o texto normal da mensagem. Espaços reservados, funções, canais e emojis de servidor podem ser usados por meio das seleções.
Adiciona um cartão com imagem personalizado às boas-vindas.
Espaço reservado para mensagens
| Espaço reservado | É substituído por | Exemplo |
|---|---|---|
{member.user.name} | Nome de utilizador Discord do membro | corvus48 |
{member.mention} | Menção do novo membro | @Mira |
{member.user.id} | ID de usuário do membro no Discord | 123456789012345678 |
{member.user.global_name} | Nome de exibição global do membro | Mira |
{guild.name} | Nome do servidor | Comunidade Fjord |
{guild.member_count} | Número atual de membros | 1.248 |
Use a seleção de marcadores de posição no editor. Dessa forma, o nome é usado com exatidão e evitam-se erros de digitação entre chaves.
Editores de mensagens e cartões anexados
{guild.icon} | Ícone do servidor |
{member.avatar} | Avatar do membro |
Sem configuração guardada, boas-vindas tem o cartão ativo e as incorporações desligadas. Despedida começa com texto normal, sem incorporação nem cartão. Boas-vindas, despedida e cargos de entrada são ativados independentemente. Ambos os editores oferecem V1 e V2, texto e incorporações opcionais. O interruptor do cartão gerado fica no editor de boas-vindas. Texto vazio usa o texto predefinido apresentado.
Conteúdo até 1.800 caracteres, separado do texto das incorporações.
Boas-vindas e despedida têm seletores V1/V2 separados. A mudança exige confirmação e repõe o texto, incorporações, imagens e botões de ligação desse editor. Canal, ativação e desenho separado do cartão mantêm-se. Guardar aplica a mudança. Cancelar recupera o estado guardado anterior.
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.
| Entrada | Limite de caracteres | Estado |
|---|---|---|
| Autor | 256 | Opcional |
| URL do autor | 512 | Opcional |
| Título | 256 | Opcional |
| Link do título (opcional) | 512 | Opcional |
| Descrição | 4096 | Opcional |
| Texto do rodapé | 2048 | Opcional |
| Nome do campo | 256 | Obrigatório após adicionar |
| Valor do campo | 1024 | Obrigató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.
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}
Cores rápidas · 10
Markdown · 4000
Markdown · 4000 · Thumbnail ≤ 5 MB
PNG · JPG/JPEG · WebP · GIF ≤ 10 MB
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.
Os seis marcadores de mensagem também funcionam nos textos dos dois formatos. Sem nome global, usa-se o nome de utilizador. A menção do membro não aparece em áreas V1 sem suporte a menções. Para ícone de autor, miniatura, imagem grande e ícone de rodapé V1, e miniaturas e imagens V2, escolha imagem própria, ícone do servidor ou avatar do membro. Sem ícone de servidor, a imagem fica vazia. A pré-visualização usa a sua conta e o envio usa o membro real. Estas fontes dinâmicas são exclusivas de boas-vindas e despedida.
Com incorporações desligadas, o cartão de boas-vindas ativo é enviado como imagem separada com texto normal. Com incorporações ligadas, ocupa a imagem grande da primeira incorporação V1 ou entra no primeiro contentor V2. Não pode substituir esse espaço com a sua imagem grande. Outras incorporações e blocos de imagem V2 adicionais aceitam imagens próprias. Após reordenar, o cartão pertence à nova primeira incorporação. O desenho do cartão é independente de V1/V2.
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.
Inserir conteúdo nas mensagens
O editor de mensagens tem suas próprias seleções para espaços reservados, funções, canais e emojis de servidor. Uma entrada selecionada é inserida na posição de escrita atual.
| Seleção | Uso |
|---|---|
| Marcador de posição | Insere informações dinâmicas de membro ou servidor da tabela acima. |
| Funções | Navegue pelas funções do servidor e insira a menção da função desejada. @todos não está disponível para seleção. |
| Canais | Navegue pelos canais disponíveis e defina um link de canal. |
| Emojis de servidor | Navegue pelos emojis do próprio servidor e insira um emoji de servidor estático ou animado. |
Você pode abrir as seleções usando os botões do editor. Enquanto escreve, @ abre a seleção de função, # abre a seleção de canal e : abre a seleção de emoji do servidor. Outros caracteres inseridos filtram a respectiva lista.
As mensagens de boas-vindas e de despedida podem conter no máximo 1.800 caracteres cada. As entradas inseridas contam como parte do conteúdo da mensagem.
Criar cartão de boas-vindas
O editor de cartões oferece Conteúdo, Disposição, Superfície, Anel e Texto.
Conteúdo inclui imagem de fundo, fundo colorido opcional, título, subtítulo e fontes com pesquisa, pré-visualizações e páginas.
Disposição oferece Esquerda ou Centrado.
Superfície oferece opacidade normal de 0–100 % ou camada Liquid opcional com cor, opacidade de 0–100 % e desfoque de 0–64 px. Liquid desativa o controlo de opacidade normal.
Anel oferece cor base, intensidade de 0–100 % e shader opcional com cor, força de 0–100 % e ângulo de 0–360°.
Texto oferece cor base, intensidade e shader opcional com cor, força e posição de 0–100 %.
Não há controlos livres de tamanho do avatar, tamanhos individuais de fonte ou posições arbitrárias de texto.
Repor recupera o desenho predefinido. Guardar ou Cancelar usa a barra comum.
Use o fundo predefinido, uma cor uniforme ou uma imagem própria. Mova e amplie a imagem no editor de recorte. Área oferece também uma camada líquida com cor, opacidade e desfoque.
| Propriedade | Nota | compatível |
|---|---|---|
| Tamanho do arquivo | Máximo de 10 MB | Arquivos maiores não podem ser salvos como plano de fundo. |
| Formatos de imagem | PNG, JPG/JPEG, WebP e GIF | O formato real do arquivo é verificado com base no conteúdo da imagem. |
| Formato do cartão | 1200 × 600 pixels | A imagem selecionada será cortada nesta seção do cartão no editor. |
| Animações | Resultado estático | O cartão finalizado é salvo como PNG. Portanto, as animações de arquivos GIF ou WebP não são retidas. |
Título ≤ 120 · Subtítulo ≤ 160
Marcadores do cartão
{member.user.name} · {guild.name} · {guild.member_count}
O cartão tem 1200 × 600 píxeis e é gerado como PNG estático. A pré-visualização usa a sua conta e dados de exemplo do servidor escolhido. Na entrada, são utilizados os dados do membro. A pré-visualização no navegador requer uma ligação válida ao painel.
Mensagem de despedida
O interruptor e o canal podem ser editados separadamente. Desativar mantém o canal escolhido. Nenhum canal apenas limpa a seleção inicialmente, o editor continua acessível. Guardar sem canal desativa o serviço correspondente e fecha o seu editor. Isto aplica-se a boas-vindas e despedida.
A mensagem de despedida é enviada quando um membro sai do servidor. Pode usar um canal de destino diferente e seu próprio texto. As menções nem sempre podem ser resolvidas após a saída. Por isso, prefira usar {member.user.global_name}.
Ativa ou desativa a despedida automática.
Determina em qual canal de texto acessível a mensagem de despedida será publicada.
Contém o texto de despedida com até 1.800 caracteres e os recursos de inserção disponíveis.
Funções automáticas
O Fjord pode atribuir diversas funções a novos membros imediatamente após a adesão. As funções gerenciadas pelo Discord e as funções acima da função Fjord não podem ser atribuídas.
Ativa ou desativa a atribuição de funções ao ingressar.
Navegue na seleção de funções e selecione pelo menos uma e no máximo 25 funções.
- Verifique em Configurações do servidor → Funções se a função Fjord está acima das funções alvo.
- Ative a atribuição automática de funções e selecione as funções desejadas.
- Salve a seleção.
Funções com amplos direitos administrativos não devem ser atribuídas automaticamente. O Fjord exibe apenas funções que geralmente podem ser atribuídas.
Corrigir erros
| Problema | Verificação |
|---|---|
| Nenhuma mensagem é enviada. | O serviço está ativado, o canal ainda está disponível e o Fjord tem permissão para vê-lo e escrever nele? |
| O cartão está faltando. | O cartão está ativado e o Fjord tem os “Anexar arquivos” diretamente no canal de destino? |
| Uma função não foi atribuída. | A função do Fjord está acima da função de destino e o Fjord tem a função “Gerenciar funções”, certo? |
| Um espaço reservado permanece inalterado. | Ele foi inserido usando a seleção de espaço reservado e a ortografia e os colchetes estão corretos? |
| As alterações não aparecem. | Guarde as alterações pendentes na barra comum, aplica as alterações de mensagens e cartão em conjunto. |
Botões de ligação
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.
Botões de ligação só são enviados com incorporações ativas.
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ã.
02
Automoderador
O automoderador deteta conteúdo indesejado e aplica as regras do servidor.
- Dez filtros para conteúdo, spam, links e menções
- Âmbitos separados para cargos e canais
- Até dez níveis com eliminação, timeout, expulsão ou banimento
03
Registo de atividade
Registe eventos importantes nos canais Discord escolhidos.
- 89 tipos de eventos suportados
- Um canal de registo comum
- Registos ativáveis separadamente
04
Incorporações
Crie mensagens estruturadas no editor visual sem escrever JSON.
- Títulos, descrições, campos e multimédia
- Pré-visualização durante a edição
- Guardar e voltar a editar
Cargos por reação
Os membros escolhem os seus cargos com botões e menus. Configure grupos de cargos, mensagens V1/V2 e publicações geridas.
Funções incluídas
- 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.
- Botões de cargos com legendas, emojis, quatro estilos e um ou vários cargos por opção
- Menus com texto indicativo, descrições, emojis e seleção única ou múltipla
- 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, mas não editor de botões de ligações web nem envio único.
- Pré-visualização com seleção de cargos simulada sem alterar cargos reais dos membros
- Nomear e duplicar composições, guardar rascunhos, publicar e atualizar mensagens e remover publicações
- Orientações sobre permissões e hierarquia de cargos, tamanhos de imagens e limites de texto e componentes
05
Definições
Em Definições, escolha o idioma, o fuso horário e a cor predefinida das incorporações, delegue o acesso ao painel e gira os dados guardados dos módulos.
- Cor predefinida das incorporações do bot
- Idioma e fuso horário
- Acesso delegado ao painel
- Gestão dos dados guardados dos módulos
06
Comandos
Todos os comandos slash do Fjord, as permissões e ajuda para resolver erros.