Documentação para desenvolvedores
O ImobiliQ recebe leads de qualquer origem por uma API HTTP com token, devolve os eventos de conversão para a Meta e aceita os leads do formulário nativo do Facebook e do Instagram. Em geral, a integração inteira é uma requisição POST: você manda nome e telefone, e o lead entra no pipeline já com dono.
Por onde começar?
Se você quer mandar leads do seu site, da sua landing page ou de uma automação (n8n, Make, Zapier) para o CRM, vá direto para Enviar leads para o CRM. É o caminho de 90% das integrações e leva um copiar e colar.
Se você anuncia na Meta e quer que o Facebook aprenda com quem realmente fechou negócio, vá para Conectar a Meta.
O que tem em cada seção
O que é preciso saber antes
Cada imobiliária é uma conta. Todo dado é isolado por conta, e o token de integração pertence a uma conta específica. Ele é o que diz ao sistema de quem é o lead que está chegando, então não existe campo de identificação no corpo da requisição.
O telefone é a identidade. É por ele que o lead do formulário e a conversa no WhatsApp viram a mesma pessoa. Mande sempre o telefone quando tiver, de preferência com o código do país (+5547999990000). O formato não precisa ser exato: com ou sem o nono dígito, com ou sem parênteses, o sistema reconhece o mesmo número.
Reenviar não duplica. Se você mandar o mesmo telefone de novo enquanto aquele lead ainda está em atendimento, o ImobiliQ soma as informações novas na ficha em vez de criar um segundo card. A resposta vem com duplicado: true e o identificador do lead que já existia.
E se algo não funcionar?
A página Erros e o que fazer lista cada resposta possível e a causa. Se o problema persistir, abra um chamado pelo menu Suporte dentro do sistema, com o corpo da requisição e a resposta que você recebeu.