O que é um webhook?
Escrito por Shray Jain
Webhooks permitem que desenvolvedores facilitem a comunicação em tempo real entre duas aplicações de forma automatizada. Em contraste com o polling contínuo de servidores em busca de informações, webhooks são rápidos, fáceis de configurar, e frequentemente são vistos como uma alternativa leve à construção de um serviço de API completo.
Usando a Alchemy Notify API, desenvolvedores podem enviar notificações em tempo real aos usuários para eventos críticos como atividade de endereço, transações mineradas, e outros casos de uso.
Por exemplo, construir uma aplicação descentralizada com notificações de transação em tempo real se torna possível e mais simples usando webhooks. Implementar webhooks melhora significativamente a experiência do usuário final e elimina a necessidade de construir um sistema de notificação demorado e complexo do zero.
Este artigo detalha o que é um webhook, como funciona, seus diversos casos de uso de notificação web3, e como começar a usar Web3 webhooks.
O que é um webhook?
Um webhook é um meio automatizado pelo qual uma aplicação pode enviar dados em tempo real para outra. Webhooks só facilitam comunicação unidirecional entre dois serviços, são mais rápidos que endpoints de polling, e exigem menos esforço de desenvolvimento.
O que é uma URL de webhook?
Uma URL de webhook é o endereço da aplicação onde os dados são recebidos da aplicação remetente. Tipicamente, webhooks são usados para conectar duas aplicações distintas, onde uma é a "remetente" e a outra é a "assinante" das informações de eventos. Quando um evento ocorre na aplicação remetente, ela envia esses dados para a URL de webhook da aplicação assinante.
O que é um endpoint de webhook?
Um endpoint de webhook é a URL de webhook que foi configurada para a aplicação remetente fornecer dados à aplicação assinante. Para que a aplicação remetente forneça dados à aplicação assinante, ela precisa de uma URL de webhook para entregar as informações solicitadas.
Na prática, uma URL de webhook é o endpoint e precisa ser pública para o fluxo contínuo de informações entre as aplicações. Uma vez que uma requisição foi disparada e os dados foram processados, a aplicação assinante pode então enviar uma mensagem de callback, com um código de status HTTPS, para informar o recebimento dos dados.
O que é uma API de webhook?
Em contraste com o polling contínuo de um endpoint para determinar se uma mudança de estado ocorreu, webhooks fornecem informações assim que elas se tornam disponíveis. Em outras palavras, webhooks podem ser considerados "APIs reversas" porque a comunicação é iniciada pelo programa que fornece os dados, em vez daquele que os solicita.
Assim como uma API convencional, informação e funcionalidade são compartilhadas entre duas interfaces de software. Devido à eficiência e ao benefício tangível de empregar webhooks, desenvolvedores veem esse meio como uma solução prática e leve para atualizações de dados em tempo real e notificações web3.
O que é uma integração de webhook?
Uma integração de webhook permite que desenvolvedores automatizem mensagens entre uma aplicação e outra usando uma URL única. Por exemplo, desenvolvedores podem utilizar o Zapier, uma ferramenta de software que permite automação de tarefas repetitivas entre duas ou mais aplicações sem precisar codificar novas funcionalidades. Sem o Zapier, os usuários não seriam notificados e a resposta seria apenas mais uma resposta, tipicamente um objeto JSON.
Por outro lado, integrar o Zapier com Alchemy webhooks pode levar ao compartilhamento de dados Web3 em uma ampla variedade de aplicações de terceiros como Discord, Twitter e Slack. Assim, quando um evento on-chain acontece (por exemplo, nova atividade ocorre em uma carteira monitorada), o Zapier pode enviar uma mensagem para um canal dedicado do Slack, servidor do Discord, ou conta do Twitter. Na prática, um serviço como o Zapier melhora o ciclo de comunicação e cria um produto mais útil tanto para desenvolvedores quanto para usuários.
Integrar o Zapier com Alchemy webhooks é relativamente simples e direto. De fato, desenvolvedores não precisam de uma quantidade excessiva de ferramentas para realizar a integração, apenas uma conta Alchemy e uma conta Zapier.
O que os webhooks fazem?
Webhooks permitem que aplicações compartilhem dados em tempo real com outras aplicações, ampliando a funcionalidade. Para ajudar a acelerar o desenvolvimento de aplicações Web3, a Notify API da Alchemy—baseada em webhooks—ajuda usuários a monitorar atividade de endereço, transações mineradas, e mais nas redes blockchain Ethereum, Polygon, Optimism, e Arbitrum.
Desenvolvedores podem construir funcionalidades para quatro tipos de notificações usando o Alchemy Notify:
- O webhook de transação minerada pode ser usado para notificar sua aplicação sempre que uma transação enviada através de sua API key é minerada com sucesso. Essa notificação pode ser útil para informar os clientes no momento em que sua transação foi executada.
- Um webhook de transações descartadas é usado para notificar sua aplicação sempre que uma transação enviada através de sua API key é descartada.
- Um webhook também pode ser usado para rastrear todos os eventos de transferência de ETH, ERC20, e ERC721 para quantos endereços Ethereum um desenvolvedor desejar.
Webhooks podem ser usados para múltiplos propósitos, notificando usuários sobre nova atividade ou atualizações de dApps.
Veja o dashboard da Alchemy em ação
Tour guiado de 30 minutos: todas as ferramentas do dashboard, demonstradas ao vivo.
Watch the demoexemplos de webhook
Como a blockchain Ethereum não suporta notificações de forma nativa, não há como um usuário de dApp se manter atualizado sobre o status das transações sem precisar atualizar constantemente sua aplicação ou verificar o etherscan. No geral, é um processo demorado que desestimula os usuários a reutilizarem a aplicação novamente.
Agora, usando o Alchemy Notify e o WebSocket de transações pendentes da Alchemy, usuários podem rastrear transações ETH mineradas e pendentes de forma contínua.
O resultado do passo a passo mencionado acima permite que desenvolvedores enviem notificações por SMS para qualquer atividade ao longo do ciclo de vida da transação para seus usuários. Isso leva a uma experiência de usuário superior que pode oferecer uma vantagem no mercado competitivo de hoje.
Por que desenvolvedores Web3 devem usar webhooks?
Aplicações descentralizadas se tornaram arquiteturalmente mais complexas à medida que redes blockchain como a Ethereum ganharam popularidade generalizada. No entanto, a experiência do usuário final no ecossistema Web3 ainda fica atrás da experiência do Web2.
Uma peça faltante na infraestrutura de UX do Web3 são as notificações em tempo real. Por exemplo, usuários finais querem saber quando suas negociações são executadas, quando transações falham, e quando seu lance em um leilão foi aceito, entre outras necessidades.
Desenvolvedores precisam saber que suporte inadequado para webhooks pode levar os usuários de seus dApps a abandonarem completamente o serviço pelos motivos anteriores, além da ansiedade em relação a transações e confirmações atrasadas.
Em geral, configurar notificações em tempo real em aplicações tem sido um ponto de dor para desenvolvedores devido à complexidade, tempo, e erros inevitáveis de construir sistemas do zero.
Como funcionam os webhooks?
Desenvolvedores podem considerar notificações de webhook como semelhantes a notificações por SMS. O usuário final que pretende enviar uma mensagem tem seu número de telefone registrado, que atua como o endereço para entregar informações. Ao responder posteriormente à mensagem confirmando que você a recebeu, você consegue então criar um sistema de comunicação bidirecional.
Como chamar um webhook
Chamar um webhook requer algumas entradas do desenvolvedor através de um processo de três etapas:
-
Desenvolvedores identificam o endpoint ou URL de webhook da aplicação que deve receber os dados
-
A URL de webhook precisa ser incorporada à aplicação que envia os dados para que o payload e as variáveis de query possam ser processados sem encontrar problemas.
-
Especificar as regras do webhook que, em última instância, disparará uma notificação de tipo de evento para o usuário final.
Hoje, desenvolvedores podem configurar webhooks a partir do dashboard da Alchemy ou de forma programática. Para praticar a chamada de um webhook no contexto de um tutorial Web3, aprenda como construir um bot de alerta de baleia no Telegram.
Quanto tempo leva para um webhook funcionar?
Garantir que um webhook esteja funcionando leva pouco tempo. De fato, desenvolvedores podem consultar este tutorial sobre como configurar um servidor de webhook, que mostra três passos simples para configurar um servidor de webhook do Alchemy Notify usando uma configuração node-express ou uma configuração de servidor de webhook construída com python-django.
No geral, instalar, executar, e testar localmente o servidor de webhook exige pouco esforço e apenas alguns comandos.
Comece a usar webhooks em suas aplicações Web3
Com suporte a Webhook para Ethereum, Optimism, Arbitrum, e Polygon, desenvolvedores web3 devem avaliar os casos de uso do Alchemy Notify para melhorar a experiência do usuário de suas aplicações descentralizadas.
Com mais desenvolvedores e concorrência no espaço web3, o design de experiência do usuário é uma área importante onde aplicações voltadas ao consumidor, como carteiras, podem se diferenciar de seus concorrentes.
Visões gerais relacionadas
Técnico19 de maio de 2026
Webhooks vs. WebSockets vs. gRPC
Três protocolos dominam a entrega de dados em tempo real. Veja como webhooks, WebSockets e gRPC se diferenciam, quando cada um falha e como escolher entre eles.
Técnico20 de junho de 2022
O que é um WebSocket e como ele funciona
O que são e como funcionam no Web3
Carteiras2 de setembro de 2026
Agent wallets: o modelo de sessão e permissões para agentes de IA
Como agentes de IA obtêm acesso a wallets com escopo definido e revogável, sem manter chaves privadas: sessions, delegated signing e revogação instantânea.

Construa magia blockchain
A Alchemy combina os produtos e ferramentas de desenvolvimento Web3 mais poderosos com recursos, comunidade e suporte lendário.