Loading

Solución de problemas de los controladores de formularios

Fecha de publicación: Sep 30, 2025
Descripción
Los controladores de formularios le permiten gestionar los formularios manualmente y publicar los datos en Pardot. Esto le permite personalizar por completo el aspecto de su formulario y seguir usando Pardot para supervisar los envíos de formularios. Si desea instrucciones sobre cómo implementar un controlador de formulario, consulte esta documentación
Solución

Discrepancia en la asignación de campos
Faltan campos obligatorios
Discrepancia en el tipo de campo
Codificación de caracteres
Atributo enctype incorrecto
Envío mediante Ajax
Falta de URL de referencia
Error en envío
Seguimiento de visitantes
Múltiples envíos duplicados
Estado o país idéntico para clientes potenciales enviados
Envíos
del lado de servidor

 

Discrepancia en la asignación de campos

El nombre de campo externo que se introduzca en el controlador de formulario de Pardot debe coincidir con el atributo name= de la etiqueta <input> del código HTML de su formulario original. Las asignaciones de campo distinguen mayúsculas y minúsculas.

Por ejemplo, si el código de su formulario de sitio web es

<label for=”first”>Nombre</label> <input name=“first” type=”text” id=“first” /><br />
 

Compruebe en su controlador de formulario de Pardot que el nombre de campo externo es "first", y coincide con el valor de "input name".

 

Faltan campos obligatorios

Todos los campos marcados como obligatorios en Pardot deben incluirse en el envío. Los envíos que no tengan completados todos los campos obligatorios generarán un error. Personalice el mensaje de error de su controlador de formulario para cada campo, de modo que pueda ver qué campos están generando errores. Puede personalizar los mensajes de error siguiendo estos pasos:

1. Modifique su controlador de formulario.
2. Haga clic en el icono de lápiz junto a cada asignación de campo.
3. Haga clic en la ficha Avanzado.
4. Modifique el texto de Mensaje de error.
5. Haga clic en Guardar cambios.
6. Repita los pasos para cada campo del formulario.
7. Cuando haya acabado, haga clic en Guardar controlador de formulario.
 

Discrepancia en el tipo de campo

Los datos enviados deben coincidir con el tipo de campo seleccionado. Por ejemplo, si se envía un número de teléfono que incluya caracteres como guiones y paréntesis a un controlador de formulario, provocaría un error si el campo se asigna a un campo con el tipo de campo número. Personalice el mensaje de error de su controlador de formulario para cada campo, de modo que pueda ver qué campos están generando errores. Puede personalizar los mensajes de error siguiendo estos pasos:

1. Modifique su controlador de formulario.
2. Haga clic en el icono de lápiz junto a cada asignación de campo.
3. Haga clic en la ficha Avanzado.
4. Modifique el texto de Mensaje de error.
5. Haga clic en Guardar cambios.
6. Repita los pasos para cada campo del formulario.
7. Cuando haya acabado, haga clic en Guardar controlador de formulario.

 

Codificación de caracteres

Los caracteres especiales de valores de campo enviados, como $, &amp;, %, (), + – deben codificarse en URL si el formulario envía datos al controlador de formulario agregando valores y nombres de campo a la URL de extremo del controlador de formulario (como con el método de iframe oculto). Los caracteres no deben estar codificados si el formulario envía datos al controlador de formulario de la manera normal (mediante publicación de formulario).
 

Atributo enctype incorrecto

Los controladores de formulario de Pardot solo pueden integrarse con formularios mediante un atributo enctype vacío o un enctype de application/x-www-form-urlencoded. Pardot no acepta un enctype de multipart/form-data.
 

Envío mediante Ajax

Pardot no admite el envío de datos a controladores de formulario mediante solicitudes Ajax. Cuando intente enviar datos a un controlador de formulario mediante Ajax, es posible que vea errores como los siguientes:
XMLHttpRequest no puede cargar {www.sitio.com/URLControladorFormulario}. No hay ningún encabezado 'Access-Control-Allow-Origin' en el recurso solicitado. Por tanto, el origen '{página desde la que debería enviarse el controlador de formulario en el sitio web del cliente}' no tiene permiso de acceso.
Esto es lo que conocemos como el uso compartido de recursos entre orígenes (CORS). En estos momentos Pardot no admite CORS ni JSONP para los controladores de formulario. Es posible simular una respuesta JSONP configurando las URL de error y operación correcta del controlador de formulario para que sean URL de JavaScript que ejecuten devoluciones de llamada de error y operación correcta, respectivamente.
 

Falta de URL de referencia

En función de cómo se cargue la URL, puede que no haya una URL de referencia a la que enviar los datos. En ese caso, puede definir la ubicación de operación correcta para el controlador de formulario como una URL explícita. Si está usando el formulario en múltiples ubicaciones y necesita restablecer la ubicación de operación correcta o reenvío según el origen del formulario, los controladores de formulario también pueden aceptar "success_location" y "error_location" como parámetros de URL, lo que sobrescribiría los ajustes de ubicación de error u operación correcta almacenados en el controlador de formulario.
 

Error en envío

Los controladores de formulario de Pardot no pueden recibir datos que no se hayan enviado correctamente. Compruebe que su formulario o sistema podrá enviar datos y que envía la URL de extremo de controlador de formulario correcta.
 

Seguimiento de visitantes

Los controladores de formulario configurados en modo kiosko evitan que Pardot establezca una cookie en el navegador del visitante, por lo que la actividad de este no se supervisará. El envío a controladores de formulario mediante envíos en el lado del servidor también impide que Pardot coloque una cookie en el navegador del usuario y supervise su actividad. Para realizar un seguimiento de los visitantes en cualquiera de esos casos, consulte este artículo sobre formas de asociar el registro del visitante con el registro de cliente potencial:
▸▸ https://help.salesforce.com/articleView?id=000318305&type=1&mode=1
 

Múltiples envíos duplicados

A veces, aunque una persona solo haya enviado un formulario externo una vez, se muestran múltiples envíos de controlador de formulario del mismo controlador de formulario en la tabla de actividades de ese cliente potencial, o se muestran múltiples filas "Acciones de finalización activadas" para el controlador de formulario en las auditorías del cliente potencial. 
 
Esto suele pasar cuando el servidor de un formulario externo publica varias veces en la URL de extremo del controlador de formulario de Pardot. Como Pardot no tiene control sobre el número de veces que un envío de formulario se ha publicado en el controlador de formulario, los administradores de Pardot deben colaborar con el equipo que gestiona o presta asistencia al formulario externo para resolver este problema. La clave para resolverlo es identificar el motivo por el que el formulario se publica múltiples veces en la URL del extremo del controlador de formulario de Pardot.
 

Estado o país idéntico para clientes potenciales enviados

Si su cuenta tiene activado el ajuste Cumplimentar automáticamente datos de ubicación de cliente potencial desde la dirección IP, todos los clientes potenciales que tengan un envío correcto de controlador de formulario pueden mostrar el mismo estado o país en el registro de cliente potencial. Esto ocurre cuando el controlador de formulario se envía con un envío del lado de servidor, que es cuando un formulario envía a un servidor externo que publica en un controlador de formulario de Pardot. En el caso de un envío del lado del servidor, Pardot solo recibe la dirección IP del servidor externo que reenvía el envío de formulario a los controladores de formulario de Pardot, lo que significa que la dirección IP de cada envío es idéntico en todos los clientes potenciales.

Puede resolver este problema realizando una de las siguientes operaciones:

1. Activar el modo kiosko en su controlador de formulario; el país y estado de la dirección IP de los clientes potenciales no se adjuntarán cuando el modo kiosko esté activado. 
2. Desactive el ajuste Cumplimentar automáticamente datos de ubicación de cliente potencial desde la dirección IP.
3. Envíe los datos de formularios externos directamente al controlador de formulario de Pardot (envío del lado de cliente) en lugar de publicarlo desde un servidor externo (envío del lado de servidor).
4. Utilice un formulario de Pardot en lugar de un controlador de formulario.

Envíos del lado del servidor

Si su formulario realiza un envío del lado del servidor, consulte este artículo para obtener más información:
▸▸ https://help.salesforce.com/articleView?id=000322102&type=1&mode=1

Número del artículo de conocimiento

000383081

 
Cargando
Salesforce Help | Article