Loading
Marketing Cloud Siguiente
Conectar un formulario externo a un gestor de formularios

Usted está aquí:

  1. Ayuda de Salesforce
  2. Documentos
  3. Marketing Cloud Siguiente

Conectar un formulario externo a un gestor de formularios

Después de crear y publicar un gestor de formularios, configure su formulario externo para enviar datos a Salesforce.

Ediciones necesarias

Ver ediciones compatibles.

Permisos de usuario necesarios
Para crear un gestor de formularios:

Conjunto de permisos Gestor de Marketing Cloud

Y

Cualquier función de colaborador de espacio de trabajo de CMS
Para publicar un gestor de formularios:

Conjunto de permisos Gestor de Marketing Cloud

Y

Una función de colaborador de espacio de trabajo de CMS de administrador de contenido o gestor de contenido
Para configurar la lista de admisión de CORS: Modificar todos los datos

Antes de completar estos pasos, cree y publique un gestor de formularios.

Existen dos formas de enviar datos desde su formulario a Salesforce. Seleccione el tipo de conexión que mejor se adapte a la estructura y funciones de su sitio.

  Cortejo de JavaScript (lado del cliente)

URL POST directa (lado del servidor)
Cómo funciona Una secuencia de comandos en su página envía datos de formulario a Salesforce cuando un visitante envía el formulario. Su formulario publica datos directamente en una URL de Salesforce, sin secuencia de comandos en la página.
Agregar a su sitio Una etiqueta <script> y atributos de formulario que pega en el HTML de su página. URL que establece como la acción para su destino de formulario o webhook.
Ideal para Páginas donde controla el HTML y puede agregar secuencias de comandos. Generadores de formularios externos que no permiten secuencias de comandos personalizadas, páginas con reglas estrictas de Política de seguridad de contenidos (CSP) y formularios que publican desde un servidor backend.
Admite el seguimiento web Sí No
Admite la resolución de identidad Sí No
Requiere una entrada de lista de admisión de CORS Sí Sí

Ambos métodos envían datos al mismo gestor de formularios y desencadenan el mismo flujo. Ambos métodos también requieren que autorice su dominio en la Lista de admisión de CORS.

Con cualquier tipo de conexión, asegúrese de que cada campo de su formulario utiliza un atributo de name HTML que coincida exactamente con el nombre del campo externo correspondiente en el controlador de formulario. Si los nombres no coinciden, el controlador de formularios no captura el valor. Por ejemplo, si asignó el email_address de nombre de campo externo al campo Email, el atributo name para el campo correspondiente en el formulario también debe ser email_address.

Opción 1: Configurar su formulario para utilizar una conexión del lado del cliente

Utilice este método cuando controle el HTML de su página y pueda agregarle una secuencia de comandos. Como la secuencia de comandos se ejecuta en el navegador del visitante, este método admite el seguimiento web y la resolución de identidad. Como resultado, este método puede conectar un envío de formulario con la actividad web de un visitante.

  1. Publique el controlador de formularios.
  2. En la ficha Fragmento de código, bajo Gestor de formularios del lado del cliente, copie la secuencia de comandos de seguimiento. La secuencia de comandos se parece a este ejemplo. 
    <script async src="https://YOUR_DOMAIN/lp/assets/scripts/external-form-handler-host.min.js" onload="SFDCFormHandler.init('https://YOUR_DOMAIN/lp')"></script>
  3. En el código HTML del sitio, pegue la secuencia de comandos antes de la etiqueta </body> de cierre.
  4. En la ficha Fragmento de código, copie los atributos del formulario. Los atributos se parecen a este ejemplo. 
    <form id="CONTENT_KEY" data-uma-forms="true"></form>
  5. En su HTML, agregue los atributos id y data-uma-forms a la etiqueta <form>.
  6. Confirme que el atributo name HTML de cada campo de formulario coincide con el nombre del campo externo asignado.
  7. Agregue el dominio que aloja su formulario a la lista de admisión de CORS. Este paso autoriza a su dominio a enviar envíos a Salesforce.
  8. Para supervisar la implicación de los usuarios, active el seguimiento web.

Cuando un visitante envía el formulario, la secuencia de comandos envía los datos a Salesforce, y el gestor de formularios procesa el envío y desencadena su flujo. El gestor de formularios los redirige a la URL de operación correcta o error que configuró.

Opción 2: Configurar su formulario para utilizar una conexión del lado del servidor

Utilice una conexión del lado del servidor cuando no pueda agregar código a su página o realizar configuraciones personalizadas en su código. Con este método, el gestor de formularios le proporciona una URL de destino y configura el formulario para enviar sus datos a esa URL. Como no incrusta una secuencia de comandos, este método funciona con herramientas de formulario que no permiten JavaScript personalizado. Este método también es útil con páginas que tienen reglas estrictas de Política de seguridad de contenidos (CSP) y con formularios que se envían desde un servidor backend.

  1. En la ficha Fragmento de código para el controlador de formularios, bajo Gestor de formularios del lado del servidor, copie la URL de acción de formulario. La URL se parece a este ejemplo. 
    https://YOUR_DOMAIN/lp/cms/form/submit/v1/CONTENT_KEY
  2. Configure el formulario para enviar los datos a Salesforce. Los pasos de implementación dependen de cómo implemente su formulario.
    Si utiliza un generador de formularios o complemento externo En la configuración de la herramienta externa, busque el campo para configurar la acción del formulario, la URL posterior o el destino de webhook. Introduzca la URL de Salesforce en ese campo.
    Si puede modificar el HTML pero no puede agregar una secuencia de comandos Establezca el atributo action de su etiqueta <form> en la URL de Salesforce y establezca el atributo method en POST.
    Si su formulario utiliza un proceso backend Envíe una solicitud POST a la URL de Salesforce con los datos del formulario, con codificación application/x-www-form-urlencoded.
  3. Confirme que el nombre de cada campo coincide exactamente con el nombre del campo externo asignado.
    El gestor de formularios captura campos solo cuando coinciden exactamente.
  4. Agregue el dominio que aloja su formulario a la lista de admisión de CORS. Este paso autoriza a su dominio a enviar envíos a Salesforce.

Configurar la lista de admisión de CORS

Ambos métodos de conexión requieren que autorice su dominio antes de que Salesforce acepte envíos de formularios. Si no autoriza su dominio, Salesforce bloquea el envío antes de que se procese. Para autorizar su dominio, agréguelo a la lista de admisión de CORS.

  1. Identifique el dominio que aloja el formulario, como https://www.example.com. Para autorizar todos los subdominios, utilice un comodín, como https://*.example.com.
  2. Agregue el dominio a la lista de admisión de CORS.

Probar el formulario

Después de conectar su formulario con el controlador de formularios, pruébelo para asegurarse de que se comporta del modo esperado.

  1. En el formulario, envíe una entrada de prueba y confirme que se le envió a la URL correcta.
  2. En Salesforce, compruebe si se creó o se actualizó un registro correspondiente a la entrada de prueba.
    Sugerencia
    Sugerencia Si un registro no se crea o se actualiza después de enviar una entrada de prueba, confirme que el atributo name de cada campo de formulario coincide con un nombre de campo externo. Si el gestor de formularios está conectado a un flujo, confirme que el flujo se completa sin errores.
 
Cargando
Salesforce Help | Article