Testador de Webhook do Discord

Teste seu webhook do Discord em segundos. Cole a URL, valide e envie uma mensagem de teste para ter certeza de que funciona.

O que é um webhook do Discord?

Um webhook do Discord é uma URL exclusiva que permite enviar mensagens para um canal específico do Discord sem precisar de um bot. Webhooks são muito usados para notificações do GitHub, alertas de monitoramento de servidores, atualizações de pipelines de CI/CD e integrações personalizadas. Cada webhook tem nome e avatar próprios e está vinculado a um canal específico.

Como criar um webhook do Discord

1. Abra seu servidor do Discord e vá em Configurações do servidor
2. Vá em Integrações > Webhooks
3. Clique em Novo webhook
4. Defina um nome e escolha o canal de destino
5. Clique em Copiar URL do webhook
6. Cole a URL no testador acima para confirmar que funciona

Como este testador funciona

Cole a URL do seu webhook e clique em Verificar. A ferramenta valida a URL na API do Discord e mostra o nome, o avatar e o canal vinculado do webhook. Se ela for válida, você pode digitar uma mensagem personalizada e enviá-la pelo webhook para confirmar que está funcionando. A URL do seu webhook passa pelo nosso servidor por segurança (navegadores não podem chamar a API do Discord diretamente por causa do CORS), mas nunca é armazenada nem registrada.

Códigos de erro comuns de webhooks do Discord

Quando uma requisição de webhook falha, o Discord retorna um status HTTP com um corpo JSON contendo um code numérico e uma message. Estes são os que você vai encontrar de verdade:

• 400 Bad Request - Corpo JSON malformado, embed acima de 6.000 caracteres no total, ou um campo maior que o limite. Valide seu payload localmente antes de enviar.
• 401 Unauthorized - O token do webhook está errado ou foi regenerado. Regenerar um webhook nas configurações do servidor invalida a URL antiga na hora.
• 404 Not Found - O webhook foi excluído, o canal foi excluído, ou a URL tem um erro de digitação. Copie a URL de novo em Configurações do servidor > Integrações.
• 429 Too Many Requests - Você atingiu um limite de taxa. O Discord retorna um campo retry_after (em segundos) informando quando tentar de novo. Respeite esse valor.
• Code 50027 (Invalid Webhook Token) - Mesma causa do 401, retornado quando o trecho do token na URL está corrompido ou truncado.
• Code 50006 (Cannot send empty message) - Seu payload não tem content, nem embeds, nem files. Pelo menos um é obrigatório.
• Code 50035 (Invalid Form Body) - Causa mais comum: embed.color enviado como string hexadecimal em vez de inteiro decimal. Converta #9B59B6 para 10181046 antes de enviar.

Limites de taxa dos webhooks do Discord

O Discord aplica limites de taxa por webhook e por canal, e o tamanho exato de cada bucket é definido no servidor e exposto nos cabeçalhos da resposta, e não como um número fixo. Toda resposta bem-sucedida inclui X-RateLimit-Limit, X-RateLimit-Remaining e X-RateLimit-Reset-After - leia esses cabeçalhos para agendar a próxima requisição e não fixe uma taxa no código. O corpo de uma resposta 429 também traz um valor retry_after (em segundos). Para integrações de alto volume (pipelines de build, agregação de logs), junte vários eventos em uma única mensagem: uma chamada de webhook pode levar até 10 embeds com até 6.000 caracteres combinados por embed, o que costuma bastar para consolidar uma rajada de eventos em uma requisição.

Boas práticas de segurança para webhooks

Uma URL de webhook é uma credencial de portador. Qualquer pessoa com a URL completa pode publicar no seu canal como o bot do webhook, sem nenhuma outra autenticação. Trate ela como uma senha:

• Nunca faça commit de URLs de webhook em um repositório Git público. O escaneamento de segredos do GitHub detecta e revoga webhooks do Discord vazados automaticamente, mas só depois de eles já terem sido expostos.
• Guarde as URLs de webhook em variáveis de ambiente ou em um gerenciador de segredos, não no código-fonte nem em arquivos de configuração versionados.
• Se um webhook for exposto, exclua ele imediatamente em Configurações do servidor > Integrações > Webhooks. Recriá-lo gera um token novo; a URL antiga para de funcionar.
• Para uso no cliente (um app de navegador publicando no Discord), encaminhe a chamada pelo seu próprio backend para que a URL nunca chegue ao navegador do usuário. Uma URL vazada de um app de navegador é um ímã para vandalismo.
• Os webhooks do Discord ignoram as menções @everyone e @here a menos que allowed_mentions permita isso explicitamente. Use "parse": [] para desativar todos os pings de menção se você não precisar deles.

Teste manual de webhook com curl

Se você preferir testar pelo terminal, o payload mínimo é um único campo content. Um POST bem-sucedido retorna HTTP 204 com corpo vazio, ou HTTP 200 com o JSON da mensagem criada se você acrescentar ?wait=true à URL. Use ?wait=true quando precisar do ID da mensagem de volta (por exemplo, para editar ou excluir a mensagem depois pelo endpoint /webhooks/<id>/<token>/messages/<message_id>).

Mais ferramentas gratuitas para Discord

• Snowflake Checker - Veja a idade de qualquer conta do Discord
• Colored Text Generator - Crie mensagens coloridas com códigos ANSI
• Message Length Counter - Veja se sua mensagem cabe nos limites do Discord
• Color Role Previewer - Visualize cores de cargo em todos os temas do Discord

Desenvolvido por Pigona - Tradução gratuita para Discord