Você quer receber uma notificação no seu servidor do Discord toda vez que alguém enviar um formulário no seu site. Webhooks do Discord permitem enviar mensagens automaticamente de aplicativos externos sem usar um bot. Este artigo explica como criar um webhook do Discord, configurar sua ferramenta de formulário e testar a integração. Ao final, você terá um sistema funcional que publica os dados dos formulários diretamente no seu canal do Discord.
Principais Pontos: Configuração de Webhook do Discord para Notificações de Formulários
- Configurações do Servidor > Integrações > Webhooks: Crie um novo webhook e copie a URL do seu servidor Discord.
- Campo de webhook da ferramenta de formulário (ex.: Typeform, Google Forms, Zapier): Cole a URL do webhook para enviar dados quando um formulário for enviado.
- Estrutura do payload JSON: Personalize o conteúdo da mensagem, campos de embed e nome de usuário enviados ao seu canal do Discord.
O que é um Webhook do Discord e Como Funciona com Formulários
Um webhook do Discord é um endpoint HTTP simples que aceita dados JSON e os publica como uma mensagem em um canal específico. Você não precisa executar um bot ou escrever código complexo para usá-lo. Quando um formulário é enviado, sua plataforma de formulários ou ferramenta de automação envia uma requisição POST para a URL do webhook. O Discord então exibe os dados como uma mensagem formatada, incluindo texto, embeds e anexos de arquivos.
A URL do webhook contém um token único que identifica seu servidor e canal. Qualquer pessoa com essa URL pode enviar mensagens para aquele canal, então mantenha-a privada. A maioria dos construtores de formulários como Typeform, Google Forms e JotForm possui uma opção de webhook nas configurações. Para ferramentas que não suportam webhooks diretamente, você pode usar serviços de automação como Zapier ou Make para fazer a ponte.
Pré-requisitos para Usar Webhooks do Discord com Formulários
Antes de começar, você precisa destas três coisas:
- Um servidor Discord onde você tenha a permissão Gerenciar Webhooks. Isso está disponível para proprietários de servidores e usuários com a permissão Gerenciar Servidor.
- Uma ferramenta de formulário que suporte integração com webhook ou que possa se conectar através de Zapier, Make ou um script personalizado.
- A URL do webhook do seu canal Discord. Você copiará essa URL e a colará na sua ferramenta de formulário.
Passos para Criar um Webhook do Discord e Conectá-lo a um Formulário
Siga estes passos para configurar um webhook e vinculá-lo ao seu sistema de envio de formulários.
- Abra as Configurações do Servidor
No Discord, vá para o seu servidor e clique no nome do servidor no canto superior esquerdo. Selecione Configurações do Servidor no menu suspenso. - Navegue até Integrações
Na barra lateral esquerda, clique em Integrações. Esta página mostra todos os bots, webhooks e conexões de aplicativos do seu servidor. - Crie um Novo Webhook
Clique no botão Criar Webhook. Um formulário aparece onde você pode nomear o webhook e escolher o canal de destino. Selecione o canal onde deseja que os envios de formulários apareçam. - Copie a URL do Webhook
Após criar o webhook, clique em Copiar URL do Webhook. Salve esta URL em um arquivo de texto seguro. Você precisará dela no próximo passo. - Abra as Configurações da Sua Ferramenta de Formulário
Vá para o seu construtor de formulários ou serviço de automação. Por exemplo, no Typeform, abra seu formulário e clique em Conectar e depois em Webhook. No Zapier, crie um novo Zap com o gatilho definido para seu formulário e a ação para webhook do Discord. - Cole a URL do Webhook
Na ferramenta de formulário, cole a URL do webhook do Discord no campo designado. Se a ferramenta pedir um endpoint de URL, é para onde os dados serão enviados. - Teste a Conexão
Envie uma entrada de teste no seu formulário. Volte para o Discord e verifique o canal selecionado. Você deve ver uma nova mensagem com os dados do formulário. Se nenhuma mensagem aparecer, verifique a URL do webhook e as configurações da ferramenta de formulário.
Personalizando o Formato da Mensagem do Webhook
Por padrão, a mensagem do webhook mostra os dados JSON brutos. Para torná-la legível, você pode enviar um payload JSON formatado com um embed. Aqui está um exemplo de estrutura de payload:
{
"content": "Novo envio de formulário recebido",
"embeds": [{
"title": "Formulário de Contato",
"fields": [
{
"name": "Nome",
"value": "{{form_name}}",
"inline": true
},
{
"name": "Email",
"value": "{{form_email}}",
"inline": true
}
],
"color": 5814783
}]
}Substitua {{form_name}} e {{form_email}} pelos placeholders reais dos campos da sua ferramenta de formulário. O valor color é um número decimal que representa a cor da barra do embed. Você também pode definir um nome de usuário e avatar personalizados adicionando "username": "Form Bot" e "avatar_url": "https://exemplo.com/avatar.png" no topo do payload.
Se o Webhook do Discord Não Enviar Notificações de Formulário
Nenhuma mensagem aparece no canal após o envio do formulário
Isso geralmente acontece quando a URL do webhook está incorreta ou a ferramenta de formulário não enviou a requisição. Verifique novamente a URL que você copiou do Discord. Na ferramenta de formulário, procure um botão de teste ou envio que acione uma requisição manual. Confirme também que o webhook está ativado no Discord. Vá em Configurações do Servidor > Integrações, encontre seu webhook e verifique se o canal está definido corretamente.
O webhook envia uma mensagem, mas mostra JSON bruto
A ferramenta de formulário enviou os dados como texto simples em vez de um embed estruturado. Use um serviço de automação como Zapier para transformar os dados em um payload JSON com um objeto embed. No Zapier, você pode usar a etapa de Código para formatar o payload antes de enviá-lo ao Discord. Alternativamente, alguns construtores de formulários permitem editar o formato do payload do webhook nas configurações avançadas.
O webhook funciona, mas a mensagem demora a aparecer
Webhooks do Discord entregam mensagens em tempo real. Se você notar um atraso, o problema provavelmente está no lado da ferramenta de formulário. Verifique o tempo de processamento da ferramenta ou configurações de fila. Por exemplo, Google Forms com integração Zapier pode ter alguns segundos de atraso devido a intervalos de polling. Use uma ferramenta que dispare instantaneamente, como Typeform ou um script personalizado, para reduzir a latência.
Webhook do Discord vs Bot: Escolhendo a Ferramenta Certa para Notificações de Formulários
| Item | Webhook | Bot |
|---|---|---|
| Tempo de configuração | Menos de 5 minutos | 30 minutos a 1 hora |
| Requisitos de permissão | Gerenciar Webhooks no servidor | Gerenciar Servidor e escopos OAuth2 |
| Personalização | Limitada ao payload JSON | Controle total via código |
| Limites de taxa | 30 requisições por 60 segundos por webhook | Varia conforme configuração do bot |
| Melhor caso de uso | Notificações simples de aplicativos externos | Fluxos de trabalho complexos com interações do usuário |
Agora você pode receber notificações do Discord para cada envio de formulário usando um webhook. Comece criando o webhook no seu servidor e configurando sua ferramenta de formulário para enviar dados para a URL. Para formatação avançada, use um payload JSON com embeds para exibir os campos de forma limpa. Se precisar acionar ações como atribuir cargos ou enviar mensagens de acompanhamento, considere construir um bot dedicado com a API do Discord.