Guía tutorial
Manual paso a paso del CRM inmobiliario CaboHispania: captación, cartera, demandas, matching, publicación, comisiones y avisos.
Básicos (1–10)
Flujo diario para trabajar con el módulo desde cero.
Avanzados (11–13)
Integraciones, configuración y casos menos frecuentes.
Parte A · Básicos
- Ir →
Paso 1
Contactos
Dar de alta propietarios y demandantes.
Qué hacer
- Menú Contactos → Nuevo.
- Tipo PROPIETARIO o DEMANDANTE (o COMPRADOR).
- Nombre, teléfono y email (el email/teléfono hacen falta para avisos de matching).
Qué debes ver
- Contacto en listado
- Ficha con datos de contacto
- Ir →
Paso 2
Captación
Registrar un lead antes de entrar en cartera.
Qué hacer
- Captación → Nueva.
- Origen (web, cartel, llamada…), precio estimado, zona.
- Datos del contacto potencial.
- Cuando cierre: Convertir a propiedad.
Qué debes ver
- Lead en estado NUEVA / EN_NEGOCIACION
- Tras convertir: ficha en Propiedades
- Ir →
Paso 3
Alta de propiedad
Crear ficha completa tipo Idealista.
Qué hacer
- Propiedades → Nueva (o desde captación convertida).
- Rellenar título, precio, m², ciudad, CP, fotos, descripción ≥ 50 caracteres.
- Asignar propietario y agente.
- Guardar (estado DISPONIBLE).
Qué debes ver
- Referencia CH-…
- Ficha con fotos
- Cruces con demandas si hay match
- Ir →
Paso 4
Demandas + matching
Crear búsqueda de cliente y ver cruces automáticos.
Qué hacer
- Demandas → Nueva: operación, tipos, presupuesto, ciudades/zonas.
- Vincular al contacto demandante.
- Al guardar una propiedad compatible, se crean cruces (score ≥ 40).
- Si SMTP está configurado, el contacto recibe email marketing; si no, aviso en Avisos con WA/mailto.
Qué debes ver
- Cruce PROPUESTO / ENVIADO
- Email o aviso en /avisos
- Plantilla en /plantillas/matching
- Ir →
Paso 5
Agenda y seguimientos
Programar visitas y dejar actividad.
Qué hacer
- Agenda → Nueva cita (visita) ligada a propiedad.
- En la ficha: añadir seguimiento (llamada, WhatsApp, nota).
Qué debes ver
- Cita en agenda
- Timeline en Actividad
- Ir →
Paso 6
Documentación y checklist
Subir docs y marcar checklist propietario/comprador.
Qué hacer
- Ficha propiedad → documentos / checklist.
- Subir escritura, IBI, CEE…; al subir se marca el ítem si corresponde.
- Documentos legales → generar y enviar a firma si aplica.
Qué debes ver
- Checklist avanzando
- Documento en listado
- Ir →
Paso 7
Publicación Idealista / web
Marcar canales y revisar feed.
Qué hacer
- Editar propiedad → Publicar en Idealista / Publicar en web.
- Menú Publicación: checklist de campos listos.
- Descargar feed JSON o copiar URL live (con token en producción).
Qué debes ver
- Badge Listo
- Feed JSON
- Panel Idealista live
- Ir →
Paso 8
Escaparate público
Ver la web de anuncios.
Qué hacer
- Escaparate (o /escaparate).
- Filtrar y abrir ficha pública.
- Probar contacto / aviso legal.
Qué debes ver
- Catálogo con fotos
- CTA contacto
- Ir →
Paso 9
Comprador y reforma → OT
Asignar comprador y enviar a Oficina técnica si hay reforma.
Qué hacer
- En ficha: asignar comprador o usar cruce «Usar como comprador».
- Marcar para reformar / enviar a Oficina técnica.
- Revisar aviso de flujo en Avisos.
Qué debes ver
- Comprador en ficha
- Estado ciclo reforma
- Aviso FLUJO
- Ir →
Paso 10
Comisiones → Control
Registrar honorarios y cobrar con factura IVA.
Qué hacer
- Pasar propiedad a VENDIDO o ALQUILADO.
- Registrar comisión (3 % venta o 1 mes alquiler por defecto).
- Marcar cobrada + factura IVA (Control en :3003 debe estar arrancado).
- Descargar PDF de factura desde el enlace o desde Control.
Qué debes ver
- Comisión COBRADA
- Sync Control OK
- PDF factura
Parte B · Avanzados
- Ir →
Paso 11
SMTP y umbral matching
Activar emails automáticos a demandas.
Qué hacer
- Configurar SMTP_* y NEXT_PUBLIC_SITE_URL en .env.
- Opcional: MATCHING_NOTIFY_MIN_SCORE=50.
- Guardar una propiedad compatible y comprobar bandeja / Avisos.
Qué debes ver
- SMTP configurado en /plantillas/matching
- Actividad tipo EMAIL
- Ir →
Paso 12
Idealista live (token)
Proteger y compartir el feed.
Qué hacer
- IDEALISTA_FEED_TOKEN en .env.
- Publicación → copiar URL del feed.
- Probar ?listos=1&ack=1.
Qué debes ver
- Feed con token
- Estados sync ENVIADO
- Ir →
Paso 13
Estadísticas y agentes
KPIs y reparto por agente.
Qué hacer
- Estadísticas: cartera, embudo.
- Agentes: alta y conmutador de agente activo.
Qué debes ver
- KPIs filtrados por agente