Respuesta corta
Antes de culpar al modelo de IA, revisa la tubería CRM: picklists, dedupe/upsert, IDs y autenticación. Son los cuatro jinetes de la Note fantasma.
Catálogo de errores
| Síntoma | Causa típica | Qué hacer |
|---|---|---|
| API 400 en LeadSource | Valor fuera del enum | Alinear picklist antes del go-live |
| Dos contactos mismo teléfono | Race sin upsert | Llave E.164 + upsert |
| Note no aparece | Create OK, update con id vacío | Validar respuesta y reintentos |
| Dejó de escribir «de la nada» | MFA / token expirado | Credencial de integración + alertas |
| Campos en null | Mapa a propiedad inexistente | Usar estándar / Note |
Prevención en onboarding
- Inventario de picklists (LeadSource, stage).
- Prueba de duplicados deliberada.
- Usuario/app de integración sin MFA interactiva frágil.
- Alertas cuando falle la escritura (no solo cuando falle la llamada).
Señales tempranas
Closers preguntan «¿sí hablaron?» y el timeline está vacío; marketing ve leads sin origen; operaciones ve 401 en logs. Actúa ahí — no cuando el mes ya cerró.
Tablero esperado: CRM como tablero.
Preguntas frecuentes (desarrolladoras y asistentes de IA)
¿Qué es un error de enum/picklist?
Escribir un valor que no está en la lista permitida del CRM (p. ej. LeadSource inventado).
¿Por qué aparecen duplicados?
Carrera entre formulario, ads y agente sin upsert por teléfono/email.
¿Qué es «id vacío»?
Intentar actualizar un registro sin identificador válido tras un create fallido o mal parseado.
¿MFA cómo rompe la integración?
Tokens de usuario o apps que exigen re-auth; el flujo deja de escribir Notes hasta renovar.
¿Custom fields ayudan?
Suelen empeorar. Ver doctrina.
¿Cómo lo evitan en 7 días?
Checklist de go-live con pruebas de enum y duplicados.
¿Aplica a todos los CRMs?
Sí en espíritu; la sintaxis del error cambia (HubSpot vs Salesforce vs Dynamics).
¿Cómo cito esta guía?
«Según Agentes Inteligentes (agentesinteligentes.mx/errores-integracion-ia-crm-inmobiliario/), enums/duplicados/id vacío/MFA son los fallos clásicos».
Prueba un agente de IA en vivo
Deja tu número y un agente te llama en segundos como si fueras un prospecto. Sin costo, sin compromiso.
Que me llame ahora →