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?

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.

Especificação dos Webhooks

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:

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.

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

Atualizado em: 23/01/2025