Campos Ocultos: Paso de Datos Silencioso para IntakeBots

Los campos ocultos permiten adjuntar datos a un envío de IntakeBot sin que el respondiente vea o conteste nada. El campo existe en el esquema, su valor se guarda, y puede controlar la lógica condicional, las reglas de enrutamiento y el mapeo de contactos. Simplemente no aparece en la conversación.

Esto es útil cuando tu sistema ya sabe algo sobre la persona (un ID de CRM, una fuente de campaña, un nivel de cuenta) y quieres que ese dato viaje con el envío automáticamente.

Los campos ocultos requieren un plan Pro o Business.

Cómo funciona

Cualquier campo en tu IntakeBot puede marcarse como oculto. Cuando lo haces, tres cosas cambian:

1. El campo desaparece de la vista del respondiente
2. Una insignia violeta aparece en el editor para indicar que está oculto
3. El panel de publicación y el código embed se actualizan para mostrar los parámetros de campos ocultos

El campo sigue funcionando como cualquier otro. Valida, mapea a contactos, activa lógica condicional y aparece en los datos del envío. La única diferencia es que nadie lo llena manualmente.

Fuentes de valores

Los campos ocultos obtienen sus valores de tres lugares. Si múltiples fuentes proporcionan un valor para el mismo campo, los atributos de embed tienen prioridad sobre los parámetros de URL, que tienen prioridad sobre los valores predeterminados.

Atributos de embed

Configura valores directamente en tu código embed usando el atributo data-fields. Funciona con los modos de embed inline, popup y widget.

<div
  data-iozen-bot="your-bot-id"
  data-fields='{"campaign":"spring2026","source":"landing-page"}'
></div>

Si estás embebiendo desde una app dinámica (React, Next.js, etc.), puedes construir el objeto data-fields desde el estado de tu aplicación.

Parámetros de URL

Agrega ?f.key=value a cualquier enlace directo de IntakeBot. Funciona bien para campañas de email, enlaces de anuncios y cualquier lugar donde controles la URL.

https://app.iozen.ai/b/your-bot-id?f.source=google&f.ref=abc123&f.campaign=summer

Múltiples parámetros se apilan con &. Los valores se decodifican automáticamente.

Valores predeterminados

Configura un valor por defecto en el editor de campos que aplica a cada envío. Útil para valores que no cambian entre respondientes, como un nombre de departamento o un código de región.

Los valores predeterminados actúan como respaldo. Si un atributo de embed o parámetro de URL proporciona un valor, el predeterminado se ignora.

Casos de uso

Vinculación con registros de CRM

Pasa un ID de registro desde tu app al IntakeBot para que cada envío se vincule al registro correcto. Sin búsquedas manuales, sin errores de copiado.

<div
  data-iozen-bot="your-bot-id"
  data-fields='{"crm_record_id":"rec_8xK2mP"}'
></div>

Reenvío de UTM y atribución

Lleva los parámetros UTM desde tu landing page al envío. Combinado con el seguimiento de atribución, esto te da visibilidad completa desde el clic en el anuncio hasta el envío.

https://app.iozen.ai/b/your-bot-id?f.utm_source=google&f.utm_medium=cpc&f.utm_campaign=brand

Pruebas A/B

Configura un identificador de variante como campo oculto y ramifica la lógica condicional de tu IntakeBot en base a él. Diferentes variantes ven diferentes preguntas, bloques de contenido o CTAs.

<!-- Variante A -->
<div data-iozen-bot="your-bot-id" data-fields='{"variant":"A"}'></div>

<!-- Variante B -->
<div data-iozen-bot="your-bot-id" data-fields='{"variant":"B"}'></div>

Luego agrega lógica condicional: muestra el campo X cuando variant es igual a A, muestra el campo Y cuando variant es igual a B.

Rastreo de referencia

Registra de dónde viene un respondiente sin preguntarle. Útil para programas de socios, enrutamiento interno o intake multicanal.

https://app.iozen.ai/b/your-bot-id?f.referrer=partner-acme&f.channel=slack

Pre-llenado desde tu app

Cuando ya sabes cosas sobre el usuario (su nivel de cuenta, su región, su representante asignado), pásalas como campos ocultos. El envío llega completo sin que el respondiente tenga que reingresar información que tu sistema ya tiene.

Configurando un campo oculto

1. Abre tu IntakeBot en el editor
2. Selecciona el campo que quieres ocultar (o crea uno nuevo)
3. Haz clic en el botón de visibilidad en el panel de configuración del campo
4. El campo cambia a oculto y muestra una insignia violeta
5. Opcionalmente configura un valor predeterminado en la configuración del campo
6. Publica el IntakeBot y toma el código embed o enlace directo actualizado

El panel de publicación muestra todos los campos ocultos y sus nombres de parámetro para que puedas construir tu código embed o URL correctamente.

Lógica condicional con campos ocultos

Los campos ocultos funcionan con la lógica condicional igual que los campos visibles. Puedes:

• Mostrar u ocultar otros campos según el valor de un campo oculto
• Mostrar diferentes bloques de contenido dependiendo de una variante o fuente
• Enrutar envíos a través de diferentes etapas de flujo de trabajo basándote en datos ocultos

Esto es particularmente útil para pruebas A/B e intake multicanal donde el mismo IntakeBot sirve a diferentes audiencias.

Control de acceso por plan

Los campos ocultos están controlados tanto a nivel de cliente como de servidor:

• Lado del cliente: El toggle de visibilidad, el panel de publicación y la generación de código embed requieren Pro o Business. Los usuarios del plan Free ven la opción pero no pueden activarla.
• Lado del servidor: Los envíos desde planes Free tienen los valores de campos ocultos eliminados antes de guardarse. Actualizar a Pro o Business restaura la funcionalidad completa de campos ocultos.

Siguientes pasos

• Guía de IntakeBots: Panorama completo de funcionalidades de IntakeBot
• Atribución de marketing: Rastrea conversiones de principio a fin
• Enrutamiento de flujo de trabajo: Enruta envíos según valores de campos
• Documentación de API: Detalles de implementación de códigos de embed