Cómo usar Claude para mapear campos y planear la limpieza de datos antes de una migración a HubSpot

Exporta el esquema de tu CRM heredado, los valores de las listas de selección, el conteo de registros y una pequeña muestra anonimizada. Luego pide a Claude por pasos: primero un borrador del mapa de campos (objeto, propiedad, tipo y transformación por campo), luego reglas de limpieza ordenadas por registros afectados y riesgo. Tu equipo de migración valida cada fila a mano y decide objetos, tipos de propiedad, propietarios y eliminaciones antes de importar nada a HubSpot.

Puntos clave

• Dale a Claude una exportación del esquema, los valores de las listas de selección con sus conteos, el número de registros y una pequeña muestra anonimizada, nunca registros reales de clientes.
• Usa etiquetas XML, columnas fijas y una fila de ejemplo para que Claude devuelva un mapa de campos con objeto, propiedad, tipo y transformación para cada campo.
• Ordena las reglas de limpieza por registros afectados y riesgo, y empieza por los correos electrónicos y los dominios de los sitios web, porque HubSpot deduplica los contactos por correo electrónico y las empresas por dominio.
• Claude redacta; tu equipo decide la elección de objetos, los tipos de propiedad, los propietarios y las eliminaciones, y un revisor designado da el visto bueno a cada fila antes de importar.
• Según PIPEDA, tu empresa sigue siendo responsable de la información personal que envía a un encargado del tratamiento, así que mantén los datos personales fuera de los prompts y confirma con tu asesor legal las leyes estatales de Estados Unidos.

¿Qué debes darle a Claude y qué nunca debes pegar?

Dale a Claude la estructura de tus datos, no los datos en sí: una exportación del esquema, los valores de las listas de selección con sus conteos, el número de registros y una pequeña muestra anonimizada. Nunca pegues nombres, correos electrónicos, teléfonos, notas ni detalles de negocios reales.

Digitalegy es un partner de HubSpot. La preparación que sigue funciona tanto si dejas Salesforce, Zoho o Pipedrive como si vienes de hojas de cálculo. Si todavía estás evaluando los pasos más amplios de un proyecto, lee primero Cosas que debes saber antes de implementar HubSpot.

Una exportación del esquema es una lista de todos los campos de tu CRM heredado con su objeto, etiqueta, nombre de API y tipo de dato. Un mapa de campos es la tabla que indica a qué lugar de HubSpot llega cada campo heredado y cómo cambian sus valores en el camino. Dale a Claude cuatro insumos:

• Exportación del esquema: objeto, etiqueta, nombre de API, tipo de dato e indicador de campo obligatorio de cada campo que podrías migrar.
• Valores de las listas de selección con conteos: cada valor y cuántos registros lo usan. La guía de HubSpot sobre los tipos de campo de las propiedades establece que "The maximum size of the property is 512,000 bytes, or 5,000 options, whichever is reached first" (el tamaño máximo de la propiedad es de 512,000 bytes o 5,000 opciones, lo que se alcance primero), así que los conteos muestran pronto qué listas de selección necesitan trabajo.
• Número de registros y tasas de llenado: totales por objeto y la proporción de registros en los que cada campo no está vacío.
• Una muestra anonimizada: de 20 a 50 filas por objeto, con nombres, correos electrónicos, teléfonos y texto libre reemplazados por marcadores como contact_0001@example.com.

Nunca pegues nombres reales de contactos, direcciones de correo electrónico, números de teléfono, notas, cuerpos de correos electrónicos ni detalles de negocios vinculados a un cliente identificado. La página del centro de privacidad de Anthropic sobre el entrenamiento de modelos dice: "And we encourage our users not to use our products and services to process personal data" (y alentamos a nuestros usuarios a no usar nuestros productos y servicios para procesar datos personales). Un mapa de campos necesita la estructura de tu CRM, no a las personas que contiene.

¿Qué prompts convierten un esquema heredado en un borrador del mapa de campos de HubSpot?

Ejecuta una secuencia corta: un prompt que limita a Claude a tus archivos, otro que redacta el mapa de campos con columnas fijas y una fila de ejemplo, y otro que rastrea cada fila hasta tu esquema.

Las mejores prácticas de prompts de Anthropic señalan que "Claude responds well to clear, explicit instructions" (Claude responde bien a instrucciones claras y explícitas) y que "Examples are one of the most reliable ways to steer Claude’s output format, tone, and structure" (los ejemplos son una de las formas más confiables de orientar el formato, el tono y la estructura de las respuestas de Claude). La misma guía indica que las etiquetas XML ayudan a Claude a interpretar prompts que mezclan instrucciones, contexto, ejemplos y entradas variables, así que envuelve tus archivos en las etiquetas <schema>, <counts> y <sample>. Su guía para reducir las alucinaciones agrega dos hábitos: deja que Claude admita la incertidumbre y pídele que use solo los documentos que le proporcionas.

Ejemplo práctico: Harbor Valve Supply (ficticio)

Harbor Valve Supply es una empresa de distribución inventada. Su CRM heredado contiene 18,400 contactos, 3,100 cuentas y 2,250 oportunidades, con 15 campos dentro del alcance. Todas las cifras de este ejemplo son ficticias.

Prompt 1: contexto y límites

Estás ayudando a planear una migración de CRM a HubSpot. Usa solo la información dentro de las etiquetas <schema>, <counts> y <sample>, no tu conocimiento general. Si no estás seguro de para qué sirve un campo, escribe SIN CERTEZA y di qué necesitarías saber. Nunca agregues un campo que no esté en <schema>.

Prompt 2: borrador del mapa de campos

Para cada campo de <schema>, devuelve una fila de tabla con estas columnas: campo heredado, objeto de HubSpot (contacto, empresa, negocio o actividad), propiedad de HubSpot (una propiedad predeterminada si alguna encaja; si no, una propiedad personalizada propuesta), tipo de propiedad, regla de transformación, confianza (alta, media o baja) y pregunta abierta. Fila de ejemplo: Contact.Email | Contacto | Correo electrónico | predeterminada | quitar espacios, minúsculas | alta | ninguna. Marca cualquier lista de selección con más de 5,000 valores y cualquier campo vacío en más del 80% de los registros.

El umbral de 5,000 refleja el límite de opciones de la guía de HubSpot sobre los tipos de campo de las propiedades. Después de una primera revisión, el borrador quedó así:

Prompt 3: verificación de trazabilidad

Para cada fila de tu mapa de campos, cita la línea de <schema> de la que salió. Elimina cualquier fila que no puedas rastrear y enumera lo que eliminaste.

Luego ejecuta de nuevo el Prompt 2 en un chat nuevo y compara las tablas. Como dice la guía sobre alucinaciones, "Inconsistencies across outputs could indicate hallucinations" (las inconsistencias entre las respuestas podrían indicar alucinaciones).

¿Cómo logras que Claude ordene las reglas de limpieza de datos por impacto?

Pídele a Claude reglas de limpieza con los registros que toca cada una y el riesgo si se omite, ordenadas por impacto. Toda regla que elimine o combine datos pasa al equipo, nunca directo desde el borrador.

Prompt 4: reglas de limpieza priorizadas

Con <schema>, <counts> y <sample>, propón reglas de limpieza para duplicados, formato, consolidación de listas de selección y campos vacíos o sin uso. Para cada regla, indica los campos afectados, los registros que toca, el riesgo si se omite (alto, medio o bajo) y si debe aplicarse antes de importar. Ordena por registros afectados y riesgo. Marca como DECISIÓN DEL EQUIPO cualquier regla que elimine o combine datos.

Empieza por los identificadores. El artículo de HubSpot sobre deduplicación explica que "HubSpot automatically deduplicates contacts using email addresses, and companies using domain names" (HubSpot deduplica automáticamente los contactos por dirección de correo electrónico y las empresas por nombre de dominio) y que, cuando ya existe un contacto con el mismo correo electrónico, "the imported information will update the existing contact rather than create a new one" (la información importada actualizará el contacto existente en lugar de crear uno nuevo). Los correos electrónicos y sitios web desordenados pueden provocar actualizaciones inesperadas o coincidencias perdidas. La lista priorizada del ejemplo ficticio:

1. Combinar correos electrónicos duplicados: 640 contactos (3.5% de 18,400) una vez corregidas las mayúsculas y los espacios. Riesgo alto. DECISIÓN DEL EQUIPO sobre el registro que se conserva.
2. Decidir qué hacer con los contactos sin correo electrónico: 1,150 contactos que la coincidencia por correo electrónico no puede detectar. Riesgo alto. DECISIÓN DEL EQUIPO: importar, enriquecer o archivar.
3. Reducir los sitios web a dominios raíz: 410 de 3,100 cuentas. Riesgo alto para la coincidencia de empresas.
4. Asignar 11 etapas a 7: 2,250 oportunidades, 186 abiertas en etapas retiradas. Riesgo alto para los pronósticos. DECISIÓN DEL EQUIPO para las 186.
5. Consolidar el origen del prospecto de 23 a 8 valores. Riesgo medio para la atribución.
6. Consolidar el sector a partir de 41 valores. Riesgo medio.
7. Convertir el texto de ingresos e importes en números con una moneda. Riesgo medio.
8. Estandarizar las fechas de cierre. Riesgo bajo una vez convertidas.
9. Dejar atrás Fax (97% vacío). Riesgo bajo. DECISIÓN DEL EQUIPO porque elimina datos.

Ambas listas de selección terminan muy por debajo del límite de 5,000 opciones de la guía de HubSpot sobre los tipos de campo; la razón para consolidar es tener reportes limpios. Para mantener los registros limpios después del lanzamiento, lee ¿Cómo mejorar la calidad de los datos en RevOps con las herramientas IA de HubSpot?

¿Qué decisiones de la migración debe validar tu equipo a mano?

Claude redacta cada fila; tu equipo decide la elección de objetos, los tipos de propiedad, los propietarios y las eliminaciones. Un revisor designado compara cada fila con los objetos y propiedades predeterminados de HubSpot y le da el visto bueno antes de importar.

Trata la columna de estado de validación como un contrato: Claude propone y solo una persona designada marca una fila como Aceptada. Para repasar cómo organiza HubSpot los registros antes de elegir los objetos de destino, abre La visión general del modelo de datos de HubSpot.

El artículo de HubSpot sobre la herramienta de importación señala que "Mapping correctly ensures that your data goes to the right place (i.e. the correct object and the correct property) when added to HubSpot" (mapear correctamente garantiza que tus datos lleguen al lugar correcto, es decir, al objeto y a la propiedad correctos, cuando se agregan a HubSpot). Da el visto bueno a cada fila con esta lista de verificación:

1. Trazable: el campo aparece en la exportación del esquema y en la salida del Prompt 3.
2. Objeto: el objeto de destino coincide con la forma en que tus equipos usan los datos.
3. Primero lo predeterminado: ninguna propiedad predeterminada de HubSpot cubre ya el campo.
4. Tipo: el tipo corresponde a lo que guarda el campo. La guía de HubSpot sobre los tipos de campo indica que solo ciertos tipos de campo permiten editar su tipo u opciones después de crearse, así que define los tipos antes de importar.
5. Tamaño: las propiedades de selección desplegable, casilla de verificación y botón de opción se mantienen dentro de 512,000 bytes o 5,000 opciones, lo que se alcance primero.
6. Identificadores: los contactos coinciden por Correo electrónico y las empresas por Nombre de dominio de la empresa, los identificadores que HubSpot recomienda para las importaciones.
7. Propietarios: cada usuario heredado se asigna a un usuario activo de HubSpot o a un usuario alterno designado.
8. Eliminaciones: cada fila No migrar tiene un lugar de archivo y una persona que la autoriza.
9. Visto bueno: nombre del revisor, fecha y estado final registrados en la fila.

¿Cuánto tiempo toma la preparación con ayuda de Claude y cuánto cuesta?

En una estimación de planeación ficticia para un esquema de 200 campos, el método con ayuda de Claude reduce el tiempo de preparación aproximadamente un 40%, casi todo en la redacción. El costo de la herramienta es el plan de Claude que usa tu empresa; verifica que sea un plan comercial cuyos términos cubran este trabajo. El costo principal es el tiempo de los revisores.

Las cifras siguientes son una estimación de planeación para un esquema ficticio, no resultados medidos. Reemplaza cada supuesto con los tuyos.

El ahorro es de 18.3 horas, aproximadamente un 40%. El tiempo de revisión no se reduce, y no debe reducirse: ahí es donde se toman las decisiones.

Revisa los términos y el precio del plan de Claude que usa tu empresa. El costo mayor son las personas: un responsable de RevOps o un administrador del CRM que sea dueño del mapa, un responsable de operaciones de ventas para las etapas y los propietarios, un responsable de Marketing Operations para los campos de origen del prospecto y la persona que rinde cuentas por la privacidad.

Si tu CRM heredado está en la lista de aplicaciones compatibles de HubSpot y cargas los datos con HubSpot Smart Transfer, que según HubSpot "is designed for a one-time migration of data from another app to HubSpot" (está diseñado para una migración única de datos desde otra aplicación a HubSpot), tu mapa validado responde las preguntas que plantean sus pasos de mapeo.

¿Cuáles son los riesgos y cómo los controlas?

Los riesgos principales son campos inventados, tipos de propiedad incorrectos, datos personales en los prompts e historial de actividades perdido. Cada uno tiene un control específico: trazabilidad, revisión de tipos, anonimización y un plan de actividades.

La guía de Anthropic sobre alucinaciones es directa sobre los límites de cualquier técnica de prompts:

"Remember, although these techniques significantly reduce hallucinations, they don’t eliminate them entirely. Always validate critical information, especially for high-stakes decisions" (recuerda: aunque estas técnicas reducen de forma significativa las alucinaciones, no las eliminan por completo; valida siempre la información crítica, sobre todo en decisiones de alto riesgo). (Reducir las alucinaciones)

• Campos alucinados: Claude inventa un campo o una propiedad. Control: los límites del Prompt 1, la trazabilidad del Prompt 3 y una segunda ejecución del Prompt 2.
• Tipos de propiedad incorrectos: los ingresos guardados como texto rompen los reportes y filtros numéricos. Control: revisa cada tipo antes de importar.
• Privacidad de los datos: registros reales terminan en un chat. Control: solo muestras anonimizadas, y conoce los términos de tu plan. Para las cuentas comerciales de Claude for Work (planes Team o Enterprise), la página de Anthropic sobre los roles de encargado y responsable del tratamiento dice que Anthropic actúa como encargado del tratamiento en nombre del cliente y trata los datos solo según las instrucciones del cliente, para prestar el servicio de Claude.
• Historial perdido: llamadas, correos electrónicos y notas se quedan atrás porque nadie los mapeó. Control: enumera los tipos de actividad en tu exportación. El artículo de HubSpot sobre la herramienta de importación indica que las actividades compatibles incluyen llamadas, correos electrónicos, reuniones, notas y tareas. Decide cuáles traes y a qué registros se asocian.

¿Cómo afectan PIPEDA y las leyes estatales de privacidad de Estados Unidos lo que compartes con Claude?

En Canadá, PIPEDA mantiene a tu empresa como responsable de la información personal que envía a cualquier encargado del tratamiento, así que lo más seguro por defecto es mantener los datos personales fuera de Claude. Para los registros de Estados Unidos, confirma con tu asesor legal las leyes estatales aplicables; el método anonimizado funciona en ambos países.

La Oficina del Comisionado de Privacidad de Canadá (OPC) enumera los principios de información justa de PIPEDA. Los que son relevantes para una migración incluyen:

• Responsabilidad: "An organization is responsible for personal information under its control. It must appoint someone to be accountable for its compliance with these fair information principles" (una organización es responsable de la información personal bajo su control y debe designar a alguien que rinda cuentas por su cumplimiento de estos principios de información justa).
• Limitación de la recopilación: "The collection of personal information must be limited to that which is needed for the purposes identified by the organization" (la recopilación de información personal debe limitarse a lo necesario para los fines que identifica la organización).
• Exactitud: "Personal information must be as accurate, complete, and up-to-date as possible in order to properly satisfy the purposes for which it is to be used" (la información personal debe ser tan exacta, completa y actualizada como sea posible para cumplir adecuadamente los fines para los que se usará).
• Salvaguardas: "Personal information must be protected by appropriate security relative to the sensitivity of the information" (la información personal debe protegerse con medidas de seguridad adecuadas a su sensibilidad).

Las directrices de la OPC para el procesamiento de datos personales a través de fronteras (con fecha de 2009) establecen que "PIPEDA does not prohibit organizations in Canada from transferring personal information to an organization in another jurisdiction for processing" (PIPEDA no prohíbe que las organizaciones en Canadá transfieran información personal a una organización de otra jurisdicción para su procesamiento) y que "The transferring organization is accountable for the information in the hands of the organization to which it has been transferred" (la organización que transfiere es responsable de la información en manos de la organización a la que se transfirió). Si envías información personal a un proveedor de CRM o de IA para su procesamiento, tu empresa sigue siendo responsable de ella.

El método de insumos anonimizados evita que el paso de preparación maneje información personal en absoluto. El principio de exactitud también da a tus reglas de limpieza una razón de cumplimiento, no solo de reportes. Confirma con tu asesor legal si las leyes provinciales agregan requisitos.

Para los registros de Estados Unidos, las fuentes de este artículo no describen una sola ley federal que cumpla el papel que PIPEDA cumple en Canadá, así que parte de tus propios datos. Usa el campo de estado (State) de tu exportación para listar en qué estados viven tus contactos y lleva esa lista a tu asesor legal. Pregunta qué leyes estatales aplican a las personas de tu base de datos y si campos como las notas contienen datos sensibles. Lo que compartes con Claude es igual en Toronto y en Texas: estructura y marcadores, nunca personas.

¿Cuándo conviene recurrir a un equipo de implementación?

Recurre a un equipo de implementación cuando las decisiones pesen más que la redacción: objetos personalizados, una sincronización activa con Salesforce durante el cambio, mucho historial de actividades, varias monedas o nadie con tiempo para dar el visto bueno a cada fila.

• Tu mapa necesita objetos personalizados o asociaciones complejas.
• Planeas mantener Salesforce en funcionamiento durante el cambio. El artículo de HubSpot sobre Smart Transfer advierte que "Smart Transfer and the Salesforce integration use different unique identifiers to match records, so using both at the same time will create duplicate records in HubSpot and Salesforce" (Smart Transfer y la integración con Salesforce usan identificadores únicos distintos para hacer coincidir registros, así que usar ambos al mismo tiempo creará registros duplicados en HubSpot y en Salesforce).
• Una lista de selección heredada se acerca al límite de 5,000 opciones.
• Años de llamadas, correos electrónicos y notas deben seguir asociados a los registros correctos.
• Los registros abarcan monedas o unidades de negocio que necesitan pipelines separados.
• Nadie tiene tiempo para dar el visto bueno a cada fila.

Digitalegy se convirtió en HubSpot Gold Partner en 2019, Platinum en 2023 y Diamond en 2024. Los equipos que quieren ayuda con la implementación, la migración y las integraciones personalizadas pueden empezar con la implementación de HubSpot de Digitalegy. Las empresas que quieren un onboarding guiado para sus equipos después de la migración pueden empezar con el onboarding de HubSpot.

Preguntas frecuentes

¿Debo usar HubSpot Smart Transfer o la herramienta de importación?

Usa Smart Transfer cuando tu aplicación heredada esté en su lista de compatibles y hagas una migración única; si no, usa la herramienta de importación. HubSpot describe Smart Transfer como diseñado para una migración única desde otra aplicación, mientras que la herramienta de importación asigna las columnas de una hoja de cálculo a propiedades para crear registros, actualizar los existentes y definir relaciones.

¿Importar dos veces el mismo contacto crea un duplicado?

No, si el correo electrónico coincide. El artículo de HubSpot sobre deduplicación indica que una importación con un correo electrónico existente actualiza ese contacto en lugar de crear uno nuevo. Mantén Correo electrónico como columna de identificador único en cada archivo de importación de contactos, como recomienda el artículo de HubSpot sobre la herramienta de importación para las importaciones.

¿Y si mi CRM heredado es un conjunto de hojas de cálculo?

Exporta los encabezados de columna de cada hoja como tu esquema y dáselos a Claude, con conteos y una muestra anonimizada. Luego carga los datos con la herramienta de importación de HubSpot, que asigna las columnas de la hoja de cálculo a propiedades de HubSpot.

¿Claude se entrena con lo que pego?

Para las ofertas comerciales de Anthropic, como la API de Anthropic y Claude for Work (planes Team y Enterprise), el centro de privacidad de Anthropic indica que no usará tus chats ni tus sesiones de programación para entrenar sus modelos, a menos que te inscribas en un programa específico que esa página identifica. Verifica qué plan usa tu empresa. Aun así, anonimiza.

¿Debo mapear los campos de todo el esquema o solo los que están en uso?

Empieza por el esquema completo para no omitir nada y luego deja que las tasas de llenado reduzcan la lista. En el ejemplo práctico, el Prompt 2 marca cualquier campo vacío en más del 80% de los registros, y Fax (97% vacío) se convirtió en una fila No migrar que el equipo autoriza con un lugar de archivo.

¿Qué hago con Claude después del lanzamiento?

Úsalo con datos limpios. Cómo usar Claude para revisar los datos del pipeline de HubSpot y marcar el riesgo del pronóstico cada semana configura una rutina semanal que marca fechas de cierre aplazadas, negocios estancados y campos faltantes.

Fuentes

1. Understand property field types in HubSpot, HubSpot Knowledge Base (29 de septiembre de 2026)
2. How do you use personal data in model training?, Anthropic Privacy Center (16 de marzo de 2026)
3. Prompting best practices, Anthropic (Claude Platform Docs)
4. Reduce hallucinations, Anthropic (Claude Platform Docs)
5. Deduplicate records in HubSpot, HubSpot Knowledge Base (2 de octubre de 2026)
6. Understand the import tool, HubSpot Knowledge Base (6 de marzo de 2026)
7. Transfer data from other apps using HubSpot Smart Transfer, HubSpot Knowledge Base (4 de noviembre de 2026)
8. Does Anthropic Act as a Data Processor or Controller?, Anthropic Privacy Center (30 de octubre de 2026)
9. PIPEDA fair information principles, Office of the Privacy Commissioner of Canada (29 de mayo de 2025)
10. Guidelines for processing personal data across borders, Office of the Privacy Commissioner of Canada (27 de enero de 2009)