API Integração de leads

Modificado em Seg, 2 Dez, 2024 na (o) 10:10 AM

Manual de Integração externa de Leads:

Para acessar a tela de integrações, clique em "Imobiliária - Integrações":

Em seguida, você será direcionado(a) para a tela com a exibição de todas as integrações que o sistema possui:

Caso ainda não tenha criado nenhuma integração FLIP, clique no '+' e selecione a FLIP:

Assim que criado, clique na engrenagem da integração para acessar as configurações dela:

Assim que aberto, note que há dois links, sendo um consta o xml de anúncios, e outro, que é para integração de leads:

Exemplo de payload:

{

  "source": "Descrição ou link da fonte do lead",

  "tipoAnuncio": "CONDOMINIO" ou "IMOVEL",

  "anuncio": "Identificador do condominio ou do imóvel",

  "nome": "Nome do cliente",

  "email": "email.do.cliente@gmail.com",

  "telefone": "44999999999",

  "mensagem": "Mensagem do cliente",

  "dataCriacao": "2021-09-23 17:39:34"

}

Campo	Valores	Obrigatório
source	String: Texto descrevendo a origem. Ex: “Landing Page A”, “Integração Software X”	Não
tipoAnuncio	‘IMOVEL’ ou ‘CONDOMINIO’	Não
anuncio	Código alfanumérico do imóvel ou condomínio	Não
pretensao	‘VENDA’ ou ‘LOCACAO’	Não
nome	string: Nome do Lead	Não
telefone	string: Telefone do Lead	Não
mensagem	string: Mensagem de interesse	Não
email	string: Email do cliente	Não
dataCriacao	datetime	Não
tipoMidia	campo para identificar a Mídia: “SITE”, “FACEBOOK”, “INSTAGRAM”, etc	Não

O campo tipoAnuncio pode receber os valores IMOVEL ou CONDOMINIO (utilizado para lançamento)
No caso de CONDOMINIO, o campo anuncio deve receber o código do lançamento dentro do CRM. Esse código é numérico.
Caso o campo de pretensao vier vazio, o sistema atribuirá como VENDA automaticamente nos casos em que nenhum código for informado no campo anuncio. Caso tenha sido informado, a pretensão de anúncio do Código informado será atribuída ao Cliente.
É necessário ter pelo menos um campo de contato: telefone ou email .
O Campo de telefone deve ser enviado como string , pode ser enviado com o código de País ou não, pode conter caracteres especiais ( +, (, ), etc), a Flip irá ler apenas os caracteres numéricos e vincular ao Cliente.
Se o cliente possuir um número de telefone internacional (não brasileiro), o número deve ser enviado completo, incluindo o DDI , e precedido pelo sinal "+".
O campo de mensagem é de texto livre e será apresentado internamente no cadastro do Interesse.
Caso nenhuma mídia seja informada no campo tipoMidia , a mídia LANDING_PAGE (Landing Page) será atribuída.
O campo de tipoMidia poderá receber os seguintes valores:

[
  "SITE",
  "FACEBOOK",
  "FACEBOOK_PESSOAL",
  "INSTAGRAM",
  "INSTAGRAM_PESSOAL",
  "ZAP_IMOVEIS",
  "VIVA_REAL",
  "OLX",
  "CASA_MINEIRA",
  "IMOVELWEB",
  "SUB100",
  "AGENDA_CAFE",
  "GOOGLE",
  "RD_STATION",
  "FOLHETO",
  "CARTAO_VISITA",
  "INDICACAO",
  "EVENTO",
  "PLACA",
  "OUTDOOR",
  "TV",
  "CAPTACAO",
  "LANDING_PAGE",
  "OUTROS",
  "CHAVES_NA_MAO",
  "CREDPAGO",
  "CLIQUEI_MUDEI",
  "IMOVEIS_BC",
  "ALTO_PADRAO_BC",
  "123I",
  "APTO",
  "DGBZ",
  "CHAT2DESK",
  "DFIMOVEIS",
  "ATTRIA",
  "PLANTAO",
  "RELACIONAMENTO",
  "DREAMCASA",
  "YOUTUBE",
  "PORTAL_DO_CORRETOR",
  "GRUPO_ZAP"
]