Você quer enviar mensagens automatizadas de um aplicativo ou serviço externo para um canal específico do Discord. Um webhook é uma URL simples que permite que qualquer programa publique mensagens, arquivos ou embeds diretamente nesse canal, sem precisar de um bot. Este guia mostra como criar um webhook usando as configurações do canal no Discord para desktop e navegador. Você aprenderá as etapas exatas, as permissões necessárias e como evitar erros comuns.
Principais Pontos: Criando um Webhook no Discord
- Configurações do Canal > Integrações > Webhooks: O único local onde você pode criar um webhook para um canal de texto específico.
- Permissão Gerenciar Webhooks: Necessária para criar, editar ou excluir webhooks. Essa permissão é concedida por cargos do servidor.
- Copiar URL do Webhook: A URL única gerada após a criação. Mantenha-a privada — qualquer pessoa com esta URL pode postar no seu canal.
O que é um Webhook do Discord e Por Que Usar
Um webhook é um recurso integrado do Discord que fornece uma URL HTTPS única. Quando um aplicativo externo envia uma requisição POST para esta URL, o Discord publica automaticamente o payload como uma mensagem no canal de texto designado. Webhooks não exigem uma conta de bot, um token ou qualquer código rodando no seu computador. O serviço externo cuida da lógica de envio.
Casos de uso comuns incluem enviar notificações de commits do GitHub, alertas de stream na Twitch, confirmações de formulários ou alertas personalizados de ferramentas de monitoramento. Cada webhook pode ter um nome e avatar personalizados que aparecem como autor da mensagem. Você pode criar vários webhooks por canal, cada um para um serviço diferente.
Antes de começar, verifique se você tem a permissão Gerenciar Webhooks no servidor. Essa permissão é controlada pelos cargos do servidor. Se você for o proprietário ou administrador do servidor, já a possui. Se não conseguir ver a opção Integrações nas configurações do canal, peça a um administrador do servidor para conceder essa permissão.
Passos para Criar um Webhook nas Configurações do Canal
Siga estes passos no Discord para desktop ou na versão navegador. O aplicativo móvel não suporta a criação de webhooks pelas configurações do canal — use um cliente desktop ou navegador.
- Abra o canal de texto desejado
Navegue até o servidor e selecione o canal de texto onde deseja que as mensagens do webhook apareçam. Você pode usar qualquer canal de texto público ou privado. - Clique no ícone de engrenagem para abrir as Configurações do Canal
Ao lado do nome do canal, no topo da lista de mensagens, clique no ícone de engrenagem chamado Editar Canal. Isso abre o menu de configurações do canal. - Selecione Integrações na barra lateral esquerda
No menu de configurações do canal, role a barra lateral esquerda e clique em Integrações. Esta seção mostra todas as integrações ativas para este canal, incluindo webhooks. - Clique no botão Criar Webhook
Na seção Webhooks, clique no botão azul Criar Webhook. Uma nova entrada de webhook aparece com configurações padrão. - Personalize o nome e o avatar do webhook
Por padrão, o nome do webhook é definido como o nome do bot ou serviço. Clique na entrada do webhook para expandir suas configurações. Você pode alterar o campo Nome para qualquer texto — esse nome aparecerá como o autor da mensagem. Clique no ícone do avatar para enviar uma imagem personalizada (recomendado 256×256 pixels). O avatar aparece ao lado de cada mensagem publicada por este webhook. - Copie a URL do Webhook
Abaixo dos campos de nome e avatar, clique no botão Copiar URL do Webhook. A URL é uma string longa começando comhttps://discord.com/api/webhooks/. Cole esta URL no seu aplicativo ou script externo. Mantenha esta URL privada — qualquer pessoa que a possua pode enviar mensagens para o seu canal. - Salve as alterações
Após personalizar o nome e o avatar, clique no botão Salvar Alterações na parte inferior do painel de configurações do webhook. O webhook agora está ativo e pronto para receber dados.
Erros Comuns e Limitações
A URL do Webhook Não Aparece ou o Botão Copiar Está Ausente
Se você não vir o botão Copiar URL do Webhook, pode não ter a permissão Gerenciar Webhooks. Verifique as permissões do seu cargo em Configurações do Servidor > Cargos. Além disso, certifique-se de estar usando o aplicativo desktop ou um navegador — o aplicativo móvel não exibe o botão de copiar para webhooks.
Mensagens do Webhook Não Estão Aparecendo no Canal
Verifique se o serviço externo está enviando uma requisição POST formatada corretamente. Problemas comuns incluem cabeçalho Content-Type incorreto (deve ser application/json), campos obrigatórios ausentes como content, ou envio de um payload que excede o limite de 2000 caracteres do Discord para uma única mensagem. Teste primeiro com um comando curl simples:curl -X POST -H "Content-Type: application/json" -d '{"content":"Olá do webhook"}' SUA_URL_DO_WEBHOOK
Nome e Avatar do Webhook Não São Aplicados
O nome e avatar personalizados só são aplicados quando o serviço externo não os substitui no payload. Se seu aplicativo enviar os campos username ou avatar_url no corpo JSON, esses valores terão precedência sobre as configurações do canal. Para usar as configurações do canal, remova esses campos do payload do seu aplicativo.
A URL do Webhook Expirou ou Parou de Funcionar
As URLs de webhook não expiram por conta própria. Se um webhook parar de funcionar, pode ter sido excluído por alguém com permissão Gerenciar Webhooks. Verifique a página de Integrações nas configurações do canal para ver se o webhook ainda existe. Se estiver ausente, crie um novo e atualize seu serviço externo com a nova URL.
Recursos do Webhook: Nível do Canal vs. Controlado pelo Payload
| Item | Configurações do Canal (Padrão) | Substituição pelo Payload |
|---|---|---|
| Nome | Definido nas configurações do canal | Pode ser substituído pelo campo username |
| Avatar | Definido nas configurações do canal | Pode ser substituído pelo campo avatar_url |
| Conteúdo da mensagem | Não definido | Obrigatório no payload como campo content |
| Embeds | Não definido | Podem ser enviados via array embeds no payload |
| Arquivos | Não definido | Podem ser anexados via multipart/form-data |
Agora você pode criar um webhook em qualquer canal de texto do Discord usando a seção Integrações das configurações do canal. Após a criação, copie a URL e cole-a no serviço externo que deseja integrar. Para uso avançado, explore os campos de payload embeds e allowed_mentions para formatar mensagens ricas e controlar quais cargos ou usuários são notificados. Sempre mantenha as URLs dos webhooks em segredo para evitar postagens não autorizadas.