Receba eventos do atendimento do Mercateer como webhooks
Subscreva um endpoint aos eventos do Mercateer e receba uma carga assinada no exato momento em que uma chamada termina, entra um potencial cliente ou um serviço é agendado. Registe e gere endpoints através da API ou do painel de controlo e verifique todas as entregas com HMAC.
O que é o Webhooks?
Os webhooks enviam eventos do atendimento do Mercateer para um URL sob o seu controlo em tempo real, permitindo que os seus sistemas reajam sem precisar de consultar periodicamente a API. Cada entrega é uma carga JSON assinada com HMAC; regista e gere endpoints pela API ou pelo painel de controlo, e as entregas falhadas são reenviadas com intervalos crescentes.
O que pode fazer com o Webhooks
Instale em minutos
Criar um endpoint
Registe o seu URL e escolha os eventos a subscrever, quer pela API quer em Definições > Programador. O Mercateer devolve um segredo de assinatura para esse endpoint. O acesso à API está incluído nos planos Crew e Fleet.
Verifique a assinatura
Em cada entrega, leia a marca temporal (t) e a assinatura (v1) do cabeçalho de assinatura e depois calcule o HMAC-SHA256 da string "{timestamp}.{raw request body}" com o seu segredo de assinatura e compare-o com o valor v1. Rejeite qualquer pedido que não corresponda, ou cuja marca temporal tenha mais de 5 minutos, para só atuar sobre payloads recentes que vieram mesmo do Mercateer. (O ajudante de verificação do nosso SDK faz tudo isto por si.)
Trate reenvios de forma idempotente
Responda rapidamente com um código 2xx para confirmar a entrega. As entregas falhadas são reenviadas com intervalos crescentes, por isso identifique o seu manipulador pelo ID do evento para ignorar duplicados e processar cada evento apenas uma vez.
Perguntas frequentes
Funciona com toda a sua stack
O Mercateer utiliza os mesmos protocolos das ferramentas que já utiliza.
Coloque o Mercateer a funcionar com o Webhooks
Comece gratuitamente e ligue o seu atendimento em minutos.
Não é necessário cartão de crédito