Installer REDA AI et activer votre licence
Financement et utilisation de l’IA
IA incluse utilise des crédits REDA. Votre propre IA utilise le compte fournisseur de votre organisation, facturé directement par ce fournisseur. La licence définit un mode pour toute l’organisation. Dans les deux cas, REDA AI gouverne les outils et actions configurés dans Salesforce. Configurer la licence et les comptes IA.
Consultez offres, prix, conditions d’essai et recharges actuels sur la page des tarifs REDA AI. Les exemples et chiffres d’utilisation de ce guide expliquent le fonctionnement ; ils ne constituent pas un devis.
Ce guide présente l’installation du package REDA AI, l’attribution des autorisations, l’activation de la licence et la préparation d’un premier agent. Suivez les étapes, puis vérifiez les résultats dans votre organisation avant d’ouvrir les accès aux utilisateurs.
Prérequis
Avant de commencer, préparez les éléments suivants :
- Une organisation Salesforce, sandbox ou production.
- Les droits d’administration nécessaires pour installer les packages et attribuer les ensembles d’autorisations.
- Votre clé de licence REDA AI, fournie par l’équipe commerciale, pour l’offre à activer.
- L’accès à votre messagerie Salesforce pour consulter les confirmations d’installation et les messages utiles au suivi.
Étape 1 : installer le package REDA AI
Option A : depuis AppExchange
- Connectez-vous à Salesforce avec un utilisateur disposant des droits d’installation nécessaires.
- Ouvrez AppExchange — Accédez à https://appexchange.salesforce.com et recherchez « REDA AI ». Utilisez la fiche et la version validées pour votre installation.
- Lancez l’installation depuis la fiche — Si la fiche propose « Get It Now », utilisez ce bouton ou son équivalent dans la langue de l’interface.
- Sélectionnez votre organisation — Choisissez la sandbox ou l’organisation de production dans laquelle vous souhaitez installer REDA AI.
- Lisez les conditions et installez — Examinez les conditions applicables, acceptez-les si vous êtes habilité à le faire, puis suivez l’action d’installation proposée.
- Attendez la fin de l’installation — REDA AI est un package géré. La durée de 5 à 15 minutes citée dans ce guide est indicative ; elle dépend du traitement Salesforce. Consultez la confirmation et vérifiez le package installé.
Option B : lien d’installation direct
REDA peut vous fournir une URL d’installation directe. Ouvrez ce lien avec l’organisation cible appropriée et suivez les étapes proposées, en vérifiant la version et les dépendances avant installation.
Étape 2 : vérifier l’installation
Après la fin du traitement :
- Ouvrez le Lanceur d’applications — Cliquez sur l’icône en grille en haut à gauche de Salesforce.
- Recherchez REDA AI — Saisissez « REDA AI » dans la zone de recherche.
- Ouvrez REDA AI — Vérifiez que l’application s’affiche, puis contrôlez le package et sa version dans les packages installés. L’ouverture de l’application ne prouve pas à elle seule que la licence, les données et tous les accès sont prêts. En cas d’erreur, consultez les diagnostics ci-dessous.
Si REDA AI n’apparaît pas, utilisez Afficher tout dans le Lanceur d’applications, puis recherchez son nom : la liste courte ne présente qu’une partie des applications. Si elle reste absente après Afficher tout, faites vérifier l’installation, les licences et la visibilité de l’application dans les droits effectifs, notamment les ensembles REDA AI. Consultez Accès à l’application et autorisations.
Étape 3 : attribuer les ensembles d’autorisations
Attribuez aux utilisateurs les accès nécessaires à leurs tâches. Les deux principaux ensembles d’autorisations du package sont les suivants ; leurs noms restent en anglais :
Ensemble REDA AI Admin
Pour les administrateurs chargés des agents, des outils et du suivi de l’utilisation :
- Ouvrez la Configuration Salesforce — Cliquez sur l’engrenage, puis sur Configuration.
- Accédez aux ensembles d’autorisations — Dans Recherche rapide, recherchez « Ensembles d’autorisations » et ouvrez le résultat.
- Ouvrez REDA AI Admin — Recherchez cet ensemble dans la liste.
- Gérez les attributions — Sur l’ensemble REDA AI Admin, ouvrez « Gérer les attributions ».
- Ajoutez les administrateurs — Utilisez « Ajouter des attributions », sélectionnez les personnes habilitées, puis attribuez l’ensemble. Un ou deux administrateurs de confiance peuvent suffire dans une petite équipe ; adaptez ce nombre à votre organisation.
Ensemble REDA AI User
Pour les utilisateurs qui échangent avec les agents sans administrer leur configuration :
- Ouvrez les ensembles d’autorisations dans Configuration, comme à l’étape précédente.
- Ouvrez REDA AI User — Recherchez cet ensemble dans la liste.
- Gérez les attributions — Sur l’ensemble REDA AI User, ouvrez « Gérer les attributions ».
- Ajoutez les utilisateurs — Utilisez « Ajouter des attributions », sélectionnez les utilisateurs concernés, puis attribuez l’ensemble.
Étape 4 : activer votre clé de licence
Ouvrez Lanceur d’application → REDA AI → REDA AI Admin → License & Credits. Collez la clé REDA et choisissez Activate Key, puis vérifiez Plan Details et le financement actif. Avec votre propre IA, créez et testez d’abord une connexion par défaut active dans AI Connections, et vérifiez la connexion et le modèle des agents actifs. Suivre le guide complet.
Activate Free Tier démarre l’essai avec IA incluse. Demandez une clé d’essai avec votre propre IA à REDA ; les frais du fournisseur s’appliquent toujours. Consultez les conditions d’essai actuelles.
Étape 5 : préparer un premier agent, si nécessaire
Avec une licence valide et les droits requis, vous pouvez créer un agent. Voici un parcours de départ :
- Ouvrez « Définitions des agents » dans l’application REDA AI.
- Cliquez sur « Nouveau » pour créer une définition d’agent.
- Renseignez son nom et sa description — Choisissez un nom clair, par exemple « Assistant du support client », et précisez son rôle.
- Renseignez les instructions de l’agent — Par exemple : « Vous êtes un assistant du support client. Répondez aux questions concernant nos produits et nos services. » Complétez les règles et le contexte nécessaires à votre usage.
- Configurez le canal — Choisissez une valeur prise en charge : Interne, API, Communauté ou Widget externe, selon le parcours prévu. Slack et Teams ne sont pas des valeurs natives de ce champ ; une intégration distincte doit être vérifiée avant d’en annoncer la disponibilité.
- Enregistrez l’agent en préparation — Vérifiez « Est actif » et décochez-le pour conserver l’agent désactivé pendant sa préparation. Dans les métadonnées consultées, cette case est cochée par défaut : ne supposez pas qu’un nouvel enregistrement est automatiquement inactif.
- Activez l’agent pour les essais prévus — Lorsque ses paramètres sont prêts, cochez « Est actif », enregistrez puis vérifiez son accès dans le canal choisi. La licence, les limites, les autorisations et la configuration du canal restent nécessaires.
Étape 6 : tester d’abord en sandbox
Avant d’ouvrir REDA AI aux utilisateurs de production, vérifiez les parcours dans votre sandbox, un environnement de test isolé :
- Créez des agents de test : utilisez des instructions simples pour vérifier les premières réponses.
- Testez chaque canal prévu : par exemple Interne, API, Communauté ou Widget externe, ainsi que toute intégration supplémentaire réellement configurée.
- Consultez les journaux d’incidents : examinez les erreurs éventuelles et vérifiez leur résolution.
- Mesurez les crédits consommés : relevez la consommation de conversations représentatives.
- Recueillez les retours : faites tester les agents par des utilisateurs représentatifs et évaluez la qualité des réponses.
Après validation des essais, préparez le déploiement autorisé dans l’organisation de production avec sa propre clé et ses paramètres, puis refaites les vérifications nécessaires.
Après l’activation
- Configurer les outils : préparez les requêtes Salesforce et les API externes nécessaires aux agents, avec leurs autorisations. Consultez Comprendre les outils.
- Définir les champs de contexte : fournissez aux agents les données pertinentes d’utilisateur ou d’enregistrement, selon les droits et les besoins du parcours. Consultez Comprendre les champs de contexte.
- Configurer les canaux : préparez les parcours natifs et les éventuelles intégrations retenues. Consultez Canal interne pour l’utilisation dans Salesforce.
- Préparer les actions planifiées : configurez les actions autorisées que les agents pourront programmer, selon leurs outils, par exemple une intervention sur un enregistrement ou un envoi d’e-mail. Consultez Actions planifiées.
- Suivre l’utilisation : consultez régulièrement l’administration pour contrôler les crédits, comparer la consommation au budget et recharger si nécessaire.
Résoudre les problèmes d’activation
Message : « Clé de licence invalide. Veuillez vérifier et réessayer. »
Causes à examiner :
- La licence ou sa période de validité est expirée ; vérifiez les informations fournies par REDA.
- La clé ne correspond pas à l’organisation cible, notamment après un changement d’environnement ou une actualisation de sandbox.
- La clé a été mal copiée, comporte des caractères ajoutés ou utilise un format invalide.
- La clé est liée à une autre organisation ; ce n’est pas une clé librement transférable entre organisations.
Résolution : vérifiez la clé et l’organisation concernée. Si nécessaire, contactez le support REDA par son canal sécurisé avec l’identifiant de l’organisation et la référence de licence ; ne diffusez pas la clé complète dans une capture ou un échange non sécurisé.
Échec de connexion ou activation sans résultat visible
Causes à examiner :
- La connexion du navigateur à Salesforce a été interrompue pendant la demande ou le rafraîchissement de la page.
- L’enregistrement en arrière-plan dans Salesforce est encore en attente ou a échoué ; consultez le résultat et les droits nécessaires à cette opération.
- Une connexion réseau instable empêche l’interface d’afficher le résultat actualisé.
Résolution : vérifiez la connexion et le statut de l’activation avant de recommencer. La validation documentée est effectuée par le package dans Salesforce ; elle ne dépend pas d’un serveur d’activation REDA externe. Si l’état reste incertain, faites examiner les messages et le traitement par votre administrateur ou le support.
Accès refusé ou onglet d’administration absent
Cause possible : les droits d’administration, d’accès à l’application ou de visibilité de l’onglet sont insuffisants. Vérifiez REDA AI Admin ainsi que les autres droits et licences requis ; le nom d’un ensemble n’est pas à lui seul une preuve d’accès effectif.
Résolution : faites corriger les attributions par un administrateur habilité, puis actualisez votre session ou reconnectez-vous si nécessaire. Vérifiez ensuite l’onglet et l’action précise qui échouait.
Échec de l’installation du package
Causes à examiner :
- Les exigences de version, d’édition ou les dépendances du package ne sont pas satisfaites.
- Un composant existant ou une personnalisation entre en conflit avec l’installation.
- L’utilisateur ne dispose pas des droits nécessaires à l’installation.
Résolution : transmettez au support REDA le message exact, l’édition Salesforce, la version du package et les dépendances concernées pour établir le diagnostic.
Questions fréquentes
Les durées de 5 à 15 minutes pour l’installation et de 5 à 30 secondes pour l’activation sont indicatives. Salesforce peut prendre plus de temps. La clé est validée par le package, puis enregistrée en arrière-plan : vérifiez les détails de l’offre et le statut actif. Si le traitement reste en attente ou échoue, consultez le message et les droits nécessaires avant de relancer ou de contacter le support.
Oui. Installez et activez REDA AI dans la sandbox avec la clé prévue pour cette organisation. Testez les agents, les canaux, les outils et les droits. Après validation, préparez l’installation et l’activation autorisées en production avec sa propre clé et sa configuration, puis contrôlez les résultats.
Contactez le support REDA avec l’organisation concernée et la référence de la licence, par le canal sécurisé prévu. Faites vérifier l’état réellement enregistré et la clé appropriée avant toute modification. Ne publiez pas la clé complète et ne supprimez pas des paramètres de licence pour essayer de corriger le problème sans diagnostic.
Oui, pour accéder à Salesforce et pour les appels aux services d’IA nécessaires au fonctionnement des agents. Faites vérifier les destinations, les autorisations et la configuration réseau réellement utilisées par votre version. Le parcours d’activation décrit valide la clé dans Salesforce puis l’enregistre en arrière-plan ; il ne justifie pas d’autoriser un domaine générique présenté comme serveur d’activation externe.