¿Por qué pueden generarse contactos duplicados en Vixiees?

En algunos casos, los contactos pueden crearse dos veces en Vixiees si las solicitudes llegan al sistema con una diferencia de tiempo extremadamente pequeña. Este artículo explica por qué sucede esto, cuándo puede ocurrir y cómo evitarlo.

⚠️ Este comportamiento aplica incluso si tienes activadas las validaciones de "Email único" y "Teléfono único" en tu configuración interna de Vixiees.

¿Cuándo pueden generarse contactos duplicados?

Los contactos duplicados suelen aparecer cuando:

• Se envían dos peticiones de creación de contacto a la API de Vixiees con una diferencia de menos de medio segundo.
• Ambas peticiones contienen la misma información (nombre, teléfono, correo electrónico, etc.).

En estos casos, el índice interno que usamos para detectar duplicados aún no se ha actualizado, lo que puede permitir la creación simultánea de dos registros con los mismos datos.

? Este comportamiento es poco frecuente, pero puede ocurrir en integraciones que generan múltiples eventos al mismo tiempo (por ejemplo, automatizaciones de formularios o plataformas de ads que disparan eventos dobles).

¿Por qué ocurre esto?

Vixiees utiliza un sistema de verificación que comprueba si un contacto ya existe antes de crear uno nuevo. Sin embargo:

• El sistema necesita algunos segundos para actualizarse entre cada operación.
• Si las peticiones llegan simultáneamente o casi al mismo tiempo, el índice puede no detectar el duplicado a tiempo.

Esto aplica incluso cuando están activadas las validaciones de unicidad de email o teléfono. En escenarios de concurrencia extrema, puede que ambos registros pasen la validación antes de que se registre el primero en la base de datos.

¿Cómo evitar la creación de duplicados?

Recomendamos tomar las siguientes precauciones:

Si usas automatizaciones o integraciones:

• Asegúrate de no disparar múltiples eventos de contacto simultáneamente.
• Implementa un control de duplicados desde tu sistema de origen, usando identificadores únicos (como el email o el ID del lead).
• Introduce un retraso mínimo de 1 segundo entre peticiones similares si no puedes consolidarlas.

Si usas herramientas de terceros:

• Verifica que no estén generando eventos duplicados.
• Consulta la documentación de la herramienta para revisar cómo se gestionan los reintentos o errores de red.

Conclusión

Aunque el sistema de Vixiees incluye mecanismos de validación y detección de duplicados (como el email o teléfono único), no puede garantizarlo cuando se reciben peticiones en menos de medio segundo de diferencia. La mejor forma de prevenir este escenario es controlar desde tu sistema de origen que no se estén enviando solicitudes idénticas al mismo tiempo.