Web To Lead

21/12/2015 by Valdir

Filed under Documentação Integração

Last modified 15/02/2016

Identificação de contatos via formulário

Crie seus próprios formulários dentro do seu site para capturar contatos e envie diretamente para a Jeenga.

Todos os atributos de contatos da Jeenga podem ser enviados com o uso do formulário. Inclusive atributos dinâmicos. (Ver Exemplo 1).
É possível enviar um evento junto com o mesmo formulário. (Ver Exemplo 2).

Endpoint: https://api.jeenga.com/jeenga-api/form/customer
Método HTTP: post

Parâmetros obrigatórios

j_apikey É a chave de identificação fornecida pela Jeenga (Encontrada no seu menu Integrações da plataforma Jeenga).
identifier ID único do Cliente (ele é responsável também por marcar seu contato como um cliente).
redirect_to URL para o qual o usuário deve ser redirecionado após o envio do formulário.

Exemplo 1: Envio de nome, e-mail e um atributo dinâmico

<form name="jeengaForm" action="https://api.jeenga.com/jeenga-api/form/customer" method="post" onsubmit="jeengaForm.identifier.value=jeengaForm.email.value">
	<input type="hidden" name="j_apikey" value="xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx" /><!-- required -->
	<input type="hidden" name="identifier" /><!-- required -->
	<input type="hidden" name="redirect_to" value="http://www.your-web-site-here.com?your-parameter=ok" /><!-- required -->
	<table>
		<tr>
			<td>Nome</td>
			<td><input type="text" name="name" /></td>
		</tr>
		<tr>
			<td>E-mail</td>
			<td><input type="text" name="email" /></td>
		</tr>
		<tr>
			<td>Atributo Dinâmico 1</td>
			<td><input type="text" name="atributo_dinamico_1" /></td>
		</tr>
		<tr>
			<td></td>
			<td><input type="submit" /></td>
		</tr>
	</table>
</form>

Exemplo 2: Envio de nome, e-mail e um evento.

<form name="jeengaForm" action="https://api.jeenga.com/jeenga-api/form/customer" method="post" onsubmit="jeengaForm.identifier.value=jeengaForm.email.value">
	<input type="hidden" name="j_apikey" value="xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx" /><!-- required -->
	<input type="hidden" name="identifier" /><!-- required -->
	<input type="hidden" name="redirect_to" value="http://www.your-web-site-here.com?your-parameter=ok" /><!-- required -->
	<input type="hidden" name="activity.event" value="Registrated" />
	<input type="hidden" name="activity.module" value="Registration" />
	<input type="hidden" name="activity.channel" value="Site" />
	<table>
		<tr>
			<td>Nome</td>
			<td><input type="text" name="name" /></td>
		</tr>
		<tr>
			<td>E-mail</td>
			<td><input type="text" name="email" /></td>
		</tr>
		<tr>
			<td></td>
			<td><input type="submit" /></td>
		</tr>
	</table>
</form>

Redirecionamento após o envio

Após o envio do formulário, o usuário será redirecionado para a URL fornecida através do parâmetro “redirect_to”.
Parâmetros de status são retornados via queryString para a URL de retorno, são eles:

j_status Status da operação (0: OK, 1: Customer inserido mas problemas na inserção da atividade, -1: Erro).
j_message Em caso de j_status não OK, uma mensagem explicativa sobre o problema.

Baixar um arquivo de exemplo: Integração via Formulário

Leave a Comment