Mis Contactos

Este módulo sirve para crear/editar contactos y registrar su actividad (interacciones, mensajes, oportunidades y tareas).

Alta y edición de contactos

Campos principales

Nombre y Apellido (obligatorios) — solo letras y espacios, máx. 80 c/u.
Tipo de contacto (obligatorio) — Cliente, Prospecto o Proveedor.
Consentimiento de comunicación (checkbox).
Correo, Teléfono y WhatsApp (opcionales) — se validan con expresiones regulares por tipo.
Puntaje (Score) (opcional) — entero 0–100.
Archivado (checkbox).
Etiquetas (Tags) — solo se muestran las ACTIVAS/INACTIVAS; las INACTIVAS se ven pero no se pueden elegir.
Campos personalizados — elige del catálogo, valor obligatorio, no se pueden repetir en el mismo contacto.

Reglas de duplicados

Si existe conflicto duro (otro contacto ya tiene el mismo email/teléfono) → error y no se permite crear/actualizar.
Si existe conflicto suave (posible duplicado) → se muestra un modal con candidatos y opción de continuar bajo tu responsabilidad.

Estados del contacto

Activo / Desactivado / Eliminado.
- Eliminar marca como Eliminado y bloquea el formulario.
- Desactivar impide acciones hasta reactivar.

Canales de comunicación (pestaña “Comunicación”)

Cada canal tiene: Tipo, Valor, Principal.

Tipos configurables (ej.: EMAIL, PHONE, WHATSAPP, etc.). Cada tipo valida su formato según regex de servidor (si no hay, se usa un patrón seguro).
Obligatorio elegir tipo y valor.
Un “Principal” por cada tipo (p.ej., un email principal, un teléfono principal, etc.).
Unicidad:
- No puedes repetir (tipo + valor) dentro del mismo contacto.
- Un mismo número no puede existir a la vez como PHONE y WHATSAPP.
En edición, solo se muestran canales vigentes (si tienen vigencia validFrom/validTo, se filtran los expirados).

Direcciones (pestaña “Direcciones”)

Campos: Tipo (Casa/Trabajo), Calle, Número, Colonia, Ciudad, Estado/Región, Código postal, País (ISO-2), Región (opcional), Principal, Activo.

Requeridos: Tipo, Calle, Ciudad, País (ISO-2), Código postal (según país).
- Estado es obligatorio si el país tiene subdivisiones (se detecta desde el catálogo de países).
Validaciones de longitud y caracteres por campo.
Dependencias: al cambiar País se actualizan Estados; al cambiar Estado se actualizan Ciudades.
Duplicados: el servidor impide dos direcciones del mismo tipo (p.ej., dos “Trabajo”).

Interacciones

Registra puntos de contacto rápidos con el cliente.

Tipos: Llamada, Nota, Reunión, Email.
Fecha/hora (obligatoria) — no puede estar en el futuro.
Resumen (obligatorio, máx. 500) — no se aceptan cadenas en blanco.
Se guarda en UTC y se muestra en hora local.
En edición, si no hiciste cambios, se notifica “Sin cambios pendientes”.

Mensajes (registro)

Sirve para dejar constancia de un mensaje enviado por algún canal del contacto.

Canal del contacto (obligatorio) — solo puedes elegir canales activos del contacto.
Asunto — obligatorio si el canal es Email (máx. 200).
Contenido (obligatorio, máx. 10 000).
Enviado el — opcional; si lo pones, no puede estar en el futuro.
Estatus se deriva:
- Sin “Enviado el” → PENDING.
- Con “Enviado el” → SENT (el flujo puede usar DELIVERED, READ, FAILED si corresponde).
Edición: si el mensaje ya no está PENDING, queda solo lectura y no puedes cambiar el canal.
Nota: este módulo no envía emails/WhatsApp; solo registra.

Oportunidades

Etapa (obligatoria): Nueva, En Diálogo, Negociación, Ganada, Perdida.
Origen (obligatorio): Manual, Referido, Campaña, Otro.
Nombre (obligatorio); Descripción (opcional).
Monto (≥ 0) y Probabilidad (0–100).
Fechas:
- Cierre (solo fecha, opcional).
- Ganada/Perdida (obligatoria si la etapa es Ganada/Perdida; no puede ser futura).
Oportunidades en etapa Ganada/Perdida quedan bloqueadas para edición.

Tareas

Tipo: Llamada, Email, Reunión, Otro.
Descripción (obligatoria, máx. 1000, no en blanco).
Vence el (obligatorio) — no puede estar en el pasado (tolerancia de reloj ±5 min).
Estatus: Pendiente / Completada.
- Si marcas Completada, “Completada el” pasa a ser obligatoria y no puede ser futura.
- Tareas completadas quedan solo lectura.
Puedes asociarla a una oportunidad (opcional).

Historial

Disponible al editar un contacto: carga bajo demanda el timeline de acciones (con marca de tiempo en local).

Búsqueda y exportación

Filtros rápidos por texto en Interacciones, Mensajes y Tareas.
Exportar CSV por pestaña (botón Acciones → Exportar).

Reglas de guardado y errores comunes

En edición, si no cambias núcleo + canales + direcciones, se muestra “Sin cambios” y no se envía nada.
Correo/Teléfono duplicados en otro contacto → error de duplicado duro.
Posible duplicado (umbral configurable) → modal con candidatos y opción de omitir (bajo token).
Dirección duplicada por tipo → error “No se puede tener direcciones duplicadas del tipo …”.
Formato inválido en canales/direcciones → se indican mensajes por campo.
Límite de creación alcanzado (plan Free) → se muestra modal y no crea.

Buenas prácticas

Define un canal principal por tipo (email/teléfono/WhatsApp).
Usa Etiquetas para segmentar y evita usar “Archivado” como filtro de trabajo.
Mantén la fecha/hora real en Interacciones/Mensajes; el sistema convierte a UTC.
Cierra oportunidades con la fecha correcta y evita modificar tareas ya completas.

Resumen: “Mis Contactos” es la fuente de verdad del cliente (datos, canales, direcciones, actividad). Aquí registras comunicaciones y trabajo comercial; el envío masivo o pasarelas no viven en este módulo.