Para acceder al Field Mapping, ve a Integrations → Zoho → Configure → Step 2: Field Mapping.
Important: Zoho CRM requiere que los tipos de campo y los formatos de fecha coincidan exactamente. Enviar un valor en el formato incorrecto hará que el export falle.
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 Zoho debo usar?
Usa esta tabla como referencia al seleccionar el campo destino de Zoho para cada campo de Enginy.
Campo de Enginy | Tipo de campo recomendado en Zoho | Notas |
First name, Last name, Job title, Email, Phone | Text / LongText / Email / PhoneNumber | Campos estándar. Totalmente compatibles. |
Number of employees, Years in role, Growth % | Number / Integer / Decimal | Mapear a un campo numérico de Zoho. |
Created at, Last activity at CRM | DateTime | Enginy gestiona la conversión de formato automáticamente. Nunca mapear a un campo Text. |
Outreach Stage, Sequence Status | Picklist | El valor debe coincidir exactamente con una opción del picklist. |
Languages, Sub-industries | MultiSelect | Los valores deben coincidir exactamente con opciones existentes. |
LinkedIn URL, Domain, Website | Website / Text | Ambos tipos son compatibles en Zoho. |
Personal emails, Other phones | 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 Zoho. |
Warning amarillo: qué hacer
1. Campo de texto mapeado a un campo Picklist o MultiSelect
Si mapeas un campo de texto de Enginy a un campo Picklist o MultiSelect de Zoho, el export fallará si el valor no coincide exactamente con una de las opciones configuradas.
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 Zoho.
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.
2. Campo de fecha mapeado a un campo Text
Enginy gestiona la conversión del formato DateTime de Zoho automáticamente. El error solo ocurre si el campo destino en Zoho es un campo de texto en lugar de un campo DateTime — en ese caso, Zoho devolverá un error Invalid Zoho date_time value y el export fallará.
Cómo resolverlo: Mapea los campos de fecha de Enginy a un campo DateTime de Zoho. Nunca los mapees a un campo Text.
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 Zoho no puede procesar el valor.
Cómo resolverlo: Elimina el mapping y selecciona un campo de Zoho con un tipo compatible. Usa la tabla de referencia de arriba para elegir el tipo correcto.
2. Campo read-only de Zoho
El campo destino en Zoho es de solo lectura y no puede ser actualizado por Enginy. Esto suele afectar a campos generados por el sistema.
Cómo resolverlo: Elimina el mapping y elige un campo de Zoho que se pueda escribir, o consulta con tu administrador de Zoho para confirmar los permisos del campo.
Errores frecuentes en el mapping de Zoho
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 Zoho | Zoho devuelve Invalid Zoho date_time value y el export falla | Mapea a un campo DateTime de Zoho |
Mapear un campo de texto a un Picklist de Zoho sin valores coincidentes | El export falla | Usa un AI Variable (One off) con los valores exactos del picklist de Zoho |
Mapear a un campo read-only o de sistema | El export falla | Elige un campo que se pueda escribir |
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 Zoho 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