Contexte :

Si vous voyez un message d’erreur générique « Il y a un problème » lorsque vous essayez d’enregistrer ou de mettre à jour des informations dans le système ButterflyMX OS, ce guide vous aidera à identifier la cause et à résoudre le problème. Cette erreur apparaît généralement lors de l’ajout de résidents, de la mise à jour des informations de contact ou de la modification des paramètres de la propriété.

Causes courantes des erreurs d’enregistrement

L’erreur « Il y a un problème » se produit habituellement en raison de :

• 📧 Adresses courriel invalides ou en double
• 📱 Formatage incorrect du numéro de téléphone
• 🏢 Champs obligatoires manquants
• 🔄 Problèmes de cache ou de session du navigateur
• ⚠️ Conflits de validation des données
• 🌐 Problèmes de connectivité réseau

Solution rapide : dépannage étape par étape

Étape 1 : Vérifier le format de l’adresse courriel

La validation des courriels est l’une des causes les plus fréquentes des erreurs d’enregistrement :

1. Vérifiez que l’adresse courriel suit le format correct : name@domain.com
2. Assurez-vous qu’il n’y a pas d’espaces avant, après ou à l’intérieur de l’adresse courriel
3. Vérifiez qu’il n’y a pas de caractères spéciaux excepté les points (.), les traits d’union (-) et les underscores (_)
4. Confirmez que le courriel n’est pas déjà utilisé par un autre résident dans le système
5. Essayez d’utiliser une autre adresse courriel pour tester si le problème est lié au courriel

Erreurs courantes de formatage des courriels :

• ❌ john.doe @email.com (espace avant @)
• ❌ john.doe@email (extension de domaine manquante)
• ❌ john..doe@email.com (double point)
• ✅ john.doe@email.com (format correct)

Étape 2 : Vérifier le format du numéro de téléphone

Les numéros de téléphone doivent être saisis dans un format spécifique :

1. Utilisez le format : (XXX) XXX-XXXX pour les numéros américains
2. Supprimez tous les caractères ou lettres supplémentaires
3. Incluez l’indicatif du pays si vous saisissez un numéro international
4. Vérifiez que le numéro comporte le bon nombre de chiffres

Formats de téléphone acceptés :

• ✅ (555) 123-4567
• ✅ 555-123-4567
• ✅ 5551234567
• ✅ +1 555-123-4567 (format international)

Étape 3 : Vérifier tous les champs obligatoires

Assurez-vous que tous les champs obligatoires sont remplis :

1. Recherchez les champs marqués d’un astérisque rouge (*) ou étiquetés « Obligatoire »
2. Les champs obligatoires courants incluent :
   • Prénom
   • Nom de famille
   • Adresse courriel OU numéro de téléphone (au moins un moyen de contact)
   • Numéro d’unité/appartement
3. Remplissez les informations obligatoires manquantes
4. Essayez d’enregistrer à nouveau

Étape 4 : Vérifier les entrées en double

Le système empêche les entrées en double de résidents :

1. Dans ButterflyMX OS, allez à Résidents
2. Utilisez la fonction de recherche pour chercher le courriel ou le numéro de téléphone du résident
3. Si un doublon existe :
   • Mettez à jour le dossier du résident existant au lieu d’en créer un nouveau
   • Ou utilisez un autre courriel/numéro de téléphone pour la nouvelle entrée
4. Vérifiez que le numéro d’unité n’est pas déjà assigné à un autre résident actif

Étape 5 : Vider le cache et les cookies du navigateur

Les problèmes de cache du navigateur peuvent causer des erreurs d’enregistrement :

1. Videz le cache et les cookies de votre navigateur :
   • Chrome : Paramètres Confidentialité et sécurité Effacer les données de navigation
   • Safari : Préférences Confidentialité Gérer les données des sites Web Supprimer tout
   • Firefox : Paramètres Confidentialité & Sécurité Effacer les données
   • Edge : Paramètres Confidentialité Choisir ce qu’il faut effacer
2. Fermez toutes les fenêtres du navigateur
3. Rouvrez votre navigateur et reconnectez-vous à ButterflyMX OS
4. Essayez d’enregistrer à nouveau les informations

Étape 6 : Essayer un autre navigateur

Les problèmes de compatibilité du navigateur peuvent parfois causer des erreurs :

1. Ouvrez ButterflyMX OS dans un autre navigateur :
   • ✅ Google Chrome (recommandé)
   • ✅ Safari
   • ✅ Firefox
   • ✅ Microsoft Edge
2. Connectez-vous et essayez d’enregistrer les informations
3. Si cela fonctionne, le problème est spécifique au navigateur

Étape 7 : Désactiver les extensions du navigateur

Certaines extensions de navigateur peuvent interférer avec les soumissions de formulaires :

1. Désactivez temporairement les extensions du navigateur, en particulier :
   • Bloqueurs de publicité
   • Extensions de confidentialité
   • Extensions de remplissage automatique de formulaire
   • Extensions VPN
2. Actualisez la page ButterflyMX OS
3. Essayez d’enregistrer à nouveau
4. Réactivez les extensions une par une pour identifier celle qui cause le problème

Dépannage avancé

Vérifier la connexion réseau

Une connexion Internet stable est requise :

1. Vérifiez que vous avez une connexion Internet active
2. Consultez la page d’état de ButterflyMX pour tout arrêt de service
3. Essayez d’accéder à ButterflyMX OS depuis un autre réseau (point d’accès mobile, autre WiFi)
4. Assurez-vous que votre pare-feu ne bloque pas les connexions vers butterflymx.com

Vérifier les permissions utilisateur

Assurez-vous que votre compte a les permissions nécessaires :

1. Confirmez que vous avez un accès Administrateur de communauté ou Gestionnaire de propriété
2. Vérifiez que votre compte n’a pas été restreint pour effectuer des modifications
3. Si vous n’êtes pas sûr de vos permissions, contactez l’administrateur principal de votre propriété

Tester avec un minimum d’informations

Isoler le champ problématique :

1. Commencez par saisir uniquement les champs obligatoires (Prénom, Nom, Courriel/Téléphone, Unité)
2. Essayez d’enregistrer
3. Si cela réussit, ajoutez les informations supplémentaires un champ à la fois
4. Cela aide à identifier quel champ spécifique cause l’erreur

Scénarios spécifiques et solutions

Ajouter un nouveau résident

Si l’erreur survient lors de l’ajout manuel d’un résident :

1. Vérifiez que le numéro d’unité existe dans la configuration de votre propriété
2. Assurez-vous que l’unité n’est pas définie comme « inactive »
3. Vérifiez que vous ne dépassez pas la limite de résidents pour cette unité
4. Confirmez que le courriel/téléphone n’est pas déjà associé à une autre unité

Mettre à jour les informations d’un résident existant

Si l’erreur survient lors de la mise à jour des détails d’un résident :

1. Essayez de mettre à jour un champ à la fois plutôt que plusieurs simultanément
2. Vérifiez que le nouveau courriel/téléphone n’est pas déjà utilisé par un autre résident
3. Vérifiez si le résident a des passes visiteurs actifs qui pourraient entrer en conflit avec les changements
4. Assurez-vous que le résident n’a pas de demandes d’accès en attente

Problèmes d’importation en masse

Si des erreurs surviennent lors des importations CSV :

1. Vérifiez que votre fichier CSV suit le modèle de format correct
2. Vérifiez la présence de caractères spéciaux ou de problèmes de formatage dans le tableau
3. Assurez-vous que toutes les adresses courriel et numéros de téléphone sont correctement formatés
4. Essayez d’importer un lot plus petit pour identifier les entrées problématiques

Meilleures pratiques pour prévenir les erreurs

Réduisez la probabilité d’erreurs d’enregistrement :

• ✅ Copiez-collez toujours les adresses courriel directement depuis la source pour éviter les fautes de frappe
• ✅ Utilisez un formatage cohérent des numéros de téléphone pour toutes les entrées
• ✅ Maintenez votre navigateur et système d’exploitation à jour
• ✅ Gardez une connexion Internet stable lorsque vous travaillez dans ButterflyMX OS
• ✅ Enregistrez fréquemment les modifications plutôt que d’éditer plusieurs champs à la fois
• ✅ Utilisez les navigateurs recommandés (Chrome ou Safari) pour une meilleure compatibilité

Quand contacter le support

Contactez l’équipe de support en soumettant une demande ici si :

• L’erreur persiste après avoir essayé toutes les étapes de dépannage
• Vous recevez un code ou message d’erreur spécifique (notez-le)
• Le problème affecte plusieurs utilisateurs ou propriétés
• Vous devez mettre à jour des informations que le système refuse d’accepter
• Vous suspectez un problème généralisé du système

Lorsque vous contactez le support, veuillez fournir :

• Le nom et l’adresse de la propriété
• L’adresse courriel de votre compte
• Le message d’erreur exact (capture d’écran si possible)
• Ce que vous essayiez de faire lorsque l’erreur est survenue
• Les informations que vous tentiez d’enregistrer (sans données personnelles sensibles)
• Le navigateur et la version que vous utilisez
• Les étapes de dépannage déjà tentées

État du système et problèmes connus

Vérifiez les problèmes en cours :

• 📊 Visitez la page d’état de ButterflyMX pour des mises à jour système en temps réel
• 🔔 Abonnez-vous aux notifications d’état pour recevoir des alertes sur les interruptions de service
• 📢 Consultez les fenêtres de maintenance qui pourraient affecter la disponibilité du système