Contexto:
Si ves un mensaje de error genérico "Hay un problema" al intentar guardar o actualizar información en el ButterflyMX OS, esta guía te ayudará a identificar la causa y resolver el problema. Este error suele aparecer al agregar residentes, actualizar información de contacto o modificar la configuración de la propiedad.
Causas comunes de errores al guardar
El error "Hay un problema" generalmente ocurre debido a:
- 📧 Direcciones de correo electrónico inválidas o duplicadas
- 📱 Formato incorrecto del número de teléfono
- 🏢 Campos obligatorios faltantes
- 🔄 Problemas con la caché del navegador o la sesión
- ⚠️ Conflictos en la validación de datos
- 🌐 Problemas de conectividad de red
Solución rápida: solución de problemas paso a paso
Paso 1: Verificar el formato de la dirección de correo electrónico
La validación del correo electrónico es una de las causas más comunes de errores al guardar:
- Verifica que la dirección de correo electrónico siga el formato correcto:
nombre@dominio.com - Asegúrate de que no haya espacios antes, después o dentro de la dirección de correo electrónico
- Verifica que no haya caracteres especiales excepto puntos (.), guiones (-) y guiones bajos (_)
- Confirma que el correo electrónico no esté ya en uso por otro residente en el sistema
- Prueba usar una dirección de correo diferente para verificar si el problema es específico del correo
Errores comunes en el formato del correo electrónico:
- ❌
john.doe @email.com(espacio antes de @) - ❌
john.doe@email(falta la extensión del dominio) - ❌
john..doe@email.com(puntos dobles) - ✅
john.doe@email.com(formato correcto)
Paso 2: Verificar el formato del número de teléfono
Los números de teléfono deben ingresarse en un formato específico:
- Usa el formato:
(XXX) XXX-XXXXpara números de EE. UU. - Elimina cualquier carácter o letra adicional
- Incluye el código de país si ingresas un número internacional
- Verifica que el número tenga la cantidad correcta de dígitos
Formatos de teléfono aceptados:
- ✅
(555) 123-4567 - ✅
555-123-4567 - ✅
5551234567 - ✅
+1 555-123-4567(formato internacional)
Paso 3: Verificar todos los campos obligatorios
Asegúrate de que todos los campos obligatorios estén completos:
- Busca campos marcados con un asterisco rojo (*) o etiquetados como "Obligatorio"
- Los campos obligatorios comunes incluyen:
- Nombre
- Apellido
- Correo electrónico O número de teléfono (al menos un método de contacto)
- Número de unidad/apartamento
- Completa cualquier información obligatoria faltante
- Intenta guardar nuevamente
Paso 4: Verificar entradas duplicadas
El sistema previene entradas duplicadas de residentes:
- En el ButterflyMX OS, navega a Residentes
- Usa la función de búsqueda para buscar el correo electrónico o número de teléfono del residente
- Si existe un duplicado:
- Actualiza el registro del residente existente en lugar de crear uno nuevo
- O usa un correo electrónico/número de teléfono diferente para la nueva entrada
- Verifica que el número de unidad no esté ya asignado a otro residente activo
Paso 5: Limpiar caché y cookies del navegador
Los problemas con la caché del navegador pueden causar errores al guardar:
- Limpia la caché y las cookies de tu navegador:
- Chrome: Configuración Privacidad y seguridad Borrar datos de navegación
- Safari: Preferencias Privacidad Administrar datos del sitio web Eliminar todo
- Firefox: Configuración Privacidad y seguridad Borrar datos
- Edge: Configuración Privacidad Elegir qué borrar
- Cierra todas las ventanas del navegador
- Vuelve a abrir el navegador e inicia sesión en ButterflyMX OS
- Intenta guardar la información nuevamente
Paso 6: Probar con un navegador diferente
Los problemas de compatibilidad del navegador a veces pueden causar errores:
- Abre ButterflyMX OS en un navegador diferente:
- ✅ Google Chrome (recomendado)
- ✅ Safari
- ✅ Firefox
- ✅ Microsoft Edge
- Inicia sesión e intenta guardar la información
- Si tienes éxito, el problema es específico del navegador
Paso 7: Deshabilitar extensiones del navegador
Algunas extensiones del navegador pueden interferir con el envío de formularios:
- Deshabilita temporalmente las extensiones del navegador, especialmente:
- Bloqueadores de anuncios
- Extensiones de privacidad
- Extensiones de autocompletado de formularios
- Extensiones de VPN
- Actualiza la página de ButterflyMX OS
- Intenta guardar nuevamente
- Vuelve a habilitar las extensiones una por una para identificar la causante
Solución avanzada de problemas
Verificar conexión de red
Se requiere una conexión a internet estable:
- Verifica que tengas una conexión activa a internet
- Consulta la Página de Estado de ButterflyMX para ver interrupciones del servicio
- Intenta acceder a ButterflyMX OS desde otra red (punto de acceso móvil, otra WiFi)
- Asegúrate de que tu firewall no esté bloqueando conexiones a butterflymx.com
Verificar permisos de usuario
Asegúrate de que tu cuenta tenga los permisos necesarios:
- Confirma que tienes acceso como Administrador de Comunidad o Administrador de Propiedad
- Verifica que tu cuenta no tenga restricciones para hacer cambios
- Si no estás seguro sobre tus permisos, contacta al administrador principal de tu propiedad
Probar con información mínima
Isola el campo problemático:
- Comienza ingresando solo los campos obligatorios (Nombre, Apellido, Correo/Teléfono, Unidad)
- Intenta guardar
- Si tienes éxito, agrega información adicional campo por campo
- Esto ayuda a identificar qué campo específico está causando el error
Escenarios específicos y soluciones
Agregar un nuevo residente
Si el error ocurre al agregar un residente manualmente:
- Verifica que el número de unidad exista en la configuración de tu propiedad
- Asegúrate de que la unidad no esté en estado "inactiva"
- Verifica que no estés excediendo el límite de residentes para esa unidad
- Confirma que el correo electrónico/teléfono no esté ya asociado a otra unidad
Actualizar información de un residente existente
Si el error ocurre al actualizar detalles de un residente:
- Intenta actualizar un campo a la vez en lugar de varios simultáneamente
- Verifica que el nuevo correo/teléfono no esté ya en uso por otro residente
- Revisa si el residente tiene pases de visitante activos que puedan entrar en conflicto con los cambios
- Asegúrate de que el residente no tenga solicitudes de acceso pendientes
Problemas con importación masiva
Si ocurren errores durante importaciones CSV:
- Verifica que tu archivo CSV siga la plantilla de formato correcta
- Revisa si hay caracteres especiales o problemas de formato en la hoja de cálculo
- Asegúrate de que todos los correos electrónicos y números telefónicos estén correctamente formateados
- Intenta importar un lote más pequeño para identificar entradas problemáticas
Mejores prácticas para prevenir errores
Reduce la probabilidad de errores al guardar:
- ✅ Siempre copia y pega las direcciones de correo electrónico directamente desde la fuente para evitar errores tipográficos
- ✅ Usa un formato consistente para los números telefónicos en todas las entradas
- ✅ Mantén actualizado el navegador y el sistema operativo
- ✅ Mantén una conexión a internet estable cuando trabajes en ButterflyMX OS
- ✅ Guarda los cambios con frecuencia en lugar de editar varios campos a la vez
- ✅ Usa los navegadores recomendados (Chrome o Safari) para mejor compatibilidad
Cuándo contactar al soporte
Contacta al equipo de Soporte enviando una solicitud aquí si:
- El error persiste después de intentar todos los pasos de solución de problemas
- Recibes un código o mensaje de error específico (anótalo)
- El problema afecta a múltiples usuarios o propiedades
- Necesitas actualizar información que el sistema no acepta
- Sospechas de un problema a nivel del sistema
Al contactar al soporte, por favor proporciona:
- Nombre y dirección de la propiedad
- Correo electrónico de tu cuenta
- Mensaje exacto de error (captura de pantalla si es posible)
- Qué estabas intentando hacer cuando ocurrió el error
- Información que intentabas guardar (sin datos personales sensibles)
- Navegador y versión que estás usando
- Pasos de solución de problemas ya intentados
Estado del sistema y problemas conocidos
Consulta problemas en curso:
- 📊 Visita la Página de Estado de ButterflyMX para actualizaciones en tiempo real del sistema
- 🔔 Suscríbete a las notificaciones de estado para recibir alertas sobre interrupciones del servicio
- 📢 Consulta las ventanas de mantenimiento que puedan afectar la disponibilidad del sistema