Skip to main content

🔧 Guide de dépannage

Solutions aux problèmes les plus courants rencontrés avec ISAO et vos employés IA.

🚀 Problèmes de connexion​

❌ Impossible de se connecter à ISAO​

Diagnostic​

🔍 Étapes de vérification :
1. Vérifier l'URL : https://staging.isao.io
2. Tester avec un autre navigateur
3. Vider le cache et cookies
4. Désactiver extensions navigateur
5. Tester en navigation privée

Solutions​

  1. Cache navigateur

    Chrome : Ctrl+Shift+Del > Tout supprimer
    Firefox : Ctrl+Shift+Del > Tout supprimer
    Safari : Développement > Vider cache

  2. Problème de réseau

    ✅ Vérifier la connexion internet
    ✅ Tester depuis un autre réseau
    ✅ Contacter admin réseau si entreprise

  3. Extensions bloquantes

    🔧 Désactiver temporairement :
    - Bloqueurs de pub (AdBlock, uBlock)
    - VPN et proxy
    - Antivirus avec protection web

🔐 Problèmes d'authentification​

"Email ou mot de passe incorrect"​

🔧 Solutions rapides :
1. Vérifier la casse (majuscules/minuscules)
2. Copier-coller depuis gestionnaire mots de passe
3. Réinitialiser le mot de passe
4. Vérifier l'email utilisé à l'inscription

"Compte suspendu ou désactivé"​

📧 Actions immédiates :
1. Vérifier email de notification ISAO
2. Contacter support si aucun email reçu
3. Vérifier statut facturation (impayés)
4. Escalade vers équipe commerciale

🤖 Employés IA non fonctionnels​

💬 Employé IA ne répond pas​

Diagnostic rapide​

🔍 Vérifications système :
✅ Statut employé : Actif/Inactif
✅ Crédits disponibles : > 0
✅ Intégrations : Connectées
✅ Permissions : Suffisantes

Solutions par employé​

💼 Mike Finance​
⚠️ Problèmes courants :
- Intégration comptabilité déconnectée
- Permissions email insuffisantes
- Modèles factures non configurés

🔧 Résolutions :
1. Paramètres > Intégrations > Vérifier connexions
2. Renouveler tokens OAuth expirés
3. Reconfigurer modèles documents
👩‍💼 Kim Assistant​
⚠️ Problèmes courants :
- Calendrier non synchronisé
- Boîte email non accessible
- Règles de tri mal configurées

🔧 Résolutions :
1. Reconnecter Google Calendar/Outlook
2. Vérifier permissions Gmail/Outlook
3. Redéfinir règles de priorité emails
🎯 David Commercial​
⚠️ Problèmes courants :
- CRM déconnecté
- Prospects non détectés
- Séquences email bloquées

🔧 Résolutions :
1. Reconnexion HubSpot/Salesforce
2. Vérifier quotas API CRM
3. Contrôler délivrabilité emails

🔄 Synchronisation en échec​

Intégrations tierces​

Gmail/Outlook:
  Erreur: "Token expired"
  Solution: Paramètres > Intégrations > Renouveler

HubSpot/Salesforce:
  Erreur: "API limit exceeded"  
  Solution: Attendre reset quotas (1h)

Google Calendar:
  Erreur: "Permission denied"
  Solution: Réautoriser accès calendrier

Données manquantes​

🔍 Diagnostic :
1. Vérifier logs synchronisation
2. Contrôler filtres et règles
3. Valider mapping champs
4. Tester connexion manuelle

🔧 Solutions :
- Resynchronisation manuelle
- Modification paramètres filtres
- Remapping champs personnalisés
- Nettoyage données corrompues

📧 Problèmes d'email​

📤 Emails non envoyés​

Vérifications de base​

✅ Compte email connecté et autorisé
✅ Quotas envoi non atteints
✅ Adresse destinataire valide
✅ Contenu conforme (pas de spam)

Solutions par fournisseur​

Gmail​
⚠️ Problèmes courants :
- Quota 2000 emails/jour atteint
- Authentification 2FA requise
- App passwords nécessaires

🔧 Solutions :
1. Attendre reset quota (minuit UTC)
2. Configurer OAuth moderne
3. Générer app password spécifique
Outlook/Office 365​
⚠️ Problèmes courants :
- Throttling Microsoft Exchange
- Politique sécurité entreprise
- Tenant restrictions

🔧 Solutions :
1. Espacer envois automatiques
2. Contacter admin Office 365
3. Configurer exemptions ISAO

📥 Emails non reçus/traités​

Diagnostic Kim Assistant​

🔍 Vérifications :
1. Dossier spam/indésirables
2. Règles filtrage actives
3. Transfert automatique configuré
4. Boîte pleine ou quotas

🤖 Kim diagnostic automatique :
"📊 Analyse boîte mail :
- 847 emails non lus détectés
- 23 emails en spam à traiter
- 5 règles filtrage actives
- Dernière sync : il y a 15min"

💰 Problèmes de facturation​

💳 Paiement refusé​

Causes courantes​

❌ Carte expirée ou bloquée
❌ Fonds insuffisants
❌ Restriction géographique
❌ Problème 3D Secure

Solutions immédiates​

🔧 Actions rapides :
1. Vérifier validité carte bancaire
2. Contacter banque pour déblocage
3. Essayer carte alternative
4. Utiliser PayPal si disponible
5. Contacter support facturation

📊 Facturation incorrecte​

Types d'erreurs​

Montant incorrect:
  Vérifier: Plan souscrit vs facturé
  Action: Demande avoir/remboursement

Période erronée:  
  Vérifier: Dates début/fin cycle
  Action: Recalcul prorata

TVA manquante:
  Vérifier: Numéro TVA renseigné
  Action: Facturation corrective

🔗 Problèmes d'intégrations​

🔌 Connexion perdue​

Auto-diagnostic​

// Outil diagnostic intégré ISAO
function diagnosisIntegrations() {
  return {
    gmail: "Connected ✅",
    calendar: "Token expired ⚠️", 
    hubspot: "API limit ⚠️",
    stripe: "Connected ✅"
  }
}

Résolution par étapes​

1. 🔍 Identification problème
   - Token expiré → Renouveler OAuth
   - API limit → Attendre reset ou upgrader
   - Permission → Réautoriser accès

2. 🔧 Correction ciblée  
   - Reconnexion sélective
   - Test connexion isolée
   - Validation données sync

3. ✅ Vérification fonctionnement
   - Test action simple
   - Monitoring 24h
   - Alertes configurées

⚙️ Configuration incorrecte​

Mapping champs​

Problème: Données mal synchronisées
Cause: Mapping champs incorrect
Solution:
  1. Paramètres > Intégrations > Mapping
  2. Vérifier correspondances champs
  3. Tester avec données exemple
  4. Sauvegarder configuration

Règles et filtres​

Problème: Trop/pas assez de données sync
Cause: Filtres mal configurés  
Solution:
  1. Réviser critères filtrage
  2. Tester avec échantillon réduit
  3. Ajuster progressivement
  4. Monitorer résultats

📱 Problèmes d'interface​

🖥️ Affichage incorrect​

Problèmes navigateur​

Chrome/Edge:
  - Forcer actualisation : Ctrl+F5
  - Mode dev : F12 > Console errors
  - Extensions : Désactiver temporairement

Firefox:
  - Vider cache : Ctrl+Shift+R
  - Mode sécurisé : Help > Restart with addons disabled

Safari:
  - Développement > Vider cache
  - Préférences > Avancées > Afficher menu Développement

Responsive design​

📱 Mobile :
- Vérifier viewport settings
- Tester rotation écran
- Zoom navigateur à 100%

💻 Desktop :
- Résolution minimale : 1280x720
- Zoom navigateur : 100%
- Multi-écrans : Problèmes connus

⚡ Performance lente​

Optimisations immédiates​

🚀 Accélération :
1. Fermer onglets inutiles (< 10 recommandé)
2. Redémarrer navigateur si ouvert > 24h  
3. Vider cache et données stockées
4. Désactiver extensions lourdes
5. Tester en navigation privée

Monitoring performance​

// Console navigateur (F12)
console.log('ISAO Performance:', {
  loadTime: performance.now(),
  memory: performance.memory?.usedJSHeapSize,
  network: navigator.connection?.effectiveType
});

🆘 Escalade vers le support​

📋 Informations à préparer​

Contexte technique​

Informations système:
  - OS: Windows 11 / macOS Ventura / Ubuntu 22.04
  - Navigateur: Chrome 119.0 / Firefox 118.0
  - Résolution: 1920x1080
  - Extensions: Liste des extensions actives

Compte ISAO:
  - Email: votre@email.com
  - Plan: Starter/Business/Enterprise  
  - Employés actifs: Mike, Kim, David
  - Dernière action: Timestamp précis

Description problème​

## Description du problème
[Description claire et détaillée]

## Étapes pour reproduire
1. Première étape
2. Deuxième étape  
3. Résultat attendu vs obtenu

## Captures d'écran
[Joindre captures pertinentes]

## Actions déjà tentées
[Lister solutions déjà essayées]

## Impact business
[Urgence et nombre d'utilisateurs affectés]

📞 Méthodes de contact​

Par urgence​

🔴 Critique (service down):
  Canal: emergency@isao.io
  Réponse: < 1h
  Disponibilité: 24/7

🟠 Élevée (fonctionnalité majeure):
  Canal: Chat support
  Réponse: < 15min  
  Horaires: 9h-18h CET

🟡 Normale (questions/bugs mineurs):
  Canal: support@isao.io
  Réponse: < 4h
  SLA: 24h

💡 Astuce : La plupart des problèmes sont résolus en vidant le cache navigateur et en reconnectant les intégrations !

🔙 Retour à la FAQ | 💬 Contacter le support