Loading
Marketing Cloud Next
Usar um manipulador de formulário para atualizar objetos do Salesforce com dados de formulário

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

Exibir edições com suporte.

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
Email 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
Email Texto
Atributo1 Texto
Atribute2 Texto
Atribute3 Texto
... ...

Criar um manipulador de formulário

  1. Na guia Conteúdo, selecione um espaço de trabalho de conteúdo no qual criar o manipulador de formulário.
  2. Clique em Adicionar | Conteúdo .
  3. Na janela Criar conteúdo do CMS, selecione Manipulador de formulários e clique em Criar.
  4. No canto superior esquerdo da janela, ao lado de Sem título, clique no ícone de lápis (Um lápis, indicando um campo ou configuração que você pode editar). Insira um nome para o manipulador do formulário.
  5. Adicione uma fonte de dados.
    1. No painel à direita, em Fonte de dados, clique em Adicionar fonte de dados.
    2. Insira um nome para a fonte de dados.
    3. Para Tipo, selecione Registro do Salesforce.
    4. Para Objeto, selecione o tipo de registro no qual o manipulador de formulário opera. Por exemplo, para atualizar registros de Contato, selecione Contato.
    5. Salve suas alterações.
  6. Mapeie os campos do formulário.
    1. 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.
    2. 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 true no objeto.
  7. 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.

Nota
Nota Campos de Cevada de mel são um componente de uma estratégia eficaz de prevenção de spam, mas não devem ser o único componente usado. Considere a utilização de outras medidas antiabuso, incluindo reCAPTCHA.
  1. No painel Campos de proteção contra spam, adicione o campo Honeypot.
  2. Para Nome do campo externo, insira um nome de campo a ser usado para a panela de mel.
    Dica
    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, como company, website ou fax. 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, como honeypot ou do_not_fill.
  3. 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.

Importante
Importante

Adicione e mapeie todos os campos necessários antes de criar um fluxo. Se você editar os campos depois de adicionar o fluxo, o fluxo não refletirá as alterações automaticamente. Novas versões do fluxo incluem os mapeamentos atualizados.

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.

Nota
Nota

Se seu formulário usar reCAPTCHA, gere e envie o token necessário com o envio do formulário.

  1. Quando estiver pronto para publicar o formulário e seu fluxo, clique em Publicar.
  2. 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.

 
Carregando
Salesforce Help | Article