Afficher les listes sous forme de cartes

Lorsqu’un agent REDA AI présente des enregistrements dans une conversation — requêtes ouvertes, créneaux disponibles, résultats de recherche ou lignes de détail — il utilise une liste de cartes natives. Chaque carte comporte un titre en gras, des informations complémentaires et, éventuellement, des badges de statut colorés et un bouton d’action. La présentation est cohérente dans Lightning, Experience Cloud et les widgets Web externes, que l’utilisateur soit connecté à Salesforce ou sur votre site public.

Contenu d’une carte

Chaque carte peut comporter :

• Titre : l’information la plus identifiable, comme le nom de l’enregistrement, l’objet de la requête ou la description du créneau.
• Sous-titre : une seconde ligne, généralement un numéro d’enregistrement et une date.
• Photos et vidéo facultatives : images et, éventuellement, lien vidéo ou visite virtuelle dans un diaporama en haut de la carte. Consultez Photos et vidéo.
• Badges : petites pastilles de statut, priorité ou type. La palette est fixe : info, bleu de marque ; success, vert ; warning, orange ; danger, rouge ; neutral, gris. Gardez des libellés courts.
• Corps facultatif : description d’une ligne lorsque le titre ne fournit pas assez de contexte.
• Bouton d’action facultatif : libellé cliquable, par exemple « Détails de la requête 00001137 » ou « Planifier à 10 h ». Au clic, ce texte devient le prochain message de l’utilisateur. Il doit donc constituer une instruction autonome, pas un simple verbe tel que « Voir ».

Une réponse est limitée à 10 cartes. Si les résultats sont plus nombreux, l’agent résume les autres après la liste et propose de préciser la recherche.

Photos et vidéo

Les cartes peuvent intégrer des visuels. Lorsqu’un enregistrement possède des photos — bien immobilier, produit, pièce ou site — l’agent peut les afficher dans un diaporama au-dessus du titre. La liste devient une galerie facile à parcourir, qui permet d’évaluer une annonce sans ouvrir chaque enregistrement.

• Une photo apparaît comme une image de couverture unique.
• Plusieurs photos forment un diaporama à faire défiler, avec un compteur dans l’angle, par exemple « 4 ».
• Vidéos et visites virtuelles apparaissent comme une vignette de lecture. Un clic ouvre la vidéo ou la visite dans un nouvel onglet : fichier vidéo hébergé, lien YouTube ou Vimeo, ou visite de type Matterport.
• Les photos précèdent les vignettes vidéo dans le même diaporama. Une carte contient au maximum 10 éléments multimédias.

Parcourir le diaporama

Deux modes de navigation sont disponibles pour s’adapter à l’appareil :

• Sur ordinateur : des flèches gauche et droite permettent d’avancer image par image, avec retour au début après la dernière.
• Sur écran tactile et dans Salesforce mobile : balayez vers la gauche ou la droite pour passer à l’image suivante. Les flèches restent présentes, avec une zone de toucher plus grande.

Le comportement est identique dans la conversation Salesforce, le widget de communauté et le widget Web. Le canal API sans interface ne montre ni cartes ni médias : consultez Où les cartes s’affichent.

Vérifier l’affichage des images

Dans la conversation Salesforce interne, chaque adresse d’image doit respecter deux conditions :

• Utiliser HTTPS, avec une adresse https:// sécurisée. Les adresses http:// ou non Web sont ignorées ; la carte reste affichée sans l’image.
• Le domaine doit être autorisé par la politique de sécurité du contenu Salesforce. Les images de Salesforce Files et de services comme Cloudinary peuvent être couvertes par les domaines déjà configurés ; vérifiez les autorisations effectives de votre organisation.

Si les photos d’un autre domaine n’apparaissent pas, ajoutez ce domaine comme source d’images autorisée. Cette opération n’est nécessaire qu’une fois par domaine :

1. Ouvrez Configuration → Sécurité → Sites de confiance CSP.
2. Choisissez Nouveau site de confiance et saisissez le domaine d’images, par exemple https://images.yourcompany.com.
3. Dans les directives CSP, activez img-src, puis enregistrez.

Où les cartes s’affichent

Comment l’agent choisit les cartes

Les cartes font partie des consignes de présentation par défaut de REDA AI. Sur les interfaces de conversation — interne, communauté et widget externe — les agents privilégient les cartes pour les enregistrements, les puces pour les courtes listes informatives et les tableaux pour les agrégats, comme les totaux par catégorie, lorsqu’une comparaison en colonnes est utile.

Le canal API sans interface ne rend pas de cartes. Les systèmes appelants reçoivent des réponses en texte brut ou structurées.

Concevoir de bons libellés d’action

Les libellés deviennent des messages de conversation. Lorsque l’utilisateur clique sur « Détails de la requête 00001137 », ce texte exact est envoyé à l’agent, qui dispose ainsi du contexte nécessaire.

Un bon libellé est :

• Autonome : « Détails de la requête 00001137 », plutôt que « Détails ».
• Précis : il cite un numéro, un nom ou un champ d’identification pour éviter à l’agent de deviner l’élément concerné.
• Court : visez moins de 50 caractères pour limiter les retours à la ligne.
• Orienté vers l’action : commencez par un verbe comme « Ouvrir », « Planifier », « Annuler » ou « Confirmer ».

Affichage pendant la diffusion en continu

Pendant que la réponse arrive progressivement, la liste de cartes en cours est masquée jusqu’à sa complétude. L’utilisateur voit d’abord le texte d’introduction, puis un bloc de cartes terminé, sans affichage partiel ni scintillement.

Personnaliser l’apparence

Les cartes reprennent les couleurs et la typographie du widget. Les réglages de personnalisation de l’interface du widget s’appliquent automatiquement : couleur principale pour les badges et boutons, texte neutre pour les titres et descriptions. Aucun thème de cartes séparé n’est nécessaire.

L’espacement, les coins arrondis et les formes des badges restent fixes pour assurer la cohérence entre interfaces. Si votre marque exige une autre présentation, contactez l’assistance REDA AI pour examiner les options.

Limites

• Maximum 10 cartes par liste. Les résultats supplémentaires sont résumés dans le texte.
• Maximum 10 médias par carte, photos et vignettes vidéo réunies.
• Les photos dans Salesforce interne doivent utiliser https:// sur un domaine autorisé. Vérifiez les domaines existants ou ajoutez-les dans les sites de confiance CSP. Consultez Vérifier l’affichage des images.
• Les vidéos s’ouvrent dans un nouvel onglet ; elles ne sont ni intégrées ni lues automatiquement dans la conversation.
• Les cartes sont en lecture seule, hormis leur bouton. Les champs ne peuvent pas être modifiés directement.
• Les cartes ne s’affichent pas sur le canal API sans interface.
• Le libellé d’action devient un message au clic, pas une action rapide indépendante. Il doit être exploitable comme instruction de conversation.

Actions d’e-mail, d’enregistrement et de planification

Les actions d’e-mail distinguent le destinataire Contact ou Piste de l’enregistrement métier associé, acceptent des listes À/Cc et vérifient les cas de refus d’e-mail pris en charge. Un Contact/Piste fourni comme enregistrement associé est traité comme destinataire. Les confirmations montrent les champs non appliqués. Les étapes du plan sont rapprochées une à une et les heures relatives conservent UTC. Les agents désactivés et actions imbriquées non autorisées sont vérifiés avant confirmation. La confirmation de liaison de fichiers réutilise le chemin avec contrôle d’accès. Les nouvelles actions horaires en attente ou replanifiées exigent un processeur disponible ; suivi des réponses et mises à jour normales d’historique/statut restent valides. Les travaux différés utilisent leur propriétaire de planification, sans usurper le demandeur. Les instructions réduisent les doublons via d’autres connecteurs, sans garantir le comportement de l’assistant.