O evento AJAX de envio de formulário serve para sincronizar no Connectif formulários integrados e enviar a notificação de "submit" para a ferramenta por meio de AJAX.
Como usar
O evento AJAX de "submit" utiliza o JavaScript do Connectif para enviar os dados do envio do formulário por meio do método sendEvents, realizando a seguinte chamada para o Connectif:
connectif.managed.sendEvents(events, options)
Obter o identificador do formulário
A propriedade formID identifica o formulário integrado.
Acesse o formulário integrado e localize o formID na URL.
Exemplo de evento onsubmit
O evento onsubmit captura o envio do formulário e executa a função sendForm, que envia os dados via AJAX.
O formulário terá este aspecto:
<form onsubmit = "sendForm()">
Email: <input type = "email" value = "" id= "email" /><br/>
Name: <input type = "text" value = "" id= "name" /><br/>
<input type = "submit" value = "Enviar" />
</form>
Exemplo de notificação de envio
A notificação terá este aspecto:
function sendForm() {
connectif.managed.sendEvents(
[
{
type: 'form-submitted',
eventId: 'ID_DO_FORMULÁRIO_INTEGRADO_DO_CONNECTIF',
primaryKeyField: 'email',
payload: {
'email': document.getElementById('email').value,
'name': document.getElementById('name').value,
}
}
]
) }
Se for um formulário de cadastro (que solicita o e-mail), é necessário incluir o campo "primaryKeyField", e seu valor será o nome do campo no payload, que conterá o e-mail enviado pelo formulário. Se o formulário não for do tipo cadastro, não é necessário indicar o campo "primaryKeyField".
Parabéns!
Você chegou ao final da lição.
Ficou com dúvidas?
Lembre-se que você pode contar com nossos especialistas em Connectif. Para entrar em contato, basta abrir um ticket de suporte clicando no botão azul “Ajuda” no seu painel.
RESOLUÇÃO DE INCIDENTES
O que acontece se o formulário não for detectado pelo Connectif? Existem alguns casos onde a ferramenta de Formulários Integrados do Connectif não consegue detectar formulários no seu site, por exemplo:
- O formulário está em uma página que exige autenticação.
- O formulário é construído de forma dinâmica via JavaScript.
Nesses casos, a opção recomendada é criar um evento de integração personalizada para receber dados no Connectif.
- Crie sua integração personalizada seguindo os passos deste artigo.
- Uma vez criada, vá para a aba Receber Dados e clique em Criar novo evento de recepção.
- Atribua um nome e defina os campos que serão enviados clicando em Adicionar novo campo.
- Clique em Salvar e volte para a lista de eventos da sua integração personalizada, onde estará o identificador do evento recém-criado:
- Copie o identificador para usá-lo no campo "eventId" do exemplo de código a seguir, para enviar a notificação deste evento ao Connectif:
connectif.managed.sendEvents(
[
{
type: 'custom',
eventId: 'ID_DO_EVENTO_PERSONALIZADO_DE_RECEPÇÃO',
payload: {
meu_campo_email: 'test@example.org',
meu_campo1: 1234,
nome: 'Teste',
campo2: 'Esta é uma prova'
}
}
]
)
Neste caso, não é necessário indicar um "primaryKeyField" dentro do evento, pois o campo da chave primária é definido no campo "meu_campo_email" do evento personalizado.
Continue aprendendo!
Para aproveitar ao máximo sua conta no Connectif, recomendamos continuar com os seguintes artigos:
- Adicionar o JavaScript do Connectif ao seu site, para inserir o código e começar a coletar informações sobre as visitas ao seu site.
- Integração por meio de tags, para conhecer todas as notificações que você pode enviar do seu e-commerce para o Connectif e seu funcionamento.
- Integração com Connectif via API, para sincronizar contatos, produtos, compras e cupons.
- Verificar a integração com o e-commerce, para garantir que todos os dados estão sendo sincronizados corretamente na sua conta do Connectif.