Como Usar Webhook do Discord com GitHub Actions para Notificações de Deploy

Você quer enviar uma notificação para seu servidor Discord sempre que um workflow do GitHub Actions concluir um deploy. Um webhook é um callback HTTP simples que publica uma mensagem em um canal do Discord automaticamente. Usar um webhook do Discord com GitHub Actions elimina a necessidade de verificar manualmente a aba GitHub Actions. Este artigo explica … Leia mais

Por que os campos de embed do webhook do Discord aparecem na ordem errada apesar da definição

Quando você envia um webhook para o Discord com um embed que contém vários campos, os campos podem aparecer em uma ordem diferente da que você definiu no seu payload JSON. Isso acontece mesmo quando você lista os campos na sequência correta dentro do array fields. A causa raiz é como o Discord processa a propriedade inline … Leia mais

Como Criar um Webhook do Discord com Avatar Personalizado por Mensagem

Webhooks do Discord permitem enviar mensagens automatizadas para um canal de texto sem usar um bot completo. Por padrão, um webhook usa um nome e avatar fixos definidos na criação. Mas você pode querer que cada mensagem mostre um nome de usuário e foto de perfil diferentes, como para um bot de anúncios de múltiplas marcas ou um sistema de roleplay. Este artigo explica como construir um webhook do Discord que envia cada mensagem com avatar e nome de usuário personalizados usando a API de webhook. Você aprenderá a estrutura do payload, as permissões necessárias e como testar o webhook com curl ou um script simples.

Corrigir Limite de Taxa do Webhook do Discord em Notificações em Rajada dos Logs

Você vê a mensagem de erro “You are being rate limited” nos logs do servidor após enviar várias notificações de um bot ou integração. Isso acontece quando seu webhook envia mais de 5 requisições por segundo para a API do Discord. O Discord impõe esse limite para evitar spam e proteger o desempenho do servidor. Este artigo explica por que notificações em rajada … Leia mais

Como Enviar Arquivos via Webhook do Discord com Multipart Form Data Corretamente

Quando você envia uma mensagem para um webhook do Discord, pode anexar arquivos diretamente, em vez de apenas postar texto ou URLs. Muitos desenvolvedores tentam usar payloads JSON simples e depois se perguntam por que seus anexos falham ou aparecem como links quebrados. A abordagem correta exige o uso da codificação multipart/form-data, que permite incluir tanto os dados binários do arquivo quanto o payload JSON em uma única requisição HTTP. Este artigo explica exatamente como estruturar essa requisição multipart, quais campos são necessários e como evitar as armadilhas comuns que fazem o Discord rejeitar o upload.

Por que menções @everyone em webhooks do Discord não disparam notificações

Você configurou um webhook do Discord para postar anúncios automaticamente no servidor. A mensagem inclui @everyone, mas os membros relatam que nunca receberam uma notificação. Isso acontece porque webhooks exigem permissão explícita para mencionar @everyone e @here, e as configurações padrão não concedem essa permissão. Este artigo explica por que as menções @everyone em webhooks falham ao … Leia mais

Corrigir erro 404 do webhook do Discord após URL ser regenerada silenciosamente

Você configurou um webhook do Discord para enviar mensagens automáticas do seu aplicativo ou bot, e tudo funcionava bem até que um dia todas as requisições começaram a retornar erro 404. Isso geralmente acontece porque a URL do webhook foi regenerada sem que ninguém percebesse — muitas vezes por outro administrador do servidor ou por meio de uma redefinição de segurança. A URL antiga … Leia mais

Como Enviar Mensagens de Webhook do Discord com Lista de Menções Permitidas

Ao enviar mensagens por um webhook do Discord, você pode mencionar @everyone, @here, cargos ou usuários individuais. Por padrão, um webhook pode mencionar qualquer um desses alvos. Isso pode causar notificações indesejadas se um webhook for mal utilizado ou enviar uma mensagem que marque um grupo grande por engano. A lista de menções permitidas (allowed mentions whitelist) permite restringir quais menções o webhook pode realmente disparar. Este artigo explica como configurar o objeto allowed_mentions no payload do webhook para que apenas cargos ou usuários aprovados possam ser mencionados.

Por que a substituição do nome de usuário do webhook do Discord é revertida após tentar editar

Você edita uma mensagem de webhook do Discord para alterar o nome de usuário, mas após salvar, o nome volta ao padrão do webhook. Isso acontece porque o Discord trata a substituição do nome de usuário como um atributo único aplicado apenas no envio inicial. O sistema de webhook não permite alterações retroativas no nome exibido após a mensagem existir. Leia mais