Como Enviar Webhook do Discord com Ícone de Autor Personalizado no Embed

Você quer enviar uma mensagem através de um webhook do Discord e incluir um embed com um ícone de autor personalizado. A API de webhook do Discord permite definir o campo author.icon_url no objeto embed, mas o ícone pode não aparecer se a URL não estiver acessível ou se o webhook não tiver as permissões corretas. Este artigo explica como construir o payload JSON corretamente, quais formatos de URL funcionam e como solucionar problemas quando o ícone não é exibido. Você aprenderá a estrutura JSON exata, os campos obrigatórios e os erros comuns que impedem o carregamento do ícone.

Como os Embeds do Webhook do Discord Lidam com o Ícone do Autor

Um webhook do Discord envia um payload JSON para um canal através de uma URL única. Quando você inclui um embed nesse payload, pode definir um objeto author com três campos opcionais: name (o nome do autor exibido acima do embed), url (um link clicável para o nome do autor) e icon_url (uma pequena imagem mostrada ao lado do nome do autor). O icon_url deve apontar para um arquivo de imagem direto hospedado em um servidor que o Discord possa acessar. O Discord armazena em cache a imagem após a primeira busca, então alterações no arquivo de imagem podem exigir uma nova URL ou uma limpeza de cache. O tamanho do ícone é 40×40 pixels; o Discord redimensiona imagens maiores automaticamente. Você não precisa de permissões especiais no webhook, mas o host da imagem não deve bloquear o user-agent do Discord ou exigir cookies.

Pré-requisitos para Usar um Ícone de Autor Personalizado

Antes de enviar um webhook com um ícone de autor personalizado, confirme estes itens:

• Você tem uma URL de webhook do Discord de um canal em um servidor onde tem permissão “Gerenciar Webhooks” ou é o proprietário do servidor.
• Você pode enviar requisições HTTP POST para essa URL usando uma ferramenta como cURL, Postman ou uma linguagem de programação (Python, JavaScript, etc.).
• A imagem que você deseja usar está hospedada em uma URL HTTPS pública. O Discord não aceita URLs HTTP para icon_url.
• O arquivo de imagem está em um formato suportado: PNG, JPEG, GIF (estático ou animado) ou WebP. GIFs animados não serão animados no ícone do autor; eles aparecem como um quadro estático.

Passos para Enviar um Webhook com um Ícone de Autor Personalizado no Embed

Siga estes passos para criar e enviar um payload de webhook que inclui um embed com um ícone de autor personalizado. O exemplo usa cURL, mas a estrutura JSON é idêntica para qualquer cliente HTTP.

1. Obtenha a URL do webhook
   Abra o Discord e vá em Configurações do Servidor > Integrações > Webhooks. Clique em “Novo Webhook” ou selecione um existente. Copie a URL do webhook. Ela se parece com https://discord.com/api/webhooks/1234567890/abcdef.
2. Prepare a URL da imagem
   Envie sua imagem para um host de imagem confiável como Imgur, CDN do Discord (enviando para um canal e copiando o link) ou seu próprio servidor. Certifique-se de que a URL comece com https:// e termine com uma extensão de arquivo. Exemplo: https://i.imgur.com/example.png.
3. Construa o payload JSON
   Crie um objeto JSON com um array embeds. Dentro de cada objeto embed, inclua um objeto author com name, url e icon_url. O campo url é opcional, mas recomendado se você quiser que o nome do autor seja um link clicável. Exemplo de payload:
   {
"embeds": [
{
"author": {
"name": "Equipe de Suporte",
"url": "https://example.com/suporte",
"icon_url": "https://i.imgur.com/example.png"
},
"title": "Atualização Importante",
"description": "Este é um embed de teste com um ícone de autor personalizado."
}
]
}
4. Envie a requisição POST
   Use cURL em um terminal ou prompt de comando:
   curl -X POST -H "Content-Type: application/json" -d '{"embeds":[{"author":{"name":"Equipe de Suporte","url":"https://example.com/suporte","icon_url":"https://i.imgur.com/example.png"},"title":"Atualização Importante","description":"Embed de teste"}]}' SUA_URL_WEBHOOK
   Substitua SUA_URL_WEBHOOK pela URL real que você copiou.
5. Verifique o embed no Discord
   Confira o canal onde o webhook posta. Você deve ver o embed com o ícone do autor ao lado do nome do autor. Se o ícone não aparecer, vá para a seção de solução de problemas.

Motivos Comuns para o Ícone do Autor Não Aparecer

Se o ícone do autor estiver faltando após enviar o webhook, um desses problemas é provavelmente a causa.

URL da Imagem Usa HTTP em Vez de HTTPS

O Discord bloqueia fontes de imagem HTTP por razões de segurança. Certifique-se de que seu icon_url comece com https://. Se você estiver usando uma imagem de um site que só serve HTTP, hospede novamente a imagem em um serviço que suporte HTTPS.

URL da Imagem Não Aponta Diretamente para o Arquivo de Imagem

Alguns serviços de hospedagem fornecem uma URL de página em vez de um link direto para a imagem. Por exemplo, um link compartilhado do Dropbox ou um link do Google Drive não funciona. A URL deve terminar com uma extensão de arquivo de imagem ou servir os dados binários brutos com o cabeçalho Content-Type correto. Use um serviço como Imgur, CDN do Discord ou um host de imagem dedicado que forneça links diretos.

Payload do Webhook Tem Erro de Sintaxe

Uma vírgula faltando, chave extra ou nome de campo incorreto pode fazer com que todo o embed falhe. Valide seu JSON com um linter antes de enviar. O objeto author deve estar dentro de um objeto embed, que deve estar dentro do array embeds. O nome do campo icon_url deve ser escrito exatamente como icon_url — não iconUrl ou icon-url.

Host da Imagem Bloqueia a Requisição de Busca do Discord

Alguns hosts de imagem têm proteção contra hotlink ou bloqueiam requisições de user-agents desconhecidos. O buscador de imagens do Discord usa uma string de user-agent específica. Se o host retornar um 403 Forbidden ou um redirecionamento para uma página de captcha, o ícone não carregará. Teste a URL no modo anônimo do navegador. Se carregar sem problemas, o host provavelmente permite o buscador do Discord. Se redirecionar ou mostrar um erro, escolha um host diferente.

Imagem é Muito Grande ou Formato Não Suportado

O Discord aceita imagens de até 256 KB para ícones de embed. Arquivos maiores podem ser ignorados silenciosamente. Além disso, certifique-se de que o formato do arquivo seja PNG, JPEG, GIF ou WebP. Arquivos SVG e BMP não são suportados.

Ícone de Autor no Embed do Webhook do Discord: Link Direto vs Hospedado no CDN do Discord

Item	Link Direto da Imagem (ex.: Imgur)	Link do CDN do Discord
Formato da URL	https://i.imgur.com/abc123.png	https://cdn.discordapp.com/attachments/…/filename.png
Confiabilidade	Boa, mas pode ser bloqueado em algumas regiões	Excelente, hospedado nos próprios servidores do Discord
Facilidade de obter a URL	Envie para um host de imagem, copie o link direto	Envie a imagem para qualquer canal do Discord, copie o link do anexo
Comportamento de cache	Depende do host; alterações podem não refletir imediatamente	O Discord faz cache agressivamente; pode levar horas para atualizar
Formatos suportados	PNG, JPEG, GIF, WebP	PNG, JPEG, GIF, WebP

Agora você pode enviar um webhook do Discord com um ícone de autor personalizado no embed usando a estrutura JSON correta e uma URL de imagem HTTPS direta. Se o ícone não aparecer, verifique o formato da URL, as restrições do host da imagem e a sintaxe do payload. Para uso avançado, considere hospedar o ícone no próprio CDN do Discord para máxima compatibilidade. Um próximo passo prático é experimentar adicionar múltiplos embeds na mesma mensagem do webhook, cada um com um ícone de autor diferente, incluindo vários objetos no array embeds.