{"id":61266,"date":"2022-06-01T14:00:04","date_gmt":"2022-06-01T17:00:04","guid":{"rendered":"https:\/\/rockcontent.com\/br\/?p=61266"},"modified":"2025-09-18T18:12:17","modified_gmt":"2025-09-18T21:12:17","slug":"o-que-e-um-webhook","status":"publish","type":"post","link":"https:\/\/pingback.com\/br\/resources\/o-que-e-um-webhook\/","title":{"rendered":"Entenda o que \u00e9 um webhook e como ele funciona"},"content":{"rendered":"

Voc\u00ea sabe o que \u00e9 um webhook<\/strong>? Se pretende criar um site<\/a> ou um blog, \u00e9 poss\u00edvel utilizar essa tecnologia para adicionar mais funcionalidades a ele. Por exemplo, se voc\u00ea j\u00e1 recebeu alguma notifica\u00e7\u00e3o no celular sobre a altera\u00e7\u00e3o do status de um pedido, ou quando fez um pagamento com seu cart\u00e3o de cr\u00e9dito, voc\u00ea recebeu a a\u00e7\u00e3o de um webhook.<\/p>\n

Esses s\u00e3o apenas alguns exemplos desse recurso, que pode ser utilizado de in\u00fameras formas para promover a comunica\u00e7\u00e3o entre duas aplica\u00e7\u00f5es distintas.<\/p>\n

Apesar da semelhan\u00e7a com uma API<\/a>, que tamb\u00e9m funciona para permitir a comunica\u00e7\u00e3o entre dois sistemas, existem diferen\u00e7as importantes entre eles.<\/p>\n

Para falar sobre esse tema, preparamos este conte\u00fado com os seguintes t\u00f3picos:<\/p>\n[post-table-index]\n

Vamos l\u00e1? Boa leitura!<\/p>\n

O que s\u00e3o webhooks?<\/h2>\n

O termo webhook foi criado em 2007, pelo desenvolvedor Jeff Lindsay, para definir o tratamento de callback, ou o retorno de uma requisi\u00e7\u00e3o <\/strong>HTTP<\/strong><\/a> iniciada por um evento<\/strong>.<\/p>\n

Na pr\u00e1tica, quando um evento acontece em um sistema, ele envia uma notifica\u00e7\u00e3o para outro sistema, que ser\u00e1 o receptor desse evento. Portanto, esse \u00e9 um recurso utilizado para permitir a troca de dados entre duas aplica\u00e7\u00f5es.<\/p>\n

Para ilustrar esse conceito, imagine que temos um site de e-commerce<\/a> em que um consumidor faz a compra de determinado produto. Ao efetuar o pagamento, h\u00e1 uma comunica\u00e7\u00e3o entre o site da loja e a institui\u00e7\u00e3o de pagamento, que pode ser uma carteira digital<\/a>, por exemplo.<\/p>\n

A comunica\u00e7\u00e3o para realizar o pagamento \u00e9 feita por meio de uma API, que envia todos os dados necess\u00e1rios para a institui\u00e7\u00e3o financeira.<\/p>\n

Acontece que, apesar de a transa\u00e7\u00e3o ter sido finalizada no site, ainda h\u00e1 a pend\u00eancia sobre a confirma\u00e7\u00e3o do pagamento, que pode levar certo tempo at\u00e9 que seja processada pelo sistema da carteira digital.<\/p>\n

\u00c9 nesse momento que um webhook pode ser utilizado. Quando o pagamento for aprovado pela carteira digital, essa informa\u00e7\u00e3o precisa ser devolvida para o sistema de origem.<\/p>\n

Esse, por sua vez, utiliza o registro para atualizar o pedido e para notificar o comprador sobre a aprova\u00e7\u00e3o ou n\u00e3o da compra realizada.<\/p>\n

Como eles funcionam?<\/h2>\n

Agora, vamos \u00e0 parte t\u00e9cnica para verificar como tudo isso acontece na pr\u00e1tica. Como mencionamos, o webhook permite a comunica\u00e7\u00e3o entre dois sistemas. Para isso, ele precisa de um endpoint, que \u00e9 uma URL que funciona como um servi\u00e7o de recep\u00e7\u00e3o para atender aos eventos que chegam<\/strong>.<\/p>\n

Os eventos representam alguma mudan\u00e7a em uma condi\u00e7\u00e3o inicial de um dado. Portanto, a mudan\u00e7a no status de pagamento de pendente para aprovado \u00e9 considerada um evento, e podemos utilizar um webhook para promover a comunica\u00e7\u00e3o entre as aplica\u00e7\u00f5es.<\/p>\n

No nosso exemplo sobre a atualiza\u00e7\u00e3o do status de pagamento, o site de e-commerce<\/a> \u00e9 o sistema receptor que disponibiliza essa URL para receber os eventos ocorridos no sistema da carteira digital, que ser\u00e1 o provedor da informa\u00e7\u00e3o.<\/p>\n

Portanto, no momento em que o pagamento for aprovado por ela, ser\u00e1 enviada uma notifica\u00e7\u00e3o de volta ao site, para informar que mudou o status do pagamento.<\/p>\n

Al\u00e9m de disponibilizar a URL, precisamos informar ao sistema provedor qual ser\u00e1 o gatilho para o envio do webhook<\/strong>, ou seja, em que momento ser\u00e1 feito o disparo para a comunica\u00e7\u00e3o entre os dois sistemas.<\/p>\n

Os dados recebidos em um webhook podem ser no formato JSON<\/a>, XML<\/a> ou como dados de formul\u00e1rio (application\/x-www-form-urlencoded ou multipart\/form-data).<\/p>\n

Vale ressaltar que o formato mais utilizado \u00e9 o JSON. \u00c9 importante dizer que o webhook tanto pode receber quanto enviar dados, e ele pode ser utilizado para algumas fun\u00e7\u00f5es espec\u00edficas, como:<\/p>\n