Validaciones de email y teléfono para evitar duplicados

Vixiees incluye validaciones para evitar que se creen contactos duplicados con el mismo email o teléfono. Este artículo explica cómo funcionan estas validaciones.

Normalización de emails

Antes de validar, el sistema normaliza los emails:

• Convierte a minúsculas
• Elimina espacios al inicio y final
• Genera un email "canónico" (sin puntos en Gmail, etc.)

Ejemplo:

• John.Doe@GMAIL.com → johndoe@gmail.com (canónico)
• Ambas variantes se detectan como el mismo email

Normalización de teléfonos

Los teléfonos se normalizan al formato E.164:

• Se eliminan caracteres especiales (paréntesis, guiones)
• Se añade el prefijo de país si no lo tiene
• Se convierte a formato internacional (+34612345678)

Ejemplo:

• 612 345 678 → +34612345678 (si el prefijo por defecto es +34)
• 0034612345678 → +34612345678

Detección de duplicados

Al crear o editar un contacto, el sistema busca:

Si encuentra una coincidencia, muestra un error y no permite crear el contacto.

Mensajes de error

Cuando se detecta un duplicado:

• Teléfono duplicado: "Ya existe un contacto con este número de teléfono"
• Email duplicado: "Ya existe un contacto con este email"
• Teléfono adicional duplicado: "Este teléfono adicional ya está en uso"
• Email adicional duplicado: "Este email adicional ya está en uso"

Validación de formato

Validación de teléfono

• Verifica que sea un número válido internacionalmente
• Comprueba que tenga el formato correcto para el país
• Error: "Número de teléfono inválido, asegúrate de incluir el prefijo (+34)"

Validación de email

• Verifica el formato básico (nombre@dominio.com)
• Opcionalmente, verifica que el dominio exista (registros MX)
• Error: "El email es inválido o el buzón no existe"

Cuándo se pueden omitir validaciones

Existen configuraciones a nivel de cuenta para omitir validaciones:

Estas opciones están desactivadas por defecto para mantener la calidad de datos.

Importación de contactos

Durante la importación masiva:

• La validación de formato se omite para mayor flexibilidad
• La detección de duplicados usa búsqueda por teléfono o email
• Si encuentra un contacto existente, lo actualiza en lugar de crear uno nuevo

Emails y teléfonos adicionales

Los campos adicionales también se validan:

• No puede haber duplicados dentro del mismo contacto
• No pueden coincidir con el email/teléfono principal
• No pueden existir en otros contactos de la cuenta

Conclusión

Las validaciones de email y teléfono ayudan a mantener una base de datos limpia sin duplicados. El sistema normaliza los datos antes de validar para detectar coincidencias aunque el formato sea diferente. Si necesitas flexibilidad, las validaciones pueden omitirse a nivel de cuenta.

Escenarios relevantes

• Mantenimiento de bases de datos limpias
• Integración con CRMs donde pueden llegar datos duplicados
• Importación de listas de contactos de diferentes fuentes