Webhooks

Neste rápido tutorial explicativo vamos falar um pouco sobre Webhooks, para que eles servem. e o mais legal, como utilizá-los na prática para avançarmos ainda mais nas nossas vendas e networking a partir da Xgrow.

O que são webhooks?

Webhooks são chamadas de retorno (callbacks) que permitem notificarmos outros serviços quando algum evento dentro da Xgrow acontece.

Sabendo disso, vamos ver alguns exemplos de utilização de Webhooks e os conteúdos que eles podem carregar para o outro sistema:

Exempolos de webhooks

Através dos webhooks é possível realizar difersas integrações, como:
Adicionar um novo lead gerado a nossa lista de contato
Atualizar o seu sistema de estoque após uma nova venda
Guardar informações de alguma transação recusada para relacionamento com o cliente

Enfim, são muitas as possibilidades de "conversar" com outros sistemas de forma automática, à partir de uma ação realizada dentro da nossa Plataforma.

Acesse a página Especificação dos webhooks para visualizar os exemplos completos e informações de cada payload ou evento que possa ser configurado

Webhooks seguros

Para que esta conversa seja segura e o outro sistema possa ter certeza que está recebendo uma requisição da Xgrow e não de um ataque malicioso, vamos utilizar uma técnica de assinatura, que é muito simples:

No sistema que está prestes a integrar o Webhook da Xgrow, certifique-se de extrair a assinatura do cabeçalho da requisição:



Para validar se a assinatura está correta e que podemos consumir este Webhook no outro serviço, podemos utilizar a seguinte função:



apiKey é gerado logo quando criamos o serviço de integração Webhook na Xgrow.

Webhooks na prática

Um exemplo simples de algoritmo para consumir um Webhook em NodeJS:



Agora, o mesmo exemplo em PHP:

Integração Webhooks & Xgrow

Veja a seguir, o passo a passo para configurar uma integração via webhook com a plataforma Xgrow.

Acesse a plataforma de usuário da XGrow. Nas ferramentas, clique em Recursos, em Integrações, e em Nova integração. Selecione a integração Webhook.



Defina um nome para a integração e cole a URL do webhook no campo disponível. Copie a Chave da Xgrow e transcreva-a na plataforma externa da qual está realizando esta integração. Torne a integração Ativa e clique em Salvar.



Clique novamente na integração na opção Visualizar ações. Adicione uma Nova ação.



Torne a ação Ativa, defina um nome e a qual produto e plano ela estará relacionada. Defina quando a ação escolhida deverá ocorrer e também, qual ação deverá ser feita quando o evento escolhido for efetuado. Finalize clicando em Salvar.



Você poderá criar quantas ações forem necessárias para que suas integrações funcionem de acordo com suas necessidades.

Após finalizar as configurações, sua integração estará pronta para utilização!

Atualizado em: 21/02/2024