Integração AsaFlow — Exportação de Leads
A Timipro envia ao AsaFlow os leads gerados nos seus portais (DFimóveis, 62imóveis) para os anunciantes que ativarem a integração. Este documento descreve a proposta de contrato: payload, entrega, autenticação e semântica de resposta.
Payload
Formato baseado no VrSync, acrescido dos dados do anunciante e dos dados básicos do imóvel.
{
"leadOrigin": string,
"timestamp": string,
"originLeadId": string,
"originListingId": string,
"clientListingId": string,
"transactionType": string,
"leadType": string,
"listingUrl": string,
"name": string,
"email": string,
"ddd": string,
"phone": string,
"phoneNumber": string,
"message": string,
"advertiser": {
"id": number,
"name": string,
"email": string,
"phone": string
},
"listing": {
"type": string,
"subtype": string,
"state": string,
"city": string,
"neighborhood": string,
"address": string,
"bedrooms": number,
"suites": number,
"price": number,
"usableArea": number
}
}
| Campo | Descrição |
|---|---|
leadOrigin |
Portal de origem do lead (ex.: "DFimoveis", "62imoveis") |
timestamp |
Data e hora do contato |
originLeadId |
Identificador único do lead na Timipro (chave de deduplicação) |
originListingId |
Id do anúncio no portal de origem |
clientListingId |
Código do imóvel no sistema do anunciante (código de busca) |
transactionType |
"SALE" para venda e "RENT" para aluguel |
leadType |
Tipo do contato que gerou o lead: "PHONE" (visualizou o telefone), "WHATSAPP" (visualizou o WhatsApp), "VISIT" (agendou visita), "PROPOSAL" (fez proposta), "MESSAGE" (enviou mensagem), "FINANCING" (simulou financiamento) ou "TEST" (lead de teste enviado pelo Painel) |
listingUrl |
Url do anúncio no portal de origem |
name / email |
Dados do interessado |
ddd / phone / phoneNumber |
Telefone do interessado: DDD, número sem DDD e número completo |
message |
Mensagem ou descrição do contato (visita, proposta, simulação etc.) |
advertiser |
Dados do anunciante no portal de origem |
listing |
Dados básicos do anúncio: type/subtype são o tipo e subtipo do imóvel (ex.: "Apartamento"/"Padrão"), address é o logradouro e price é o valor do anúncio |
Entrega
- Cada lead é enviado individualmente, em tempo real, via
POSTcomContent-Type: application/jsonpara um endpoint HTTPS informado pelo AsaFlow. - O endpoint pode ser único (o cliente é identificado pelo token) ou por cliente — os dois modelos são suportados.
- Timeout de 30 segundos por requisição.
- É necessário um ambiente de homologação com credencial de teste antes da ativação em produção.
Autenticação
Token por cliente, emitido pelo AsaFlow, enviado no header:
Authorization: Bearer {token}
O token identifica o anunciante no AsaFlow. A troca ou revogação do token é feita por atualização de cadastro, sem mudança de código.
Idempotência
originLeadIdé o identificador único do lead e deve ser usado como chave de deduplicação.- Em caso de falha transitória a Timipro reenvia o mesmo lead em até 3 tentativas — o AsaFlow vai receber duplicatas e deve descartá-las pelo
originLeadId, respondendo sucesso.
Semântica de resposta
| Status | Significado | Comportamento da Timipro |
|---|---|---|
| 2xx | Lead aceito (ou duplicata descartada) | Envio registrado, sem reenvio |
| 4xx | Rejeição definitiva (payload ou credencial inválidos) | Não há reenvio; a falha é registrada |
| 5xx / timeout | Falha transitória | Até 3 novas tentativas com intervalo de 5 segundos |
- Falhas consecutivas abrem um circuit breaker de 3 minutos para o endpoint.
- Em caso de rejeição (4xx), o corpo da resposta deve conter a razão em JSON, para diagnóstico.