Como funciona o Webhook?

Introdução

Um webhook é um endpoint HTTP que os integradores devem implementar para receber notificações em tempo real de eventos que ocorrem no Situator.

Os webhooks podem ser utilizados para:

• Monitorar os eventos de acesso. Por exemplo:

  • Para monitorar a entrada e saída de moradores em tempo real;

• • Para monitorar a entrada de visitantes e notificar as pessoas responsáveis;

• Monitorar as ocorrências. Por exemplo:

  • Ocorrências de interfone;

  • Ocorrências de pânico;

  • Ocorrências de porta arrombada;

  • Ocorrências de porta deixada aberta;

• Monitorar o cadastro de pessoas. Por exemplo:

  • Para notificar outros sistemas de que houve o cadastro, edição ou exclusão de uma pessoa;

Funcionamento

Quando um evento acontece no Situator, o Situator coloca o evento em um buffer para ser enviado para os webhooks cadastrados.

Quando um evento é colocado no buffer de eventos, o Situator imediatamente retira eles do buffer e envia eles para o integrador.

Caso o integrador esteja offline ou ocupado demais para processar os eventos, os eventos serão descartados.

Enquanto o Situator estiver enviando os eventos para o integrador, os novos eventos que forem ocorrendo serão armazenados no buffer. Caso o integrador demore muito tempo para processar a requisição, isso pode encher o buffer com eventos que estão esperando para serem processados. Se o buffer chegar em 100 eventos, os novos eventos serão descartados pelo Situator.