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
IntegrationPages.On every delivery, read the timestamp (t) and signature (v1) from the signature header, then compute the HMAC-SHA256 of the string "{timestamp}_{raw request body}" with your signing secret and compare it to the v1 value_ Reject any request that does not match, or whose timestamp is more than 5 minutes old, so you only act on fresh payloads that truly came from Mercateer_ (Our SDK’s verify helper does all of this for you_)
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