Integração de leads para portais
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.dddetelefone, 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
idEventosã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]