Criada para facilitar o cadastro automático de Leads(Contatos) no SMART, esta API deve ser usada pelas empresas querem integrar cadastros de formulários em outras páginas de Sites, Landing Pages ou sistemas. A API é de linguagem muito simples e de fácil entendimento para programadores e designers.

O funcionamento é bastante simples. Ao criar uma nova fonte de Leads, como uma Landing page, ou um novo formulário em seu site, basta que o desenvolvedor responsável use a API de Leads do SMART no formulário da página de cadastro do Contato.  Como no exemplo http://www.smartimobiliario.com.br/form-lead.php

Abaixo segue o formato de formulário aceito para cadastro no sistema:

  1. A URL para envio de dados deve ser:

http://app.smart.youdigital.com.br/atendimento/cadastrarContatosOnline

  1. Método da requisição feita:

Requisição HTTP do tipo POST

  1. Header

O POST deve conter o HEADER “Content-Type: application/x-www-form-urlencoded”

  1. Body

No Body do POST deve vir um formulário com as seguintes informações:

Parâmetros obrigatórios no envio dos dados

(id_anunciante e email: o envio não irá funcionar sem eles)
ou
(id_empresa e email: o envio não irá funcionar sem eles)

 Parâmetro Descrição
id_anunciante ou id_empresa Identificador da sua conta do Smart. Você deve utilizar o valor numérico fornecido pela equipe do SMART.

SOLICITE SEU ID DE ANUNCIANTE ou ID DA EMPRESA À EQUIPE SMART

email o e-mail do Lead

Os parâmetros abaixo são opcionais no envio e variam de acordo com os campos requisitados no formulário externo. Esses dados ficarão dispostos nos Detalhes do Lead e podem ser interessantes para posterior qualificação e segmentação da base. Alguns parâmetros possíveis:

 Parâmetro Descrição
data Data do lead. Formato obrigatório dd/MM/yyyy
hora Hora do lead. Formato Obrigatório HH:mm:ss
nome_contato Nome do Contato. Máximo 100 caracteres
telefone telefone do Lead
celular celular do Lead
mensagem mensagem do Lead Máximo 300 caracteres
tipo_de_interesse Específico para imóvel.

0 (número zero) para Interesse em imóvel de Venda

1 (número um) para Interesse em imóvel de Aluguel

codigo_referencia_imovel Específico para imóvel.

Código de Referência do Imóvel na empresa. Exp LA-0021

tipo_origem  * Origem e Detalhe da Origem do Lead

0 – Site da Empresa

1 – Portal expoimovel.com

2 – Portais/Redes Imobiliárias Cadastradas no Sistema

3 – Outra Origem

id_rede Id do Portal/Rede Imobiliária (Ver tabela de Portais e Redes Imobiliárias)
id_outra_origem * Id da Origem do Atendimento (Ver tabela de Origens)
id_detalhe_outra_origem * Id do Detalhes do Atendimento (Ver tabela de Detalhes de Origem)

*IMPORTANTE: Para o caso do campo tipo_origem ser enviado com o valor 3, os campos id_outra_origem e/ou id_detalhe_outra_origem devem ser obrigatoriamente preenchidos com os valores de acordo com a tabelas abaixo. Para usar origens de Leads distintos da tabela, consulte os códigos de origens e detalhes de origens cadastrados no seu SMART:

id_outra_origem id_outra_origem id_detalhe_outra_origem * id_outra_origem
1 AÇÃO DE RUA 401 PANFLETAGEM
2 ESTANDE DE VENDAS Verificar no Smart Verificar no Smart
3 FEIRAS 402 FEIRÃO DA CAIXA
4 INDICAÇÃO Campo aberto
5 INTERNET 404 FACEBOOK
5 INTERNET 405 SITE DA EMPRESA
5 INTERNET 406 TWITTER
5 INTERNET 407 PLACA IMÓVEL
6 JORNAL Verificar no Smart  Verificar no Smart
7 LISTA TELEFÔNICA Verificar no Smart  Verificar no Smart
8 OUTDOOR Verificar no Smart  Verificar no Smart
9 PLACA Verificar no Smart  Verificar no Smart
10 RÁDIO Verificar no Smart  Verificar no Smart
11 REVISTA Verificar no Smart  Verificar no Smart
12 TELEVISÃO Verificar no Smart  Verificar no Smart
13 OUTROS Campo aberto

 

  1. O formulário de exemplo:

Para facilitar a sua implementação, deixamos pronto um exemplo no endereço abaixo. Veja o código e entenda melhor como funciona.

 O formulário disponibilizado em http://www.smartimobiliario.com.br/form-lead.php

 

figura1
formulário exemplo

Entenda o código fonte do nosso exemplo. A seguir, segue o trecho da parte principal do código. Para ver todo o conteúdo, utilize a opção de exibir código fonte de seu navegador (View Source):

...

<input type="hidden" name="id_anunciante" value="SOLICITE SEU ID DE ANUNCIANTE À EQUIPE SMART">

<input type="hidden" name="id_outra_origem" value="3">

<input type="hidden" name="tipo_origem" value="5">

<input type="hidden" name="id_detalhe_outra_origem" value="404">

NOME:*

<input type="text" name="nome_contato" id="nome_contato"  required="required" value="" class="required estilo-input-text-form-contato" />

TELEFONE:*

<input type="text" name="telefone" id="telefone" value=""  required="required" class="required estilo-input-text-form-contato" />

E-MAIL:*

<input type="text" name="email" id="email" value=""  required="required" class="required email estilo-input-text-form-contato" />

...

 

...
<html>
<head>
<title>Exemplo Formulário html com jquery ajax</title> 
</head> 
<body> 
     <form method="POST" id="formulario" action="#"> 
          <input type="hidden" name="id_empresa" value="COLOQUE O ID DA EMPRESA AQUI"> 
          <input type="hidden" name="tipo_origem" value="3"> 
          <input type="hidden" name="id_outra_origem" value="5"><!--INTERNET--> 
          <input type="hidden" name="id_detalhe_outra_origem" value="405"><!--SITE DA EMPRESA--> 
          <input type="hidden" name="tipo_de_interesse" value="0"> 
          <input type="hidden" name="codigo_referencia_imovel" value="CODIGO REFERENCIA DO IMOVEL AQUI"> 
          <label for="name" class="active">Nome</label> 
          <input type="text" name="nome_contato" required="required" value="" class="form-control" id="nome" placeholder="Insira seu nome"> 
          <label for="email" class="active">Email</label> 
          <input type="text" name="email" id="email" value="" required="required" class="form-control" placeholder="exemplo@seudominio.com"> 
<label for="name" class="active">Telefone</label> 
          <input type="text" name="telefone" value="" required="required" class="form-control" id="numero" placeholder="(XX) 9.9999-9999"> 
          <input type="text" name="mensagem" value="" required="required" class="form-control" id="mensagem" value="mensagem aqui"> 
          <button type="submit" name="submit" value="ENVIAR">Enviar</button> 
     </form> 

<script src="https://code.jquery.com/jquery-1.12.4.min.js" ></script>

<script> //acao de monitoramento do submit do formulario COM JQUERY 
     $("#formulario").submit(function(){ 
          var url = "http://app.smart.youdigital.com.br/atendimento/cadastrarContatosOnline"; 
          var dados = $("#formulario").serializeArray();//no lugar do "formulario" fica o id do seu formulario 
               $.ajax({ url: url, type: "POST", data: dados, complete: function (jqxhr) { 
               //de acordo com o retorno encaminhar sua mensagem ou redirecionar 
               if(jqxhr.status === 200){ 
                    alert("Contato Enviado!"); //aqui você poderá redirecionar para sua página de aviso de sucesso ex: location.href = "http://www.seudominio.com/suapaginadesucesso.html"; 
               }else{ 
                    alert("Falha ao enviar o contato!"); //aqui você poderá redirecionar para sua página de aviso de erros ex: location.href = "http://www.seudominio.com/suapaginadeerro.html"; 
               } 
          } 
     });
     return false; 
     }); 
</script> 
</body> 
</html> 
...
  1. Checando se os LEADS foram corretamente cadastrados:

Depois de finalizar a implementação do seu formulário, preencha os dados e clique no botão ENVIAR. Em seguida, peça para a pessoa que tem acesso de administrador do sistema,  configurada no sistema para receber os leads/contatos online, para verificar se os mesmo estão sendo corretamente cadastrados.

Como verificar qual usuário no SMART receberá os leads?

No menu Configurações -> Configurar Sistema, verifique o usuário selecionado como Usuário Padrão.

 

 

figura2-leads
Verificando qual o usuário receberá o Lead

 

Como checar no SMART os novos leads recebidos?

No menu Atendimento -> Contatos Online, verifique a lista dos novos contatos cadastrados, seu teste deverá aparecer nela.

figura3-leads.png
O lead será adicionado à tela de Contatos Online
Anúncios