Dépannage

Aperçu

Ce guide vous aide à résoudre les problèmes courants qui peuvent survenir lors du travail avec l'Assistant Optave pour Salesforce.

Problèmes Courants

Problèmes d'Authentification

Problème : Impossible de s'authentifier ou de récupérer le token JWT

Résolution :

1. Vérifier que les Named Credentials sont correctement configurés
2. Vérifier que les External Credentials ont le bon ID client et secret client
3. S'assurer que la formule dans l'en-tête Authorization est correctement formatée

Problèmes de Connexion WebSocket

Problème : La connexion WebSocket échoue ou se déconnecte fréquemment

Résolution :

1. Vérifier l'URL WebSocket dans l'enregistrement Custom Metadata
2. Vérifier la console du navigateur pour les erreurs liées à CORS
3. S'assurer que l'URL WebSocket est accessible depuis votre org Salesforce
4. Vérifier la connectivité réseau et tout paramètre proxy qui pourrait affecter les connexions WebSocket

Problèmes de CORS et Liste Blanche

Problème : Restrictions Cross-Origin Resource Sharing (CORS)

Résolution :

1. Naviguer vers Configuration > CORS dans votre org Salesforce
2. Ajouter tous les domaines nécessaires à la liste blanche :
   • Domaine API Optave
   • Domaine WebSocket
   • Toute autre ressource externe utilisée par l'assistant
3. Redémarrer votre navigateur après avoir effectué les changements

Problèmes de Mise à Jour des Dépendances

Problème : Problèmes après la mise à jour des bibliothèques ou packages dépendants

Résolution :

1. Puisque Salesforce ne supporte pas les packages npm directement, toute mise à jour des dépendances doit être téléchargée manuellement comme fichiers minifiés vers les Ressources Statiques. Par exemple, pour une nouvelle version du SDK JavaScript Optave, minifiez manuellement le SDK (ou installez le package npm dans un projet de test et localisez le fichier à node_modules/@optave/dist/optave.client.sdk.js) puis téléchargez-le.
2. S'assurer de la compatibilité entre toutes les versions de bibliothèques
3. Vider le cache du navigateur après la mise à jour des ressources statiques