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'