Para efetuar a integração de um formulário de contato com a API LAHAR por meio de Javascript, siga os passos abaixo:

1) Insira na propriedade class dos elementos do formulário: api-lahar e lahar_[nome_campo_integracao]

Exemplos:

<br>Nome: <input class="api-lahar lahar_nome_contato" type="text" id="campo_nome" value="">
<br>Email: <input class="api-lahar lahar_email_contato" type="text" id="campo_email" value="">
Obs: Clique aqui para ver a lista atualizada de campos disponíveis para integração (nome_campo_integracao).

2) adicione o campo hidden conforme o código abaixo para funcionando correto do lead tracking com os leads que converterem nesse formulário.

<input type="hidden" name="identificador_tracker_lahar" id="identificador_tracker_lahar" value="">

3) Se o campo que deseja integrar é um campo personalizado, você deve utilizar o token do campo para identificar na integração. Caso não saiba como encontrar esse token clique aqui.

Exemplo:

<br>Qual sua idade? <input class="api-lahar lahar_uNuQarKCor" type="text" id="campo_idade" value="">

Obs.: Se o campo personalizado for do tipo caixa suspensa, o valor informado na variável de tradução deve existir como uma das opções no campo personalizado.


4) Inserir o script abaixo em sua página antes da tag </body> e substituir as informações da seguinte maneira:

- ID_DO_FORMULARIO_COM_AS_INFOS: substituir pelo valor da propriedade id do <form> que contém os campos que serão utilizados na integração com a LAHAR

- TOKEN_DA_API_LAHAR_OBTIDO_EM_CONFIGURACOES: obter o token na área de Configurações da LAHAR

- NOME_DO_FORMULARIO_PARA_IDENTIFICACAO: nome que identificará a origem da conversão na LAHAR

- ENDERECO_REDIRECIONAMENTO: URL que será redirecionada após a conversão no formulário.


<script src="https://ajax.googleapis.com/ajax/libs/jquery/1.10.2/jquery.min.js"></script>
<script src="https://scripts.lahar.com.br/api_parametros.js" type="text/javascript"></script>
<script type="text/javascript">
    $(document).ready(function() {
        var integrou = false;
        $("#ID_DO_FORMULARIO_COM_AS_INFOS").submit(function() {
            if (!integrou) {
                efetua_integracao();
                integrou=true;
                return false;
            }
        })
    });
    function efetua_integracao() {
        var campos = { // Colocar aqui campos fixos ou enviar estas infos como hidden no formulário
            token_api_lahar: 'TOKEN_DA_API_LAHAR_OBTIDO_EM_CONFIGURACOES',
            nome_formulario: "NOME_DO_FORMULARIO_PARA_IDENTIFICACAO", // será o identificador da conversão na base de contatos
            identificador_tracker_lahar: $('#identificador_tracker_lahar').val(), // Remover esta linha caso não utilize o Tracking 
            url_origem: $(location).attr('href') // Alterar apenas se necessário
        };
        var elementos = [];
        $('.api-lahar').each(function(index,element){
            elementos.push(element);
        });
        integracao_js(campos, 'redireciona', elementos, 'conversions');  
    }
        function redireciona() { 
        var form = document.getElementById("ID_DO_FORMULARIO_COM_AS_INFOS");
        form.submit();
    }
</script>


Segue abaixo a relação dos retornos de erros da API:


  • 101 => 'Não foi possível enviar o email de notificação, porém o lead foi incluído com sucesso no ambiente.',                
  • 102 => 'Não é possível obter conversões via GET. Para inserir uma nova conversão, use POST.',
  • 103 => 'Não é possível obter o estágio dos leads via GET. Para atualizar o estágio do Lead, use PUT.',
  • 104 => 'Não é possível atualizar atividades dos leads via GET. Para atualizar as atividades do Lead, use PUT.',
    105 => 'Não é possível enviar emails do BPM via GET, use POST.',
  • 401 => 'Acesso não autorizado: Token não identificado.',
  • 404 => 'Erro imprevisto.',
  • 520 => 'O limite da cota de contatos foi excedido.',
  • 540 => 'Erro na inclusão do contato no banco de dados. O ambiente LAHAR está ativo?',
  • 541 => 'Erro na atualização de estágio do lead no banco de dados. O ambiente LAHAR está ativo?',
  • 550 => 'Nenhum campo recebido na requisição.',
  • 551 => 'Campo obrigatório recebido na requisição está duplicado.',
  • 552 => 'Envio não contempla os campos obrigatórios necessários. Envie em sua requisição, ao menos, os campos: <campos obrigatórios>',
  • 553 => 'Erro de validação de campo. O campo a seguir não está tratado: ' . $string_campos_obrigatórios,
  • 554 => 'Contato enviado não existe. O email enviado (' <email>') existe?',
  • 555 => 'Conversão via telefone não foi possível: nenhum contato identificado na base com o número informado',
  • 556 => 'A conversão não foi realizada pois o lead não deu o consentimento',
  • 557 => 'A conversão não foi realizada pois a categoria de nota é inválida. As categorias permitidas são: <campos obrigatórios>',
  • 600 => 'Parâmetros não fornecidos',
  • 601 => 'Estrutura dos parâmetros inconsistente',
  • 602 => 'Parâmetro "token" não fornecido',
  • 603 => 'Parâmetro "modelo" não fornecido',
  • 604 => 'Parâmetro "posição" não fornecido',
  • 605 => 'Parâmetro "destinatário" não fornecido',
  • 606 => 'Parâmetro "destinatário" inconsistente',
  • 607 => 'Parâmetro "dados" não fornecido',
  • 608 => 'Um dos pares do parâmetro "dados" está inconsistente',
  • 609 => 'Parâmetro "secret key" não fornecido',
  • 620 => 'Acesso inválido ou e-mail não existente'