Integración de IA con tu CRM: Salesforce y HubSpot

Integrar tu agente de IA con tu CRM es el paso que transforma la atención al cliente de reactiva a proactiva. Sin integración, tu agente responde preguntas genéricas sin contexto del cliente. Con integración, el agente sabe quién es el cliente, su historial de compras, sus tickets anteriores, su nivel de satisfacción y su valor como cliente antes de responder el primer mensaje. Esta guía cubre la integración técnica con los dos CRMs más utilizados en empresas de LATAM: Salesforce y HubSpot. Aunque los detalles técnicos difieren, el principio es el mismo: establecer un flujo de datos bidireccional donde el agente de IA consulta información del cliente en el CRM y registra las interacciones de vuelta. Cubriremos qué datos sincronizar, cómo configurar cada plataforma, y las consideraciones de privacidad que debes tener en cuenta.

Los datos que fluyen entre tu agente de IA y el CRM se dividen en dos direcciones. Del CRM al agente (consulta): datos del contacto (nombre, email, teléfono, empresa), historial de compras o contrataciones, tickets abiertos y resueltos recientes, valor del cliente (LTV, segmento, plan contratado), notas del equipo comercial relevantes para soporte, y preferencias del cliente (idioma, canal preferido). Del agente al CRM (registro): resumen de cada conversación (tema, resolución, duración), nuevo ticket creado si la consulta no se resolvió, actualización del sentimiento del cliente, cambio en datos del contacto si el cliente proporcionó información nueva, y actividades registradas en la línea de tiempo del contacto. Define claramente qué datos son de solo lectura para el agente y cuáles puede modificar. El agente nunca debería poder eliminar registros ni modificar datos financieros.

Configuración de Salesforce: paso a paso. Paso 1: Crea una Connected App en Salesforce Setup. Ve a Setup, busca App Manager, crea nueva Connected App. Habilita OAuth Settings, selecciona los scopes necesarios: api (acceso a API REST), refresh_token (tokens persistentes) y id (identificación del usuario). Genera el Consumer Key y Consumer Secret. Paso 2: Configura un usuario de integración dedicado. Nunca uses la cuenta de un usuario real. Crea un perfil específico con permisos mínimos necesarios: lectura de Contactos, Cuentas, Casos y Oportunidades; escritura de Casos y Actividades. Paso 3: Configura el mapeo de campos. Los campos estándar de Salesforce que tu agente necesita: Contact.Name, Contact.Email, Contact.Phone, Account.Name, Case.Subject, Case.Status, Case.Description, Opportunity.StageName y Opportunity.Amount. Si tienes campos personalizados relevantes, inclúyelos en el mapeo.

Paso 4 para Salesforce: Configura los triggers y automatizaciones. Crea un Flow en Salesforce que se ejecute cuando el agente de IA crea un nuevo caso: asigna automáticamente el caso al equipo correcto según la categoría, envía una notificación al dueño de la cuenta si el caso es crítico, y actualiza el campo de última interacción en el contacto. Crea otro Flow para cuando el agente actualiza el sentimiento del cliente: si el sentimiento es negativo y el cliente es de alto valor (LTV mayor a cierto umbral), crea una tarea para el account manager. Paso 5: Implementa la autenticación OAuth 2.0 con flujo JWT Bearer para conexiones server-to-server. Esto evita la necesidad de login interactivo y es más seguro que almacenar usuario y contraseña. Configura la rotación automática de tokens cada 12 horas. Paso 6: Prueba la integración con datos de sandbox antes de conectar producción. Salesforce ofrece sandboxes gratuitos para desarrollo y pruebas.

Configuración de HubSpot: paso a paso. Paso 1: Crea una Private App en HubSpot. Ve a Settings, Account Setup, Integrations, Private Apps. Define un nombre descriptivo como Nexodo AI Agent Integration. Paso 2: Selecciona los scopes necesarios: crm.objects.contacts.read y crm.objects.contacts.write para contactos, crm.objects.deals.read para negocios, tickets para gestión de tickets, y timeline para registrar actividades. Genera el Access Token. HubSpot usa un token único en lugar del flujo OAuth de Salesforce, lo cual simplifica la configuración. Paso 3: Configura el mapeo de campos. Campos estándar: firstname, lastname, email, phone, company, lifecyclestage, hs_lead_status. Para tickets: subject, content, hs_pipeline, hs_pipeline_stage, hs_ticket_priority. HubSpot permite crear custom properties fácilmente para almacenar datos específicos de IA como sentimiento promedio o tasa de resolución del contacto.

Paso 4 para HubSpot: Configura workflows de automatización. Crea un workflow que se active cuando el agente de IA crea un ticket con prioridad alta: notifica por email y Slack al equipo de soporte, si el contacto tiene un deal abierto mayor a cierto valor notifica también al comercial, y programa un seguimiento automático si el ticket no se resuelve en 24 horas. Crea otro workflow para enriquecer el perfil del contacto: cuando el agente registra una nueva conversación, actualiza la propiedad ultima_interaccion_ia con la fecha y el resumen. Paso 5: Configura las asociaciones correctamente. En HubSpot, asegúrate de que los tickets creados por el agente estén asociados tanto al contacto como a la empresa. Esto permite que el equipo vea el historial completo. Paso 6: Usa la API de búsqueda de HubSpot para que el agente identifique al cliente por email o teléfono antes de iniciar la conversación. La búsqueda por email es la más confiable.

Sincronización bidireccional: consideraciones técnicas. La sincronización en tiempo real es necesaria para la consulta del agente al CRM (no puedes esperar 15 minutos para saber quién es el cliente). Usa llamadas API directas con timeout de 3 segundos y un cache local de 5 minutos para datos que no cambian frecuentemente (nombre, empresa, plan). Para el registro de conversaciones del agente al CRM, la sincronización puede ser asíncrona: encola los eventos y procésalos cada 30-60 segundos. Esto reduce la carga en la API del CRM y evita errores por rate limiting. Salesforce tiene un límite de 100,000 llamadas API por 24 horas en edición Enterprise; HubSpot limita a 500,000 por día en planes Professional. Calcula tu consumo esperado: si manejas 1,000 conversaciones diarias y cada una genera 3 llamadas API, necesitas 3,000 llamadas más un buffer del 50% para reintentos. Implementa retry con backoff exponencial para manejar errores temporales.

Privacidad de datos: qué sincronizar y qué no. No todos los datos del CRM deben ser accesibles para el agente de IA. Define una política clara: datos que el agente SÍ debe consultar (nombre, historial de tickets, productos comprados, preferencias de canal), datos que el agente NO debe consultar (datos financieros detallados como facturación total o margen, notas internas del equipo comercial sobre negociaciones, información de otros contactos de la misma empresa). Para cumplimiento con LGPD en Brasil y regulaciones locales de protección de datos: obtén consentimiento para el uso de IA en la atención, documenta qué datos procesa el agente, permite que el cliente solicite la eliminación de datos de IA, y no almacenes datos sensibles (tarjetas, documentos de identidad) en los logs de conversación. Configura una retención de datos de conversaciones de máximo 24 meses.

Pruebas de integración: lista de verificación completa. Antes de activar la integración en producción, verifica cada escenario: el agente identifica correctamente al cliente por email y muestra su nombre, el agente consulta tickets abiertos y los menciona si son relevantes, el agente crea un nuevo ticket correctamente cuando no puede resolver, el ticket creado tiene la categoría, prioridad y descripción correctas, el ticket está asociado al contacto y empresa correctos, el workflow de notificación se dispara cuando corresponde, el agente no accede a datos que no debería ver, la integración funciona con latencia menor a 3 segundos, la integración maneja errores graciosamente (si el CRM no responde, el agente continúa sin contexto en lugar de fallar), y los rate limits no se exceden bajo carga máxima esperada. Ejecuta cada prueba 10 veces para verificar consistencia.

Errores comunes y soluciones. Error 1: Duplicados en el CRM. Si el agente crea un nuevo contacto cada vez que no encuentra una coincidencia exacta por email, terminas con duplicados. Solución: busca por email Y teléfono, y si no hay match, no crees el contacto automáticamente sino registra la conversación como anónima y crea una tarea para que el equipo lo gestione. Error 2: Datos desactualizados en cache. Si cacheas datos del CRM por demasiado tiempo, el agente puede dar información obsoleta (por ejemplo, decir que un ticket está abierto cuando ya se resolvió). Solución: cache de máximo 5 minutos para tickets, 30 minutos para datos de perfil. Error 3: Tokens expirados sin renovación automática. Configura la renovación de tokens antes de su expiración, no después. Error 4: Mapeo incorrecto de campos personalizados entre plataformas. Documenta el mapeo completo en una tabla y revísalo cada vez que se agregue un campo nuevo en cualquiera de los sistemas.