Fifty Voltar ao início

Integração de leads para portais

Última atualização: 18/11/2026 · Documento para equipes técnicas de portais imobiliários

O Fifty CRM é uma plataforma de atendimento e marketing para corretores e imobiliárias. Quando um interessado entra em contato por um anúncio no portal, o portal envia esse contato ao Fifty, que o registra no CRM do corretor responsável e inicia o atendimento em segundos.

Resumo: o Fifty recebe os leads no formato que o próprio portal já usa. O portal não precisa desenvolver um formato novo, apenas apontar o envio de contatos para o endereço do Fifty.

O endereço de recebimento e as credenciais são entregues em canal privado, durante a homologação. Eles não são publicados nesta página.

1. Modelo de integração

  • Envio em tempo real (push): o portal envia cada contato ao Fifty por requisição HTTPS POST, no momento em que ele acontece. O Fifty não consulta o portal periodicamente para buscar leads.
  • Formato: JSON, codificação UTF-8.
  • Um ponto de recebimento por portal: o mesmo endereço atende todos os corretores do Fifty anunciados naquele portal. O lead é ligado ao corretor pela referência do anúncio (ver seção 4).
  • Anúncios: os imóveis do corretor chegam ao portal por feed XML, com endereço individual por conta, também entregue em privado.

2. Autenticação

  • Toda requisição deve trazer, no cabeçalho Authorization, a credencial fornecida pelo Fifty para aquela integração.
  • Requisições sem credencial ou com credencial inválida são recusadas e nenhum dado é gravado.
  • Somente HTTPS é aceito. A credencial pode ser trocada a qualquer momento, a pedido do portal ou do Fifty, sem mudar o restante da integração.

3. ImovelWeb, Wimoveis e Casa Mineira (Grupo QuintoAndar)

O Fifty recebe os callbacks de contato no formato padrão da plataforma desses portais, em qualquer um dos idiomas disponíveis (português, espanhol ou inglês). Assine os eventos de contato:

  • CONTACTO: contato feito pelo anúncio.
  • CONTACTO_MENSAJE: contato com mensagem escrita.

Outros eventos, como os avisos sobre o anúncio, são confirmados com sucesso e descartados, sem gerar erro.

Campos utilizados (nomes da versão em português)

  • tipoEvento: tipo do evento (ver acima).
  • idEvento: identificador único do contato. Obrigatório para evitar duplicidade (seção 5).
  • referencia: código de referência do anúncio, o mesmo enviado no feed de imóveis do Fifty. É o campo que liga o lead ao corretor.
  • nome, email: dados do interessado.
  • ddd e telefone, ou telefone completo em formato internacional (+55...).
  • mensagem: texto escrito pelo interessado, quando houver.
  • idTipoContacto: tipo de contato (consulta, pedido de ligação, agendamento de visita, ver dados do anunciante, WhatsApp, avaliação). O Fifty usa esse dado para priorizar o atendimento.

Nas versões em espanhol e inglês, os campos equivalentes (nombre, telefono, mensaje, eventId, clientListingId e demais) são reconhecidos da mesma forma.

Exemplo ilustrativo (dados fictícios)

{
  "tipoEvento": "CONTACTO_MENSAJE",
  "idEvento": "123456789",
  "referencia": "AP_00042",
  "nome": "Maria Exemplo",
  "email": "[email protected]",
  "telefone": "+5511999990000",
  "mensagem": "Gostaria de agendar uma visita.",
  "idTipoContacto": "3"
}

4. Como o lead chega ao corretor certo

  • O Fifty localiza o imóvel pela referência do anúncio e entrega o lead ao CRM da conta dona daquele imóvel, já vinculado a ele.
  • Se o interessado já existe no CRM do corretor (mesmo e-mail ou telefone), o novo contato é somado ao histórico dele, sem criar cadastro duplicado.
  • Leads nunca são compartilhados entre contas. Cada corretor vê apenas os contatos dos próprios anúncios.

5. Confirmação de recebimento e reenvio

  • Qualquer resposta 2xx confirma o recebimento. O processamento acontece logo em seguida, em segundo plano, então o portal não precisa aguardar o atendimento.
  • Em caso de resposta diferente de 2xx ou sem resposta, o portal pode reenviar o mesmo contato.
  • Reenvios com o mesmo idEvento são reconhecidos e confirmados com sucesso, sem criar lead duplicado. Por isso o reenvio é sempre seguro.
  • Corpo inválido (JSON malformado) é recusado com erro 4xx e não deve ser reenviado sem correção.

6. Outros portais integrados

O Fifty também recebe leads em tempo real do Grupo OLX (ZAP Imóveis, Viva Real e OLX) e do Chaves na Mão, sempre no formato padrão de cada portal e com as mesmas regras de autenticação, vínculo e reenvio descritas acima. Portais interessados em integrar podem usar este documento como referência e falar com a gente pelo contato abaixo.

7. Segurança e proteção de dados

  • Tráfego somente por HTTPS, com credencial exigida em toda requisição.
  • Os dados do interessado são usados apenas para o atendimento pelo corretor responsável, conforme a LGPD. O Fifty atua como operador desses dados em nome do corretor, nos termos do Contrato de Tratamento de Dados.
  • Endereços de recebimento, credenciais e endereços de feed são tratados como informação confidencial e trocados somente em canal privado com a equipe técnica do portal.

8. Homologação e contato técnico

Para ativar ou revisar uma integração, fale com a equipe técnica do Fifty. Nesse contato enviamos o endereço de recebimento e a credencial, e fazemos juntos um envio de teste antes da ativação.

Fifty CRM, operado por C. BERCHT NETO LTDA

CNPJ: 62.731.692/0001-03

E-mail técnico: [email protected]

Ver Contrato de Tratamento de Dados Ver Política de Privacidade