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