Ir al contenido principal

Cómo resolver warnings y errores en el Field Mapping en Salesforce

Al configurar el mapeo de campos en tu integración de Salesforce, cada campo mapeado muestra un icono de estado que indica si el mapeo es seguro. Revísalos antes de guardar para evitar errores en la exportación.

Para acceder al Field Mapping, ve a Integrations → Salesforce → Configure → Step 2: Field Mapping.

Important: Salesforce requiere que los tipos de campo coincidan exactamente. Cada mapping debe usar el tipo de campo correcto; de lo contrario el export fallará.


Qué significa cada icono

Icono

Estado

Qué significa

✓ Azul

Compatible

Los tipos de campo coinciden. No hay ninguna acción necesaria.

! Amarillo

Warning

Los tipos de campo pueden ser incompatibles. Revisa este mapping con atención antes de guardar.

✕ Rojo

Error

El mapping no se puede aplicar. El export fallará para todos los registros que usen este mapping.

Warning: No guardes una configuración con iconos rojos. Los exports fallarán para todos los registros que usen ese field mapping.


¿Qué tipo de campo de Salesforce debo usar?

Usa esta tabla como referencia al seleccionar el campo destino de Salesforce para cada campo de Enginy.

Campo de Enginy

Tipo de campo recomendado en Salesforce

Notas

First name, Last name, Job title, Email, Phone

Text / Long Text Area

Campos de texto estándar. Totalmente compatibles.

Number of employees, Years in role, Growth %

Number / Integer / Decimal

Mapear a un campo numérico de Salesforce.

Created at, Last activity at CRM

DateTime

Debe estar en formato ISO 8601 con timezone. Nunca mapear a un campo Text.

Outreach Stage, Sequence Status

Picklist (single)

El valor debe coincidir exactamente con una opción del picklist — distingue mayúsculas y minúsculas.

Languages, Sub-industries

Multi-select Picklist

Los valores deben separarse con ; (no con coma). El valor debe existir como opción configurada.

LinkedIn URL, Domain, Website

Text / URL

Ambos tipos son compatibles en Salesforce.

Personal emails, Other phones

Multi-select o Text

Usar Professional email y Mobile phone siempre que sea posible para evitar enviar arrays.

Boolean fields (e.g. verified)

Checkbox

Mapear a un campo Checkbox de Salesforce.


Warning amarillo: qué hacer

Salesforce requiere que los tipos de campo coincidan exactamente. Un warning amarillo significa que el mapping probablemente fallará y debe revisarse antes de guardar.

1.Campo de texto mapeado a un campo Picklist

Si mapeas un campo de texto de Enginy a un picklist de Salesforce, Salesforce rechazará el valor si no coincide exactamente con una de las opciones configuradas del picklist. Salesforce devuelve INVALID_OR_NULL_FOR_RESTRICTED_PICKLIST en este caso.

La coincidencia es case-sensitive"Replied" y "replied" se tratan como valores diferentes.

Cómo resolverlo:

  • Crea un AI Variable con output type One off y define las opciones para que coincidan exactamente con los valores del picklist de Salesforce.

  • Para campos de tipo Fixed Value o Engagement: introduce el valor exacto del picklist directamente en la configuración del mapping.

  • Para campos de Manual Export: introduce el valor exacto del picklist en el momento del export.

Note: Los valores de picklist multi-select deben separarse con ; — por ejemplo: opcion_uno;opcion_dos. Usar comas hará que Salesforce almacene toda la cadena como un único valor no reconocido.

2.Campo de fecha mapeado a un campo Text o Date

Enginy almacena los campos de fecha (como Created at o Last activity at CRM) como valores de fecha y hora completos.

  • Si el destino es un campo Date de Salesforce: Salesforce solo acepta YYYY-MM-DD. Enginy elimina la parte de hora antes de enviar — el valor se sincronizará pero se perderá la información de hora.

  • Si el destino es un campo Text de Salesforce: Salesforce rechazará el valor con un error de validación.

Cómo resolverlo: Mapea los campos de fecha de Enginy a un campo DateTime de Salesforce para preservar el valor completo.


Error rojo: qué hacer

Un icono rojo significa que el mapping fallará siempre. Hay dos razones posibles:

1. Tipos de campo incompatibles

Los tipos de campo de ambos lados son incompatibles y Salesforce no puede convertirlos.

Cómo resolverlo: Elimina el mapping y selecciona un campo de Salesforce con un tipo compatible. Usa la tabla de referencia de arriba para elegir el tipo correcto.

2.Campo read-only de Salesforce

El campo destino en Salesforce es de solo lectura y no puede ser actualizado por Enginy. Esto suele afectar a campos de sistema como IDs de registro, campos de fórmula o campos de resumen.

Cómo resolverlo: Elimina el mapping y elige un campo de Salesforce que se pueda escribir, o consulta con tu administrador de Salesforce para confirmar los permisos del campo.


Errores frecuentes en el mapping de Salesforce

Error

Qué ocurre

Cómo corregirlo

Mapear un campo de Company en la pestaña Contacts (o viceversa)

El export falla con un error de field mapping

Verifica que solo los campos de Contact aparecen bajo Contacts, y solo los de Company bajo Companies

Mapear un campo de fecha de Enginy a un campo Text de Salesforce

Salesforce devuelve un error de validación

Mapea a un campo DateTime de Salesforce

Mapear un campo de fecha de Enginy a un campo Date de Salesforce

Se pierde la información de hora

Mapea a DateTime si necesitas el valor completo

Mapear un campo de texto a un Picklist de Salesforce sin valores coincidentes

Salesforce devuelve INVALID_OR_NULL_FOR_RESTRICTED_PICKLIST

Usa un AI Variable (One off) con valores que coincidan exactamente — distingue mayúsculas y minúsculas

Usar comas en lugar de punto y coma en valores multi-select

Salesforce almacena toda la cadena como un único valor no reconocido

Usa ; como separador entre valores multi-select

Mapear a un campo de fórmula o read-only de Salesforce

El export falla

Elige un campo que se pueda escribir

Todos los exports fallan

Problema de conexión

Reconecta tu integración de Salesforce — ve a Integrations → Salesforce y reconecta

Guardar mappings con iconos rojos

Todos los registros que usen ese mapping fallan al exportar

Corrige o elimina cualquier mapping con icono rojo antes de guardar


¿Necesitas más ayuda?

Si has revisado tu configuración de mapping y el export sigue fallando, contacta con nuestro equipo de soporte con:

  • El nombre del campo de Enginy y el campo de Salesforce que intentas mapear

  • El mensaje de error o el icono que estás viendo

  • Una captura de pantalla de la configuración del Field Mapping si es posible

¿Ha quedado contestada tu pregunta?