Guia · 1 de setembro de 2026 · 3 min de leitura

Mensagens de bot com a cara do teu servidor

Um embed bem feito lê-se em três segundos. Um embed mal feito parece um formulário administrativo — e nas mensagens automáticas que o bot envia todos os dias, a diferença nota-se.

Os limites, a conhecer antes de desenhar

O Discord impõe tetos que só se veem no momento do envio. Uma mensagem recusada por excesso não indica claramente o que transbordou.

O que torna um embed legível

Uma só ideia por embed. Uma mensagem que anuncia uma subida de nível, relembra o regulamento e propõe uma ligação de voto não será lida por nenhuma das três coisas.

Uma cor que queira dizer alguma coisa. Usar o mesmo tom para um sucesso e para uma sanção desperdiça o único sinal instantâneo de que dispões. Verde para o que resulta, laranja para o que avisa, vermelho para o que bloqueia: é convencionado, e lê-se sem esforço.

Campos curtos, ou nenhum campo. Os campos servem para alinhar pares etiqueta-valor. Pôr lá parágrafos produz duas colunas de texto ilegíveis no telemóvel, onde o embed aparece de qualquer forma numa só coluna.

Texto, não decoração. Os separadores em emojis e as molduras de traços envelhecem mal e complicam a leitura por leitores de ecrã.

As variáveis

Um modelo de mensagem contém variáveis substituídas no envio: a alcunha, o nome do servidor, o número de membros, o nível atingido. É o que distingue uma mensagem personalizada de um texto fixo.

Impõe-se uma precaução: testar com valores extremos. Um modelo validado com «Bob» transborda logo com a primeira alcunha de trinta caracteres, e o problema só aparece em produção. O mesmo vale para um número de membros com cinco algarismos, ou um motivo de sanção de duas linhas.

As imagens geradas

Um cartão de boas-vindas ou de subida de nível compõe-se de um fundo, do avatar do membro e de texto. Três pontos aparecem sistematicamente.

O contraste do texto sobre o fundo. Uma imagem de fundo clara com texto branco é ilegível, e um fundo fotográfico varia de zona para zona. Um véu escuro por baixo da zona de texto resolve o problema de uma vez por todas.

A disponibilidade do avatar. É obtido no Discord, que falha de vez em quando. Um sistema correto tenta de novo e depois mostra um distintivo de recurso — em vez de abandonar a imagem inteira e passar a texto uma vez em cada dez.

Os emojis. Não aparecem nas imagens geradas: o tipo de letra usado para compor a imagem não os contém, e saem como quadrados vazios. A reservar para o texto da mensagem, não para a imagem.

Trabalhar com uma pré-visualização

Compor um embed às cegas e depois enviá-lo para ver o resultado custa três ou quatro idas e vindas por alteração. Um editor com pré-visualização em direto elimina esse ciclo, e sobretudo permite verificar o resultado antes de uma mensagem automática sair para o servidor inteiro.

Guardar modelos reutilizáveis — anúncio, evento, aviso — evita reconstruir a mesma formatação todas as semanas, e garante que as mensagens do servidor se parecem umas com as outras.

Perguntas frequentes

Pode enviar-se um embed com o nome do servidor?

O embed leva sempre o nome do bot. Um webhook permite outro nome e outra imagem, com uma contrapartida: qualquer pessoa que tenha o endereço do webhook pode publicar nesse lugar.

Porque não aparece o meu embed?

Na maioria das vezes, um limite ultrapassado ou uma cor inválida. A seguir, a permissão de incorporar ligações em falta no canal.

As imagens têm de estar alojadas algures?

Sim, o embed refere um endereço. Uma imagem alojada num serviço que desaparece deixa uma moldura vazia vários meses depois.

Quantos embeds numa mensagem?

Até dez, e é muito raramente boa ideia. Dois chegam quase sempre; acima disso, a mensagem torna-se um muro.

Ler a seguir : Mensagem de boas-vindas, O painel web, XP e níveis.