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
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 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