Ir al contenido principal

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

Al configurar el Step 2: Field Mapping en tu integración de Attio, cada campo mapeado muestra un icono de estado que indica si el mapping es seguro. Revisar estos iconos antes de guardar la configuración te ayuda a evitar errores en los exports.

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

Importante: Attio utiliza un formato de valor estructurado — cada tipo de campo tiene su propio formato esperado. Enginy gestiona estas conversiones automáticamente cuando se selecciona el tipo de campo correcto. Mapear al tipo de campo 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 Attio debo usar?

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

Campo de Enginy

Tipo de campo recomendado en Attio

Notas

First name, Last name

text

Enginy divide el nombre completo en nombre y apellido automáticamente.

Job title, Description

text

Campos de texto estándar. Totalmente compatibles.

Professional email

email

Mapear a un campo email de Attio. Enginy envía el valor en el formato estructurado correcto automáticamente.

Mobile phone

phone_number

Mapear a un campo phone_number de Attio. Enginy envía el valor en el formato estructurado correcto automáticamente.

Number of employees, Years in role, Growth %

number

Mapear a un campo number de Attio.

Created at, Last activity at CRM

date_time

Enginy envía fechas en formato ISO 8601. Mapear a un campo date_time, nunca a un campo text.

Outreach Stage, Sequence Status

select (single)

El valor debe coincidir exactamente con una opción existente.

Languages, Sub-industries

multi-select

Los valores deben coincidir exactamente con opciones existentes.

Domain, Website

domain

Mapear a un campo domain de Attio. Enginy envía el valor en el formato estructurado correcto automáticamente.

LinkedIn URL

url

Mapear a un campo url de Attio.

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 Attio.


Warning amarillo: qué hacer

1. Campo de texto mapeado a un campo Select

Si mapeas un campo de texto de Enginy a un campo select de Attio, 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 las opciones del campo select de Attio.

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

  • Para campos de Manual Export: introduce el valor exacto de la opción en el momento del export.

2. Campo de fecha mapeado a un campo Text

Enginy envía los campos de fecha (como Created at o Last activity at CRM) en formato ISO 8601. Si el campo destino es un campo de texto, el valor no se procesará correctamente.

Cómo resolverlo: Mapea los campos de fecha de Enginy a un campo date_time de Attio.


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 Attio no puede procesar el valor.

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

2. Campo read-only de Attio

El campo destino en Attio 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 Attio que se pueda escribir, o consulta con tu administrador de Attio para confirmar los permisos del campo.


Errores frecuentes en el mapping de Attio

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 Attio

El valor no se procesa correctamente

Mapea a un campo date_time de Attio

Mapear un campo de texto a un campo select de Attio sin valores coincidentes

El export falla

Usa un AI Variable (One off) con los valores exactos de las opciones de Attio

Mapear emails, phones o domains a un campo text

El valor puede no almacenarse en el formato correcto

Mapea al tipo de campo dedicado de Attio: email, phone_number o domain

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 Attio 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?