Receba eventos do front office do Mercateer como webhooks
Inscreva um endpoint para receber eventos do Mercateer e obtenha uma carga assinada no exato momento em que uma chamada termina, um lead chega ou um serviço é agendado. Registre e gerencie endpoints pela API ou pelo painel e verifique todas as entregas com HMAC.
O que é Webhooks?
Os webhooks enviam eventos do front office do Mercateer para uma URL sob seu controle em tempo real, permitindo que seus próprios sistemas reajam sem precisar consultar a API repetidamente. Cada entrega é uma carga JSON assinada com HMAC; você registra e gerencia endpoints pela API ou pelo painel, e entregas com falha são refeitas com intervalos crescentes.
O que você pode fazer com Webhooks
Instale em minutos
Crie um endpoint
Registre sua URL e escolha os eventos aos quais deseja se inscrever, pela API ou em Configurações > Desenvolvedor. O Mercateer retornará um segredo de assinatura para esse endpoint. O acesso à API está incluído nos planos Crew e Fleet.
Verifique a assinatura
A cada entrega, leia o timestamp (t) e a assinatura (v1) do cabeçalho de assinatura, calcule o HMAC-SHA256 da string "{timestamp}.{raw request body}" com o seu segredo de assinatura e compare com o valor de v1. Rejeite qualquer requisição que não bata ou cujo timestamp tenha mais de 5 minutos, assim você só age sobre payloads recentes que realmente vieram da Mercateer. (O helper de verificação do nosso SDK faz tudo isso para você.)
Trate novas tentativas de forma idempotente
Responda rapidamente com um código 2xx para confirmar o recebimento. Entregas com falha são refeitas com intervalos crescentes, então identifique seu manipulador pelo ID do evento para ignorar duplicatas e processar cada evento apenas uma vez.
Perguntas frequentes
Funciona com toda a sua pilha de ferramentas
O Mercateer fala os mesmos protocolos das ferramentas que você já usa.
Coloque o Mercateer para trabalhar com Webhooks
Comece gratuitamente e conecte seu atendimento inicial em minutos.
Não é necessário cartão de crédito