El paso Transformar campo de contacto permite tomar un valor de un campo personalizado y guardarlo en otro, modificando su formato o estructura si es necesario.
Es útil cuando los datos llegan en un formato que no se puede usar directamente (fechas como texto, JSON de webhooks, arrays, etc.) y deben prepararse para mensajes, automatizaciones o plantillas.
Cuándo usar este paso #
Usa Transformar campo de contacto cuando necesites:
- Convertir una fecha escrita como texto en una fecha real
- Formatear una fecha para mostrarla en un mensaje
- Unir varios valores en un solo campo
- Extraer información de datos JSON recibidos de webhooks o integraciones
- Generar texto legible a partir de datos estructurados
Cómo configurar el paso #
1. Selecciona el campo de origen #
Elige el campo personalizado que contiene los datos que deseas transformar.
Nota:
Solo se pueden usar campos personalizados. Los campos estándar como Nombre, Email o Teléfono no están disponibles.
2. Selecciona el tipo de transformación #
Según el tipo de campo seleccionado, el sistema muestra las transformaciones disponibles.
Ejemplos:
- Texto → Fecha
- Fecha → Texto
- JSON → JSON
- JSON → Texto
El sistema sugiere automáticamente la opción más probable según el nombre del campo.
3. Configura la transformación #
Aquí defines:
- el formato de fecha
- el formato del texto de salida
- el mapeo JSON
- la plantilla de texto
Las opciones disponibles dependen del tipo de transformación elegido.
4. Selecciona el campo de destino #
Elige el campo donde se guardará el resultado de la transformación.
Nota:
Solo se muestran los campos compatibles con la transformación seleccionada.
Tipos principales de transformación #
Texto → Fecha #
Úsalo cuando una fecha está guardada como texto (por ejemplo 2024-12-31) y necesitas convertirla en una fecha real.
Puedes:
- seleccionar el formato exacto
- o usar la detección automática si el formato no es seguro
Recomendado para datos provenientes de integraciones externas.
Texto → Fecha y hora #
Similar al caso anterior, pero cuando el texto incluye fecha y hora.
Ejemplo:2024-12-31 14:30
Fecha → Texto #
Úsalo cuando quieres mostrar una fecha dentro de un mensaje o plantilla.
Ejemplo de salida:31/12/2024
En este caso, siempre debes elegir el formato de salida.
Fecha y hora → Texto #
Útil cuando necesitas mostrar fecha y hora en un formato fácil de leer.
JSON → JSON #
Se utiliza para reestructurar datos JSON complejos.
Permite:
- extraer propiedades específicas
- renombrar campos
- simplificar objetos o arrays
- combinar valores
JSON → Texto #
Úsalo cuando quieras generar texto legible a partir de datos JSON.
Ideal para:
- mensajes automáticos
- confirmaciones de pedidos
- resúmenes para el usuario
Cómo funciona el mapeo JSON (con tecnicismos útiles) #
El mapeo JSON utiliza referencias a los datos de entrada mediante la variable $input.
Acceso a propiedades #
Para leer un valor:
$input.nombre_campo
Para acceder a propiedades anidadas:
$input.customer.personal.first_name
Concatenación de valores #
Puedes unir varios valores en una sola cadena:
$input.first_name $input.last_name
Trabajo con arrays #
Si el JSON de entrada es un array, puedes usar un array con un solo elemento como plantilla.
El sistema aplicará la transformación automáticamente a cada elemento.
Propiedades con caracteres especiales #
Si un nombre de propiedad contiene espacios o caracteres especiales, usa la notación con corchetes:
$input['property-name']
$input['property with spaces']
Conversión a texto con .toString() #
El método .toString() convierte valores complejos en texto.
Comportamiento:
- Arrays → valores separados por comas
- Objetos → cadena JSON
- Otros tipos → conversión estándar
Ejemplo:
$input.tags.toString()
Esto es útil cuando necesitas guardar arrays u objetos en campos de texto para usarlos en mensajes.
Uso de datos de ejemplo #
Puedes añadir un JSON de ejemplo para:
- validar el mapeo
- previsualizar el resultado
- recibir sugerencias automáticas
Se recomienda probar siempre antes de activar la automatización.
Buenas prácticas #
- Usa nombres claros para los campos de origen y destino
- Prueba siempre con datos de ejemplo
- Si una propiedad no existe, el valor resultante estará vacío
- Divide transformaciones complejas en varios pasos
- Documenta el propósito de cada paso
Resumen #
El paso Transformar campo de contacto te permite preparar los datos para que sean:
- utilizables
- legibles
- compatibles con mensajes y automatizaciones
Es un paso clave cuando trabajas con integraciones, webhooks o datos estructurados.
