Você está aqui:
Usar um manipulador de formulário para atualizar objetos do Salesforce com dados de formulário
Use um manipulador de formulário para capturar dados de um formulário em um site externo e usar esses dados para criar ou atualizar registros no Salesforce. Os manipuladores de formulário tornam possível usar os formulários existentes em seu site sem atualizar seu site para usar formulários criados no Salesforce. Ao criar um manipulador de formulário, você especifica os nomes de campo no formulário existente e os campos do Salesforce para os quais ele é mapeado.
Edições obrigatórias
| Permissões de usuário necessárias | |
|---|---|
| Para criar um manipulador de formulário: | Conjunto de permissões de Gerente do Marketing Cloud E Qualquer papel de colaborador de espaço de trabalho do CMS |
| Para publicar um manipulador de formulário: | Conjunto de permissões de Gerente do Marketing Cloud E Um papel de colaborador de espaço de trabalho do CMS de administrador ou gerente de conteúdo |
Ao criar um manipulador de formulário, você também cria uma fonte de dados no Data 360. Essa fonte de dados armazena os dados que o formulário captura. Antes de criar um manipulador de formulário e uma fonte de dados correspondente, pense em como estruturar melhor os dados que o formulário captura. Há dois padrões gerais para projetar a estrutura de dados: nomes de campo explícitos e nomes de campo genéricos.
Em uma fonte de dados que usa nomes de campo explícitos, especifique cada nome de campo no modelo de dados. Essa estrutura é fácil de entender, mas exige modificar o objeto sempre que você adicionar um campo. Um modelo de dados com uma estrutura explícita é semelhante a este exemplo.
| Nome do campo | Tipo |
|---|---|
| Primeiro nome | Texto |
| Sobrenome | Texto |
| Texto | |
| Endereço | Texto |
| Occupation | Texto |
| ... | ... |
Como alternativa, uma fonte de dados pode usar nomes de campo genéricos ou, mais frequentemente, uma combinação de nomes de campo explícitos e genéricos. Essa abordagem oferece mais flexibilidade, permitindo que você manipule novos nomes de campo sem modificar o objeto. No entanto, os nomes de campo genéricos são ambíguos e exigem o uso de metadados para descrever os atributos na carga útil. Um modelo de dados com uma estrutura genérica é semelhante a este exemplo.
| Nome do campo | Tipo |
|---|---|
| Primeiro nome | Texto |
| Sobrenome | Texto |
| Texto | |
| Atributo1 | Texto |
| Atribute2 | Texto |
| Atribute3 | Texto |
| ... | ... |
Criar um manipulador de formulário
- Na guia Conteúdo, selecione um espaço de trabalho de conteúdo no qual criar o manipulador de formulário.
- Clique em Adicionar | Conteúdo .
- Na janela Criar conteúdo do CMS, selecione Manipulador de formulários e clique em Criar.
-
No canto superior esquerdo da janela, ao lado de Sem título, clique no ícone de lápis (
). Insira um nome para o manipulador do formulário.
-
Adicione uma fonte de dados.
- No painel à direita, em Fonte de dados, clique em Adicionar fonte de dados.
- Insira um nome para a fonte de dados.
- Para Tipo, selecione Registro do Salesforce.
- Para Objeto, selecione o tipo de registro no qual o manipulador de formulário opera. Por exemplo, para atualizar registros de Contato, selecione Contato.
- Salve suas alterações.
-
Mapeie os campos do formulário.
- No painel à esquerda, clique em um campo para capturar no formulário e arraste-o para o centro da página. Por exemplo, selecione o objeto Contato se o formulário coletar informações sobre o Primeiro nome, o Sobrenome ou o Endereço de email do usuário. Repita essa etapa para cada campo com o qual os dados do formulário interagem.
- No centro da página, clique em um dos nomes de campo adicionados. Em seguida, no painel à direita, insira um nome de campo externo. Repita essa etapa para todos os campos selecionados.
O nome do campo externo é o link entre o formulário do seu site e o Salesforce. Ele conecta cada campo no formulário ao campo do Salesforce que armazena o valor enviado. Lembre-se destes requisitos ao especificar os campos a serem capturados:
- O nome do campo externo inserido deve corresponder exatamente ao atributo de nome HTML do campo no seu formulário.
- Os valores de data usam o formato
YYYY-MM-DD. - Os valores de hora usam o formato
hh:mm:ss. - Os valores de DateTime usam o formato
YYYY-MM-DDTHH:mm:ss.sssZ(formato ISO 8601). - Para valores de caixa de seleção, se a caixa de seleção estiver marcada no formulário, o Salesforce a registrará como
trueno objeto.
- Salve suas alterações.
Para obter informações sobre como atualizar seu site para lidar com envios de formulário com segurança, consulte a Documentação do desenvolvedor: Integrar envios de formulário com a API do Connect.
Adicionar proteção contra spam a um manipulador de formulário (opcional)
Proteja-se contra hackers e spam adicionando um campo de mel oculto ao seu formulário. Quando um bot tenta enviar um formulário, ele geralmente preenche todos os campos no formulário, incluindo campos ocultos. Se você incluir um campo de medre no formulário, o manipulador de formulário bloqueará todos os envios que incluem um valor nesse campo.
- No painel Campos de proteção contra spam, adicione o campo Honeypot.
-
Para Nome do campo externo, insira um nome de campo a ser usado para a panela de mel.
Dica Os bots tentam explorar campos de formulário que permitem aos usuários inserir texto livremente. Eles pesquisam campos com rótulos genéricos, comocompany,websiteoufax. Insira um nome que torne o campo de panela de mel um destino atraente, mas que não se sobreponha aos dados a serem capturados no formulário. Não use um nome óbvio, comohoneypotoudo_not_fill. - No HTML do formulário, adicione um campo de entrada oculto com o atributo de nome correspondente.
Automatizar ações com um fluxo
Para automatizar tarefas como criar leads ou enviar emails depois que um usuário envia um formulário, conecte um fluxo ao manipulador de formulário. Na seção Fluxo do manipulador de formulário, clique em Novo fluxo para abrir o Flow Builder.
Quando você cria um fluxo usando a página do manipulador de formulário, os nomes de campo externos especificados estão disponíveis como recursos no fluxo. Use os valores desses campos externos em etapas de decisão de fluxo, para personalizar o conteúdo da mensagem e em outras ações de fluxo. Use também esses recursos para modificar qualquer objeto, não apenas o objeto selecionado ao criar o manipulador de formulário.
Configurar redirecionamentos de envio
Na seção Redirecionamento de envio, insira os URLs completos para os quais enviar os usuários quando um envio de formulário for bem-sucedido ou falhar.
Publicar o manipulador de formulário
Publique o manipulador de formulário para gerar o código que conecta o formulário do site ao Salesforce.
- Quando estiver pronto para publicar o formulário e seu fluxo, clique em Publicar.
- Ative o rastreamento da Web para monitorar o engajamento do usuário.
Depois de publicar, o manipulador de formulário gera o código que você usa para configurar seu formulário para enviar dados ao manipulador de formulário.
