API de Integração de LeadsChaves na Mão

Início Rápido ​

1. Configure seu Webhook ​

Forneça uma URL que receberá as requisições POST com os dados dos leads:

https://seu-dominio.com/webhook/leads

2. Implemente o Endpoint ​

Crie um endpoint que receba requisições POST e valide a autenticação:

<?php
// Captura os headers de autenticação
$authHeader = $_SERVER['HTTP_AUTHORIZATION'] ?? '';
$authToken = str_replace('Basic ', '', $authHeader);
$credentials = base64_decode($authToken);
list($email, $token) = explode(':', $credentials);

// Valide o token
if (!validarToken($email, $token)) {
    http_response_code(401);
    exit('Não autorizado');
}

// Processa o lead
$leadData = json_decode(file_get_contents('php://input'), true);
processarLead($leadData);

3. Processe os Leads ​

Os dados chegam em formato JSON com todas as informações necessárias:

{
  "id": "12345",
  "name": "João Silva",
  "email": "joao@email.com",
  "phone": "11999999999",
  "message": "Tenho interesse no veículo",
  "segment": "VEHICLE",
  "ad": {
    "id": "67890",
    "title": "Honda Civic 2020",
    "brand": "Honda",
    "model": "Civic"
  }
}

Próximos Passos ​

Outras Integrações ​

Confira também nossas outras documentações de integração:

• Documentação XML de Imóveis - Integre seu sistema via XML para anúncios de imóveis
• API de Veículos - Integração completa via API REST para gestão de veículos