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 POST com Content-Type: application/json para 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.