Você quer que o Discord envie um alerta sempre que um novo lead chegar do seu CRM ou um pagamento for recebido na sua loja. Um webhook é uma URL simples que aceita dados de outro aplicativo e os publica em um canal do Discord. O Zapier pode enviar dados para essa URL automaticamente quando um evento de gatilho acontece. Este artigo explica como criar um webhook do Discord, configurar um zap no Zapier e mapear os campos de dados corretamente para que a notificação chegue no formato certo.
Principais Conclusões: Integração de Webhook do Discord com Zapier
- Configurações do Servidor > Integrações > Webhooks: Crie uma URL única para onde o Zapier enviará os dados
- Aplicativo Webhooks by Zapier > ação POST: Envie um payload JSON para a URL do webhook do Discord
- Personalize o conteúdo da mensagem e embeds: Use campos do Zapier para inserir dados dinâmicos como nome, e-mail ou valor
Como os Webhooks do Discord Funcionam com o Zapier
Um webhook do Discord é uma URL especial que pertence a um canal de texto específico. Quando um serviço externo envia uma requisição POST para essa URL, o Discord publica uma mensagem no canal. A mensagem pode incluir texto, conteúdo rico incorporado e até anexos de arquivos.
O Zapier conecta mais de 5.000 aplicativos. Quando um evento de gatilho ocorre em um aplicativo, o Zapier pode executar uma ação em outro aplicativo. A ação para o Discord é uma requisição POST para a URL do webhook. Você não precisa de um bot do Discord ou chave de API para essa integração. Você só precisa da URL do webhook do Discord e de uma conta no Zapier com um plano pago ou gratuito que inclua o Webhooks by Zapier.
Antes de começar, decida qual aplicativo será o gatilho. Gatilhos comuns incluem novas linhas no Google Sheets, novos pagamentos no Stripe, novos leads no HubSpot ou novos pedidos no Shopify. O zap enviará uma notificação cada vez que o gatilho for acionado.
Passos para Configurar um Webhook do Discord no Zapier
Siga estes passos exatamente. Cada passo pressupõe que você já está logado no Discord e no Zapier em abas separadas do navegador.
- Crie uma URL de webhook do Discord
Abra o Discord e vá até o servidor que contém o canal de destino. Clique no nome do servidor no canto superior esquerdo e selecione Configurações do Servidor. Na barra lateral esquerda, clique em Integrações e depois em Webhooks. Clique em Criar Webhook. Dê um nome, escolha o canal onde as notificações aparecerão e clique em Copiar URL do Webhook. Armazene essa URL em um arquivo de texto temporariamente. - Crie um novo Zap no Zapier
Faça login no Zapier e clique em Criar Zap no canto superior esquerdo. Dê ao seu zap um nome descritivo, como “Novo Pagamento Stripe para Alerta no Discord”. - Configure o aplicativo e evento de gatilho
Clique na seção de gatilho e pesquise pelo seu aplicativo de origem, por exemplo Google Sheets ou Stripe. Selecione o evento de gatilho, como Nova Linha na Planilha ou Novo Pagamento. Siga os passos para conectar sua conta e selecionar a planilha, pasta de trabalho ou fonte de dados específica. Teste o gatilho para confirmar que o Zapier recebe dados de exemplo. - Adicione o aplicativo de ação: Webhooks by Zapier
Clique na seção de ação e pesquise por Webhooks by Zapier. Selecione o evento POST. Isso informa ao Zapier para enviar uma requisição HTTP POST para a URL do webhook do Discord. - Configure a ação do webhook
Na configuração da ação, defina URL como a URL do webhook do Discord que você copiou. Defina Tipo de Payload como JSON. No campo Dados, insira o payload JSON. Um payload básico se parece com isso:{"content": "Novo lead: {{Nome}} da {{Empresa}}"}
Substitua{{Nome}}e{{Empresa}}pelos campos reais do seu aplicativo de gatilho. Clique no ícone de mais para inserir campos dinâmicos. Você também pode adicionar um array embeds para mensagens mais ricas. Exemplo:{"embeds": [{"title": "Novo Pagamento", "description": "Valor: {{Valor}} de {{EmailCliente}}", "color": 65280}]} - Teste a ação
Clique em Testar e Continuar. O Zapier envia um POST de teste para a URL do webhook do Discord. Verifique o canal do Discord. Você deve ver uma mensagem do webhook com os dados de exemplo. Se a mensagem aparecer, a integração funciona. - Ative o zap
Após o teste passar, clique em Publicar ou alterne o zap para Ligado. O zap agora será executado automaticamente cada vez que o evento de gatilho ocorrer.
Erros Comuns e Limitações
A Mensagem Não Aparece no Discord
A causa mais comum é uma URL de webhook incorreta. Verifique novamente se você copiou a URL completa do Discord, incluindo a string aleatória no final. Outra causa é um payload JSON mal formatado. Use um validador JSON como jsonlint.com para verificar seu payload antes de testar. Por fim, certifique-se de que o webhook não foi excluído ou renomeado no Discord.
Campos Dinâmicos Mostram Texto Bruto em Vez de Valores
Isso acontece quando você digita o nome do campo manualmente em vez de inseri-lo usando o seletor de campos do Zapier. Sempre clique no ícone de mais no campo Dados e selecione o campo na lista suspensa. Se você digitar {{Nome}} manualmente, o Zapier o trata como texto literal.
Comprimento da Mensagem Excede os Limites do Discord
Os webhooks do Discord têm um comprimento máximo de mensagem de 2000 caracteres para o campo content. Para embeds, o conteúdo total combinado de todos os embeds não pode exceder 6000 caracteres. Se o seu zap enviar dados muito longos, trunque os campos no Zapier usando uma etapa Formatador antes da ação do webhook.
Webhook Envia Múltiplas Mensagens para um Único Evento
Isso geralmente ocorre quando o zap é executado várias vezes devido a um gatilho mal configurado. Verifique as configurações do gatilho. Por exemplo, um gatilho do Google Sheets configurado como Nova Linha na Planilha pode ser acionado para cada linha se a planilha for reordenada. Use um campo de identificador único como chave de desduplicação no Zapier.
Tipos de Mensagem do Webhook do Discord: Texto Básico vs Conteúdo Rico Incorporado
| Recurso | Mensagem de Texto Básico | Conteúdo Rico Incorporado |
|---|---|---|
| Chave do payload | content |
embeds |
| Máx. de caracteres | 2000 | 6000 no total em todos os embeds |
| Suporta formatação | Markdown: negrito, itálico, blocos de código | Título, descrição, campos, autor, rodapé, cor, timestamp |
| Imagens inline | Não | Sim, via URLs de miniatura e imagem |
| Melhor caso de uso | Alertas simples com uma linha de texto | Notificações detalhadas com dados estruturados, como resumos de pedidos |
Agora você pode enviar notificações automatizadas do Discord a partir de qualquer aplicativo conectado ao Zapier usando um webhook. Comece com um payload content simples para confirmar que a conexão funciona. Depois, adicione embeds para exibir dados mais ricos, como nomes de clientes, valores e links. Como dica avançada, use a etapa Formatador do Zapier para converter datas em um formato amigável ao Discord, como DD/MM/AAAA, antes de enviá-las no campo de timestamp do embed.