Integração de Leads via Webhook

A plataforma Autocerto oferece o envio automático de leads diretamente para o seu sistema por meio de webhook. Esta documentação descreve o formato do payload, os requisitos do endpoint receptor e o processo de ativação da integração.

O que é o Webhook

Os leads gerados na plataforma Autocerto são enviados automaticamente para a URL informada pelo cliente por meio de uma requisição HTTP POST. O envio ocorre em ciclos de 30 minutos — ou seja, os leads chegam ao seu sistema com um intervalo máximo de 30 minutos após o cadastro, sem necessidade de consultas periódicas (polling) à nossa API.

Método HTTP

POST application/json

Formato dos dados

JSON (UTF-8)

Timeout por requisição

30 segundos

Frequência de envio

A cada 30 minutos

Payload Enviado

O Autocerto enviará uma requisição POST para a URL cadastrada com o seguinte corpo JSON:

{

  "id":         18452,

  "idLoja":     301,

  "loja":       "Concessionária Exemplo",

  "nome":       "João da Silva",

  "email":      "joao@email.com",

  "telefone":   "11912345678",

  "telefone2":  "",

  "cpf":        "123.456.789-00",

  "dataLead":   "2025-06-09T14:32:00",

  "midia":      "Site",

  "veiculo":    "Honda Civic 2024",

  "placa":      "ABC-1234",

  "teor":       "Gostaria de saber mais sobre o veículo."

}

Descrição dos Campos

Campo	Tipo	Descrição
id	integer	Identificador único do lead na plataforma Autocerto
idLoja	integer	Identificador da loja/concessionária de origem do lead
loja	string	Nome fantasia da loja/concessionária de origem
nome	string	Nome completo do lead (cliente em potencial)
email	string	Endereço de e-mail do lead
telefone	string	Telefone principal (somente números)
telefone2	string	Telefone secundário (somente números)
cpf	string	CPF do lead
dataLead	datetime	Data e hora de cadastro do lead (formato ISO 8601)
midia	string	Origem/mídia do lead (ex.: Site, Facebook, WhatsApp)
veiculo	string	Veículo de interesse do lead
placa	string	Placa do veículo vinculado ao lead (quando aplicável)
teor	string	Mensagem ou observação enviada pelo lead

Todos os campos são sempre enviados no JSON — quando não preenchidos, o valor enviado é uma string vazia ("").

Autenticação do Endpoint

Para proteger seu endpoint e garantir que apenas requisições autorizadas sejam aceitas, é possível configurar um token de segurança. Quando fornecido, o token é enviado no cabeçalho Authorization de cada requisição, permitindo que seu sistema valide a origem antes de processar os dados.

POST https://seu-sistema.com/webhook/leads HTTP/1.1

Content-Type: application/json

Authorization: Bearer seu_token_secreto

{ ... payload do lead ... }

Recomendação: Sempre utilize HTTPS e valide o token recebido antes de processar o lead. Requisições sem o token esperado devem retornar HTTP 401 Unauthorized.

Resposta Esperada pelo Seu Endpoint

O Autocerto considera o envio bem-sucedido quando seu endpoint retorna qualquer código HTTP de sucesso (família 2xx). Não é necessário retornar nenhum corpo específico na resposta.

Código HTTP	Interpretação	Comportamento
200, 201, 204	Sucesso	Lead marcado como entregue — não será reenviado
4xx / 5xx	Falha	Lead permanece na fila e será reenviado no próximo ciclo
Timeout (> 30s)	Falha	Lead permanece na fila e será reenviado no próximo ciclo

Processamento assíncrono recomendado: Se o processamento do lead for demorado, seu endpoint deve retornar 200 OK imediatamente e processar os dados em background para evitar timeout.

Como Ativar a Integração

Para habilitar o recebimento de leads via webhook, envie um e-mail para suporte@autocerto.com pelo e-mail cadastrado da loja com as seguintes informações:

URL do Webhook

Endereço HTTPS do endpoint em seu sistema que receberá as requisições POST com os dados do lead.
Exemplo: https://seu-sistema.com/api/webhook/leads

Token de Segurança (opcional)

Token que será enviado no cabeçalho Authorization de cada requisição. Recomendado para validar que a requisição é originada pelo Autocerto.

Ativação pela equipe Autocerto

Após o cadastro da URL e do token, o Autocerto iniciará o envio automático de todos os leads gerados a partir daquele momento.

Bem-vindo à Central de Ajuda dos produtos AutoCerto