Você já deve ter visto "webhook" nas configurações de algum aplicativo e pensado se você deveria usá-los. A resposta, em resumo, é provavelmente sim.
Webhooks são uma forma de os aplicativos enviarem mensagens ou informações automáticas para outros aplicativos. É assim que o PayPal informa seu aplicativo de contabilidade quando seus clientes pagam você, como o Twilio encaminha chamadas telefônicas para o seu número e como o WooCommerce pode notificar você sobre novos pedidos no Slack.
São uma maneira simples de suas contas online "conversarem" entre si e serem notificadas automaticamente quando algo novo acontece. Em muitos casos, você terá que saber como usar webhooks se quiser transferir dados automaticamente de um aplicativo para outro.
Vamos descomplicar, aprender a falar a linguagem dos webhooks e fazer com que seus aplicativos favoritos conversem entre si usando os webhooks do Zapier.
Veja a seguir o que vamos abordar:
O que são webhooks?
Webhooks são mensagens automáticas enviadas por aplicativos quando algo acontece. Eles têm uma mensagem — ou carga útil — e são enviados para um URL exclusivo — essencialmente o número de telefone ou endereço do aplicativo. Normalmente os webhooks são usados para conectar aplicativos e sistemas, possibilitando o compartilhamento de dados em tempo real.
Normalmente há duas maneiras de seus aplicativos se comunicarem entre si para compartilharem informações: varredura e webhooks. Como explicou um dos amigos do nosso campeão de clientes: a varredura é como bater na porta do seu amigo e perguntar se ele tem açúcar (também conhecido como informação), mas você precisa ir e pedir sempre que quiser. Webhooks são como alguém que joga um saco de açúcar na sua casa sempre que compra algum. Você não precisa pedir — eles simplesmente repassam automaticamente sempre que está disponível.
Os webhooks são quase sempre mais rápidos do que a varredura e exigem menos trabalho de sua parte. Funcionam de forma muito parecida com as notificações por SMS. Digamos que seu banco envie um SMS quando você fizer uma nova compra. Você já tinha informado seu número de telefone ao banco, então eles sabiam para onde enviariam a mensagem. Eles digitam "Você acabou de gastar US$ 10 na NewStore" e enviam para o seu número de telefone +1-234-567-8900. Algo aconteceu no seu banco, e você recebe uma mensagem sobre isso. Está tudo certo.
Os webhooks funcionam da mesma forma.
→ Tudo pronto para começar a usar webhooks? Siga em frente para pular os detalhes técnicos ou continue lendo para saber mais sobre os termos que costumam acompanhar os webhooks.
Como funcionam os webhooks?
Webhooks são dados e comandos executáveis enviados de um aplicativo para outro via HTTP, em vez de pela linha de comando no seu computador, formatados em XML, JSON ou serialização codificada por formulário. São conhecidos como webhooks porque são ganchos de software — ou funções que rodam quando algo acontece — que funcionam pela web. Geralmente são protegidos pela obscuridade — cada usuário de aplicativo recebe um URL exclusivo e aleatório para enviar dados de webhook — embora possam, opcionalmente, ser protegidos com uma chave ou assinatura.
Normalmente, você usaria um webhook para conectar dois aplicativos diferentes. Quando um evento acontece no aplicativo disparador, ele serializa dados sobre esse evento e os envia para uma URL de webhook do aplicativo de ação — aquele que deve executar algo com base nos dados recebidos do primeiro aplicativo. O aplicativo de ação pode então enviar uma mensagem de retorno (callback), geralmente com um código de status HTTP como 302 para informar ao aplicativo disparador que os dados foram recebidos com sucesso ou 404 se não foram.
Webhooks são semelhantes a APIs, mas mais simples. Uma API é uma linguagem completa para um aplicativo com funções ou chamadas para adicionar, editar e recuperar dados. A diferença é que, com uma API, você precisa fazer o trabalho por conta própria. Se você desenvolver um aplicativo que se conecta a outro por meio de uma API, seu aplicativo precisará de maneiras de solicitar novos dados ao outro aplicativo quando necessário. Os webhooks, por outro lado, são destinados a uma parte específica de um aplicativo e são automáticos. Você pode ter um webhook somente para novos contatos — e sempre que um novo contato for adicionado, o aplicativo enviará os dados automaticamente para o URL do webhook do outro aplicativo. É uma conexão simples, direta, que funciona automaticamente.
Exemplo de webhook
Agora que você sabe o que isso é, vamos detalhar um exemplo de um webhook e como ele funciona.
Bob acessa o site da sua loja, adiciona US$ 10 de papel ao carrinho de compras e finaliza a compra. Pronto — algo aconteceu, e o aplicativo precisa avisar você. Está na hora do webhook.
Espere: quem o aplicativo vai chamar? Assim como você precisa informar ao banco seu número de telefone para ele poder enviar mensagens de texto, com os webhooks você precisa informar ao aplicativo de origem — sua loja de comércio eletrônico, neste caso — o URL do webhook do aplicativo receptor, o aplicativo para o qual você deseja que os dados sejam enviados.
Digamos que você queira fazer uma fatura para esse novo pedido. O aplicativo que cria esta fatura está no lado receptor — é o aplicativo que precisa dos dados do pedido.
Primeiro, você abriria seu aplicativo de fatura, criaria um modelo de fatura e copiaria o URL do webhook — algo como seuapp.com/data/12345. Em seguida, abriria seu aplicativo de comércio eletrônico e adicionaria esse URL às configurações do webhook. Esse URL é, essencialmente, o número de telefone do seu aplicativo de faturas. Se outro aplicativo enviar um ping para esse URL (ou se você digitar o URL na barra de endereços do seu navegador), o aplicativo perceberá que alguém está tentando enviar dados para ele.
De volta ao pedido. Sua loja de comércio eletrônico recebeu o pedido e sabe que precisa enviar os detalhes para seuapp.com/data/12345. Em seguida, grava o pedido em um formato de serialização. O formato mais simples é chamado de “formulário codificado” e significa que o pedido do seu cliente ficaria parecido com:
Cliente=bob&valor=10,00&item=papel
Agora sua loja de comércio eletrônico precisa enviar a mensagem. A maneira mais simples de enviar dados para um URL de webhook é com uma solicitação HTTP GET. Literalmente, isso significa adicionar os dados ao URL e fazer ping no URL (ou digitá-lo na barra de endereços do seu navegador). Da mesma forma que você pode abrir a página 'Sobre' do Zapier digitando /about após zapier.com, Seus aplicativos podem enviar mensagens entre si adicionando um texto extra com um ponto de interrogação no final de um endereço de site. Aqui está a solicitação GET completa do nosso pedido:
https://seuapp.com/data/12345?Customer=bob&value=10.00&item=paper
Dentro do seu aplicativo de faturamento, algo emite um alerta e diz: "Você tem uma nova mensagem!", e o aplicativo começa a trabalhar, criando uma nova fatura para o pedido de papel de US$ 10 do Bob. É assim que um webhook funciona.
Lembra quando você precisava verificar seu e-mail para ver se havia novas mensagens — e como foi libertador quando surgiu o push e-mail (“Você tem e-mails!”)? É exatamente isso que os webhooks fazem pelos seus aplicativos. Eles não precisam mais verificar se há novas informações. Em vez disso, quando algo acontece, podem enviar os dados uns aos outros sem perder tempo checando e esperando.
Como usar webhooks
Você conhece o jargão, entende como os aplicativos podem se comunicar entre si com webhooks e consegue até interpretar o significado dos dados serializados. Você fala webhook.
Chegou a hora de usar. A melhor maneira de saber se você conhece o funcionamento dos webhooks é testar, tentar criar seus próprios webhooks e verificar se funcionam. Ou você pode pular etapas e simplesmente inserir o URL do seu webhook em um aplicativo para compartilhar dados. Afinal, você não precisa saber como criar webhooks para usá-los.
Etapa 1: testar webhooks com RequestBin e Postman
O segredo para aprender rápido é colocar a mão na massa, mas o ideal é começar num lugar onde errar não traga prejuízos. Com webhooks, há duas ótimas ferramentas para tal: RequestBin (pertencente à Pipedream) e Postman.
O RequestBin permite que você crie um URL de webhook e envie dados para ele para ver como é reconhecido. Vá para RequestBin, clique em Criar um RequestBin, depois copie o URL que ele apresenta. Você terá que ter uma conta Pipedream (criada com Google ou GitHub) para poder ver e usar um URL.
Agora serialize alguns dados no estilo codificado de formulário ou copie nosso exemplo de formulário acima. Abra outra aba, cole o URL do RequestBin na barra de URL, adicione um ? no fim e, em seguida, cole os seus dados serializados. O resultado será algo assim:
https://requestbin.com/19uynve1?customer=bob&value=10,00&item=paper
Pressione enter na barra de endereços do seu navegador e você verá uma mensagem simples: sucesso:true. Atualize a aba RequestBin e você verá os dados listados na parte inferior, como na captura de tela acima.
Em seguida, você pode tentar enviar solicitações POST no Terminal ou do código do seu próprio aplicativo, se quiser, usando o código de exemplo do RequestBin. Isso é um pouco mais complexo, mas também oferece uma maneira de brincar com o código em JSON ou XML.
Ou use outro aplicativo para isso.
O aplicativo Postman permite que você faça requisições HTTP personalizadas para enviar dados personalizados para o URL de um webhook. Insira o URL, depois escolha o método de requisição HTTP que você quer usar (GET, POST, PUT, etc.) e adicione os dados do corpo.
Isso vai permitir que você envie solicitações muito mais detalhadas para o URL do webhook sem precisar usar mais código.
Etapa 2: Adicione webhooks aos seus aplicativos
Testar webhooks e serializar dados manualmente é complicado, assim como copiar e colar dados dos seus aplicativos. Vamos pular ambos e apenas fazer com que nossos aplicativos conversem entre si.
Estamos usando a ferramenta de formulário do WordPress Gravity Forms e o aplicativo de criação de modelos de documentos Formstack como exemplos aqui — mas a mesma ideia geral funciona na maioria dos outros aplicativos compatíveis com webhooks. Veja basicamente o que você precisa a fazer:
Primeiro, ative os webhooks no seu aplicativo, se ainda não estiverem ativos, e abra as configurações de webhooks (no Gravity Forms, por exemplo, você precisa instalar um complemento; no Active Campaign, você encontrará webhooks nas configurações do desenvolvedor e no WooCommerce você os encontrará nas configurações avançadas do aplicativo). Seu aplicativo pode ter um conjunto de configurações de webhook para todo o aplicativo — ou, como ocorre frequentemente, haverá um webhook específico para cada formulário, documento ou outros itens que o aplicativo mantém.
Queremos que os dados venham do Gravity Forms, então vamos abrir as configurações de webhooks no formulário que queremos usar. Isso nos dá um campo URL (o que nos permite indicar ao Gravity Forms para onde queremos enviar os dados) e opções para definir o método de requisição HTTP do webhook (como enviar os dados).
Agora vamos obter esse URL do aplicativo que receberá os dados — o Formstack Documents, neste caso. No Formstack, cada documento tem seu próprio "merge URL" e quer que os dados sejam serializados em formulário codificado, como você pode perceber pelos "e-comerciais" (&) nos dados de exemplo. Copie o URL de mesclagem ou qualquer URL que seu aplicativo ofereça, pois pode ter outro nome.
Dica: geralmente você encontrará URLs de webhook e configurações relacionadas nas seções "integração", "webhook" ou "fluxo de trabalho", dependendo do seu aplicativo.
Finalmente, volte para o seu aplicativo acionador — o Gravity Forms, no nosso caso — e cole o URL do webhook no campo URL do Gravity Forms. Você também pode definir o método correto de solicitação e os valores específicos dos campos para garantir que somente os dados que você deseja sejam enviados e compartilhados com os mesmos nomes de variáveis que o aplicativo receptor utiliza. Salve as configurações e pronto.
Na próxima vez que alguém preencher nosso formulário e Bob pedir 10,00 de papel, o Gravity Forms enviará os dados para o URL do Formstack como https://www.webmerge.me/merge/149933/gxszxg?Name=Bob&Item=Paper&Value=10,00 e o Formstack transformará isso em uma fatura completa.
Assim que você começar a usar webhooks, vai percebê-los (ou links semelhantes) em todos os lugares, em locais onde você nunca imaginou que apareceriam. O PayPal, por exemplo, usa Notificações Instantâneas de Pagamento ou IPNs para enviar notificações sempre que você recebe um pagamento. Você tem um aplicativo que gostaria que fizesse algo sempre que recebesse um pagamento do PayPal? Adicione o URL do webhook em configurações de IPN do PayPal e o aplicativo receberá uma mensagem na próxima vez que você receber dinheiro.
Ou experimente os Twimlets, aplicativos simples da Twilio para encaminhar chamadas, gravar mensagens de correio de voz, iniciar uma teleconferência e outros. Para, digamos, encaminhar uma chamada, você vai adicionar um endereço Twimlet familiar, no estilo webhook, como http://twimlets.com/forward?PhoneNumber=415-555-1212 às configurações do seu número de telefone Twilio. Quer criar seu próprio aplicativo ativado por telefone ou notificar outro aplicativo quando chegar uma nova chamada? Insira o URL do seu webhook nas configurações do Twilio.
Eles podem ter nomes diferentes, mas quando você percebe lugares onde os aplicativos oferecem o envio de notificações para um link exclusivo, você geralmente encontra outro lugar onde webhooks podem funcionar. Agora que você sabe como usar webhooks, pode usá-los para fazer o software fazer o que quiser.
Como usar webhooks em qualquer aplicativo com o Zapier
Muitos aplicativos no Zapier já utilizam webhooks nos bastidores. Você pode não perceber, já que os aplicativos Zapier geralmente lidam com toda a configuração real para você. Se você encontrar um aplicativo que ofereça webhooks como opção, pode usar uma etapa de webhook em um Zap para configurá-la por conta própria usando o que aprendeu sobre webhooks.
Observação: Webhooks by Zapier é uma ferramenta incorporada disponível somente para usuários do Zapier com um plano pago ou durante o período de avaliação gratuita.
Digamos que você tenha um aplicativo capaz de enviar dados para um URL de webhook. Para conectá-lo a outros aplicativos, você criará um novo Zap, que chamamos de fluxos de trabalho automáticos do Zapier, e escolherá Webhooks by Zapier como aplicativo acionador. Selecione Catch Hook, que pode receber uma solicitar GET, POST ou PUT de outro aplicativo. O Zapier entregará um URL de webhook exclusivo. Copie-o e adicione-o ao campo URL de webhook nas configurações do seu aplicativo.
As solicitações GET solicitam dados ao servidor. As solicitações POST enviam dados para um computador. As solicitações PUSH solicitam ao servidor dados específicos, geralmente para atualizá-los.
Depois faça seu aplicativo testar o URL ou, talvez, apenas adicione um novo item (uma nova entrada de formulário, contato ou qualquer outra coisa que seu aplicativo crie) para seu aplicativo enviar os dados para o webhook. Teste a etapa do webhook no Zapier e você verá os dados do webhook listados no Zapier.
Agora você pode usar esses dados em outro aplicativo. Selecione o aplicativo de ação, o aplicativo para o qual você quer enviar dados. Você verá campos de formulário para adicionar dados a esse aplicativo. Clique no campo onde você quer adicionar dados de webhook e selecione-os no menu suspenso. Teste seu Zap e ele agora está pronto para uso. Agora, da próxima vez que o seu aplicativo acionador enviar dados para o webhook, o Zapier adicionará automaticamente esses dados ao aplicativo de ação que você escolheu.
O inverso também funciona. Quer enviar dados de um aplicativo para outro via webhooks? O Zapier pode transformar os dados do aplicativo acionador em uma lista serializada e enviá-los para qualquer URL de webhook que você quiser.
Primeiro, selecione o aplicativo acionador de onde você quer enviar dados e configure-o no Zapier normalmente. Em seguida, selecione webhooks como aplicativo de ação e escolha como você quer enviar os dados (POST é geralmente a melhor opção para a maioria das integrações de webhooks).
Finalmente, cole o URL do webhook do aplicativo do qual você deseja receber os dados no campo URL nas configurações de webhook do Zapier. Você pode escolher como serializar os dados (formulário ou JSON são geralmente as melhores opções). O Zapier enviará automaticamente todos os dados do seu aplicativo acionador para o webhook, ou você pode definir as variáveis de dados específicas nos campos dados abaixo.
Agora você está pronto para usar o seu Zap. Agora, sempre que algo novo acontecer no seu aplicativo acionador, o Zapier copiará os dados e os enviará para o URL do webhook do seu outro aplicativo.
Precisa de mais ajuda? Leia nossa documentação de webhooks para ver instruções, etapa por etapa, sobre como usar webhooks nos seus Zaps.
Os Webhooks são uma das melhores maneiras de conectar aplicativos que, de outra forma, não funcionariam com o Zapier. Você tem um aplicativo para Mac ou iPhone que não se conecta ao Zapier? Usando os atalhos Alfred ou Siri — além de um URL de webhook do Zapier — você pode conectá-los aos seus fluxos de trabalho Zapier. Veja como:
Adicione Zapier aos Atalhos da Siri em qualquer iPhone ou iPad com iOS 12 ou mais recente
Execute Zaps a partir da ferramenta de busca do seu Mac com nosso fluxo de trabalho Zapier Alfred baseados em webhooks
Ou automatize qualquer outro aplicativo que use webhooks com integrações de webhook do Zapier ou use um desses modelos populares de Zap para começar rápido:
Adicione informações a uma Planilha Google a partir de novas solicitações POST do webhook
Publique novos anúncios de leads do Facebook em um webhook
Saiba mais: Como enviar um e-mail a partir de um webhook.
Está na hora de começar a usar webhooks
Você consegue. Armado com seus novos conhecimentos sobre webhooks e sua terminologia confusa, você está pronto para começar a usá-los em seu trabalho. Explore as configurações avançadas dos seus aplicativos web favoritos e veja se algum deles é compatível com webhooks. Pense em como você pode usá-los para apoiar seu negócio—e dê uma chance.
Tudo pronto para experimentar por conta própria? Experimente os webhooks e comece a impulsionar o seu negócio.
Leitura relacionada:
Este artigo foi publicado originalmente em março de 2018, com atualizações anteriores de Katie Redderson-Lear, Will Harris e Elena Alston. Foi atualizado mais recentemente em julho de 2025 por Steph Spector.
