Os webhooks são uma ferramenta poderosa para receber informações sobre eventos de API à medida que eles acontecem. Um evento, como um pagamento sendo feito ou recebendo um Pix, é uma atividade que ocorre fora do seu sistema. Com os webhooks, você pode criar ou configurar integrações que permitem que as notificações sejam enviadas automaticamente para um endpoint específico sempre que ocorrer um evento.

Por que usar webhooks?

Economia de recursos

Em vez de seu aplicativo ter que fazer solicitações constantes para verificar se há atualizações (sondagem), os webhooks enviam notificações somente quando ocorre um evento específico. Isso reduz o uso e o processamento da largura de banda, economizando recursos e melhorando o desempenho geral do aplicativo. A economia de recursos também pode levar à redução de custos operacionais e maior eficiência no gerenciamento de infraestrutura.

Confiabilidade

Os webhooks fornecem uma maneira confiável de garantir que eventos importantes sejam notificados imediatamente. Nosso sistema de webhook implementa mecanismos de repetição, o que aumenta a confiabilidade da comunicação. Isso garante que, mesmo em casos de falhas ou interrupções temporárias, as notificações serão repetidas até que sejam recebidas corretamente pelo sistema.

Latência reduzida

Ao receber notificações em tempo real, o sistema pode responder rapidamente aos eventos, o que reduz a latência em comparação com as abordagens baseadas em pesquisas. Isso é particularmente importante para aplicações que exigem respostas rápidas.

Melhor escalabilidade

Os webhooks permitem que seu sistema reaja a eventos sem sobrecarregar a API com solicitações de sondagem. Isso pode melhorar a escalabilidade, evitando que o aplicativo tenha que lidar com um grande número de solicitações simultâneas para verificar se há atualizações, permitindo que o sistema se concentre no processamento de eventos reais à medida que eles ocorrem.

Como posso identificar a origem dos gatilhos de webhook?

Usamos IPs dinâmicos para enviar nossos webhooks, o que significa que os endereços IP podem mudar a cada envio. Para garantir a segurança e a identificação adequada dos webhooks enviados por nossa plataforma, recomendamos que você configure um cabeçalho personalizado no webhook. Abaixo está um exemplo de como configurá-lo:

{  
  "uri": "{your_webhook_url}",  
  "enabled": true,  
  "headers": {  
    "headerName": "{your_header_name}"  
  }  
}

Ao configurar o webhook desta forma, sempre que enviarmos um webhook, incluiremos o cabeçalho que definiu, permitindo a identificação e autenticação das mensagens.