Como mapear os campos de um formulário capturado

Este how-to mostra como ativar um formulário já capturado pela Context Cloud e associar cada campo do formulário ao campo de cadastro correto, garantindo a identificação do contato. Com a captura de formulários ligada, o script da Inngage intercepta automaticamente todas as submissões do site e envia cada formulário para a plataforma; o mapeamento é o passo que transforma esses dados brutos em um contato identificado.

Antes de começar

• Script da Inngage instalado e ativo no site. É ele que intercepta as submissões.
• Captura de formulários ligada. Enquanto está ligada, toda submissão do site é capturada e enviada para a Context Cloud automaticamente, para ligar Configurações → Plataformas → Web Push.
• O formulário submetido ao menos uma vez. Um formulário só aparece na lista de formulários depois de ter sido capturado pelo menos uma vez. Sem isso, não há campos nem pré-visualização para mapear.

Passos

1. No painel, acesse Conteúdo > Formulários.
2. Veja a lista de todos os formulários capturados ao menos uma vez.
3. Se o formulário que você quer não estiver na lista, acesse a página desse formulário no site, preencha os dados e faça a submissão. Depois, volte a Conteúdo > Formulários — ele passará a aparecer.
4. Localize o formulário desejado e clique no botão (...).
5. Clique em Ativar formulário. A Context Cloud abre a lista de campos daquele formulário para mapeamento.
6. Para cada linha da lista, use a coluna Campo de cadastro para selecionar o campo da Inngage correspondente àquela coluna do formulário.
7. Associe obrigatoriamente o Identificador de usuário. Associe Telefone e E-mail conforme os canais que você pretende usar.

Estrutura da tabela de mapeamento

Ao ativar o formulário, os campos aparecem em uma lista com três colunas. Cada coluna tem uma função:

Use a coluna Pré-visualização para confirmar que está associando a coluna certa: ela mostra o valor real que veio do primeiro preenchimento (por exemplo, um e-mail ou um telefone), o que ajuda a identificar campos com labels ambíguos.

Campos de cadastro disponíveis

O seletor Campo de cadastro oferece os campos abaixo para associação. Só o Identificador de usuário é obrigatório; os demais dependem dos canais que você pretende usar:

Exemplo de mapeamento

Para um formulário com os campos "E-mail" e "Celular", o mapeamento associando cada coluna ao campo de cadastro correto fica assim:

Nesse exemplo, o e-mail foi usado como Identificador de usuário (o campo obrigatório) e o celular foi associado a Telefone, para habilitar campanhas de SMS, WhatsApp e RCS para esse contato.

Como validar

Depois de associar os campos, os contatos capturados por esse formulário passam a ser identificados na Context Cloud pelo Identificador de usuário definido, com telefone e e-mail preenchidos conforme o mapeamento. Uma nova submissão do formulário no site deve gerar um contato já identificado e com os campos associados populados.

Problemas comuns

• O formulário não aparece em Conteúdo > Formulários → ele ainda não foi capturado nenhuma vez → acesse a página do formulário, faça uma submissão e volte à lista.
• Contatos capturados sem telefone ou e-mail → a coluna correspondente não foi associada no mapeamento → volte ao formulário, clique em (...) > Ativar formulário e associe Telefone e/ou E-mail.
• Contato não é identificado → o Identificador de usuário não foi associado → a associação desse campo é obrigatória; sem ela o contato não é reconhecido.