Como Editar ou Excluir uma Mensagem de Webhook do Discord

Você precisa editar ou excluir uma mensagem enviada por um webhook do Discord, mas os botões normais de editar e excluir estão ausentes. Webhooks do Discord são bots automatizados que postam mensagens em canais e não aparecem no histórico de chat como mensagens de usuários comuns. Este artigo explica os métodos exatos para editar e excluir mensagens de webhook usando a API do Discord e comandos cURL. Você aprenderá como encontrar os IDs necessários e executar as requisições HTTP corretas.

Como Funcionam as Mensagens de Webhook do Discord

Um webhook do Discord é uma forma simples de enviar mensagens automatizadas para um canal de texto. Ao criar um webhook em Configurações do Servidor > Integrações, o Discord gera uma URL única que inclui um ID de webhook e um token de webhook. Qualquer aplicação pode enviar uma requisição HTTP POST para essa URL para postar uma mensagem. A mensagem aparece como um usuário bot com o nome e avatar do webhook.

As mensagens de webhook não estão vinculadas a uma conta de usuário real do Discord. O cliente do Discord não exibe os botões padrão de editar ou excluir nessas mensagens porque o webhook não é um usuário logado. Para editar ou excluir uma mensagem de webhook, você deve usar a API do Discord diretamente com os métodos HTTP e IDs corretos.

A API requer o ID do webhook, o token do webhook e o ID da mensagem. O ID e o token do webhook fazem parte da URL do webhook. O ID da mensagem é o identificador único da mensagem de webhook no canal. Você pode obter esses IDs ativando o Modo Desenvolvedor no Discord.

Pré-requisitos para Editar ou Excluir uma Mensagem de Webhook

Antes de editar ou excluir uma mensagem de webhook, você precisa de três informações:

• ID e Token do Webhook: Encontrados na URL do webhook. O formato da URL é https://discord.com/api/webhooks/{webhook.id}/{webhook.token}. Você também pode encontrá-los em Configurações do Servidor > Integrações > Webhooks clicando no nome do webhook e depois revelando o token.
• ID da Mensagem: O identificador único da mensagem de webhook específica. Ative o Modo Desenvolvedor em Configurações do Usuário > Avançado > Modo Desenvolvedor. Em seguida, clique com o botão direito na mensagem de webhook e selecione Copiar ID da Mensagem.
• Uma ferramenta para enviar requisições HTTP: Este guia usa cURL, que já vem integrado no Windows 10 e Windows 11. Você também pode usar Postman ou qualquer linguagem de programação que suporte requisições HTTP.

Passos para Editar uma Mensagem de Webhook do Discord

1. Ative o Modo Desenvolvedor no Discord
   Abra o Discord. Vá em Configurações do Usuário clicando no ícone de engrenagem ao lado do seu nome de usuário. Selecione Avançado na barra lateral esquerda. Ative o Modo Desenvolvedor. Isso permite copiar IDs clicando com o botão direito em mensagens, canais e usuários.
2. Copie o ID da Mensagem do Webhook
   Navegue até o canal onde a mensagem de webhook está postada. Clique com o botão direito na mensagem de webhook. No menu de contexto, selecione Copiar ID da Mensagem. Armazene esse ID em um arquivo de texto para usar depois.
3. Obtenha o ID e o Token do Webhook
   Vá até seu servidor. Clique no nome do servidor no canto superior esquerdo. Selecione Configurações do Servidor > Integrações. Encontre o webhook que enviou a mensagem. Clique no nome do webhook. O ID do webhook é o número longo na URL após /webhooks/. Clique em Revelar Token para ver o token do webhook. Copie tanto o ID quanto o token.
4. Abra o Prompt de Comando ou Terminal
   Pressione a tecla Windows, digite cmd e pressione Enter. Alternativamente, você pode usar PowerShell ou qualquer terminal que suporte cURL.
5. Execute o Comando cURL para Editar a Mensagem
   Digite o seguinte comando, substituindo os placeholders pelos seus valores reais. Este comando envia uma requisição PATCH para a API do Discord.
   curl -X PATCH https://discord.com/api/webhooks/WEBHOOK_ID/WEBHOOK_TOKEN/messages/MESSAGE_ID -H "Content-Type: application/json" -d "{\"content\": \"Esta é a mensagem de webhook editada.\"}"
   Substitua WEBHOOK_ID, WEBHOOK_TOKEN e MESSAGE_ID pelos valores que você copiou. O campo content contém o novo texto da mensagem. Pressione Enter para executar o comando.
6. Verifique a Edição
   Volte ao seu canal do Discord. A mensagem de webhook agora deve exibir o novo conteúdo. Se você vir um erro, verifique novamente se todos os IDs estão corretos e se o token do webhook não foi regenerado.

Passos para Excluir uma Mensagem de Webhook do Discord

1. Ative o Modo Desenvolvedor e Copie os IDs
   Siga os passos 1 a 3 da seção de edição para ativar o Modo Desenvolvedor e copiar o ID do webhook, token do webhook e ID da mensagem.
2. Abra o Prompt de Comando ou Terminal
   Pressione a tecla Windows, digite cmd e pressione Enter.
3. Execute o Comando cURL para Excluir a Mensagem
   Digite o seguinte comando, substituindo os placeholders pelos seus valores reais. Este comando envia uma requisição DELETE para a API do Discord.
   curl -X DELETE https://discord.com/api/webhooks/WEBHOOK_ID/WEBHOOK_TOKEN/messages/MESSAGE_ID
   Substitua WEBHOOK_ID, WEBHOOK_TOKEN e MESSAGE_ID pelos valores que você copiou. Pressione Enter para executar o comando.
4. Verifique a Exclusão
   Volte ao seu canal do Discord. A mensagem de webhook deve ter desaparecido. O Discord não envia uma confirmação; a mensagem simplesmente some. Se você receber um erro 404, o ID da mensagem pode estar incorreto ou a mensagem já foi excluída.

Erros Comuns e Problemas ao Editar ou Excluir Mensagens de Webhook

Erro “404 Not Found”

Este erro significa que a API não consegue encontrar o webhook ou a mensagem. Verifique se o ID do webhook, token do webhook e ID da mensagem estão corretos. O token do webhook diferencia maiúsculas de minúsculas. Confirme também que a mensagem foi enviada pelo mesmo webhook. Você não pode editar ou excluir mensagens enviadas por um webhook diferente ou por um usuário comum.

Erro “403 Forbidden”

Este erro significa que o webhook não tem permissão para editar ou excluir a mensagem. Certifique-se de que o webhook tenha as permissões corretas no servidor. O webhook deve ter a permissão Gerenciar Webhooks ou ser o proprietário do webhook. Apenas o webhook que criou a mensagem pode editá-la ou excluí-la.

Token do Webhook Alterado

Se você regenerar o token do webhook em Configurações do Servidor, o token antigo se torna inválido. Você deve usar o novo token em suas chamadas de API. Copie o novo token da página de configurações do webhook antes de executar comandos cURL.

Mensagem Muito Antiga

O Discord não impõe um limite de tempo para editar ou excluir mensagens de webhook. No entanto, se o webhook foi excluído do servidor, você não pode editar ou excluir suas mensagens. O webhook ainda deve existir nas integrações do servidor.

Métodos da API de Webhook do Discord: Editar vs Excluir

Item	Editar (PATCH)	Excluir (DELETE)
Método HTTP	PATCH	DELETE
Endpoint da API	/webhooks/{webhook.id}/{webhook.token}/messages/{message.id}	/webhooks/{webhook.id}/{webhook.token}/messages/{message.id}
Corpo da Requisição	JSON com campos como content, embeds, components	Nenhum corpo de requisição necessário
Resultado	O conteúdo da mensagem é atualizado no canal	A mensagem é removida permanentemente do canal
Permissões Necessárias	O webhook deve ser o proprietário da mensagem e ter permissão Gerenciar Webhooks	O webhook deve ser o proprietário da mensagem e ter permissão Gerenciar Webhooks

Editar e excluir mensagens de webhook do Discord requer o uso da API do Discord com os IDs e métodos HTTP corretos. Ative o Modo Desenvolvedor nas Configurações do Usuário para copiar IDs de mensagens facilmente. Use cURL ou qualquer cliente HTTP para enviar requisições PATCH para edições e requisições DELETE para remoções. Sempre verifique se o token do webhook está atualizado e se o webhook ainda existe no servidor. Se precisar atualizar várias mensagens de webhook, considere escrever um script que percorra os IDs das mensagens e aplique a mesma edição.