Microphone

Aperçu

Le composant Avonni Microphone permet aux utilisateurs d'enregistrer de l'audio à l'aide du microphone d'un appareil au sein des composants dynamiques ou des Flow Salesforce. Il est conçu pour capturer des notes vocales, des enregistrements de réunions ou des retours audio, avec des options pour enregistrer les enregistrements en tant qu'objets ContentDocument Salesforce (fichiers).

• Capturer des notes vocales pour les interactions client sur les pages Compte/Contact.

• Enregistrer des résumés de réunion pour les dossiers de projet.

• Collecter des retours audio dans les cas de support ou les enquêtes.

• Consigner des instructions verbales pour les tâches de service sur le terrain.

• Stocker les enregistrements des sessions de formation liés à des objets personnalisés.

Configuration

Sélectionnez le composant Microphone sur le canevas pour accéder aux propriétés dans le panneau de propriétés à droite.

Propriétés de base

Celles-ci contrôlent le comportement de l'enregistrement et la gestion des données.

Propriété	Type	Description	Exemple
Nom API	Texte	Identifiant unique pour l'instance.	MicRecorder
Enregistrer en tant que Content Document	Booléen	Si activé, enregistre l'enregistrement en tant que ContentDocument (fichier) dans Salesforce.	Activé
Autoriser plusieurs enregistrements	Booléen	Si activé, permet plusieurs enregistrements dans une seule session, enregistrés en tant que ContentDocuments.	Désactivé
Valeur	Liaison	Stocke les données audio enregistrées (accessible via $Component.MicRecorder.Value).	Lier à une variable pour le traitement
Afficher le visualiseur	Booléen	Affiche une forme d'onde audio en temps réel pendant l'enregistrement.	Activé

Bonne pratique : Activez Enregistrer en tant que Content Document pour un stockage persistant ; utilisez Afficher le visualiseur pour un retour utilisateur pendant l'enregistrement.

Paramètres du Content Document (actif si Enregistrer en tant que Content Document est activé)

Ceux-ci configurent la façon dont les enregistrements sont enregistrés en tant que fichiers.

Propriété	Type	Description	Exemple
Titre du Content Document	Texte	Titre du fichier ContentDocument enregistré.	"Meeting_Note_{!Record.Id}"
Id de l'entité liée du Content Document	Texte/Liaison	ID de l'enregistrement pour lier le fichier (par ex., Compte, Cas).	{!Record.Id}

Section des libellés

Personnalisez le texte des éléments de l'interface utilisateur.

Propriété	Type	Description	Exemple
Libellé Prêt	Texte	Texte lorsque prêt à enregistrer.	"Commencer l'enregistrement"
Libellé Enregistrement	Texte	Texte pendant l'enregistrement actif.	"Enregistrement…"
Libellé du bouton Pause	Texte	Texte pour le bouton pause.	"Pause"
Libellé du bouton Annuler	Texte	Texte pour le bouton annuler.	"Annuler"

Onglet Interactions

Définir des actions à la fin de l'enregistrement.

Propriété	Type	Description
Au clic du bouton Enregistrer sous	Paramètres	Déclencher à l'enregistrement : utilisez $Component.MicRecorder.Value pour les données audio (par ex., Afficher Toast, Naviguer, Mettre à jour un enregistrement).

Exemples

Exemple 1 : Note vocale unique pour Cas

Cet exemple enregistre une note vocale pour un Cas et l'enregistre en tant que fichier.

1. Configurer le Microphone :

   • Nom API : CaseNoteRecorder

   • Enregistrer en tant que Content Document : Activé

   • Titre du Content Document : "Case_Note_{!Record.Id}"

   • Id de l'entité liée du Content Document : {!Record.Id} (lié au Cas)

   • Afficher le visualiseur : Activé

   • Libellé Prêt : "Enregistrer la note"

   • Libellé Enregistrement : "Enregistrement de la note..."

   • Libellé du bouton Pause : "Pause"

   • Libellé du bouton Annuler : "Arrêter"

2. Ajouter une interaction :

   • Au clic du bouton Enregistrer sous : Afficher un toast avec le message "Note vocale enregistrée pour le Cas."

Résultat : Les utilisateurs enregistrent une note, voient une forme d'onde et l'enregistrent en tant que ContentDocument lié au Cas, avec un toast de confirmation.

Exemple 2 : Plusieurs enregistrements de retours

Cet exemple permet plusieurs enregistrements audio de retours pour une enquête.

1. Configurer le Microphone :

   • Nom API : FeedbackRecorder

   • Enregistrer en tant que Content Document : Activé

   • Autoriser plusieurs enregistrements : Activé

   • Titre du Content Document : "Feedback_{!Record.Id}_{$System.Timestamp}"

   • Id de l'entité liée du Content Document : {!Record.Id}

   • Afficher le visualiseur : Activé

   • Libellé Prêt : "Commencer le retour"

   • Libellé du bouton Annuler : "Terminer"

2. Ajouter une interaction :

   • Au clic du bouton Enregistrer sous : Ajouter $Component.FeedbackRecorder.Value à une variable de collection ; actualiser un composant Liste pour afficher les fichiers enregistrés.

Résultat : Les utilisateurs enregistrent plusieurs extraits de retour, chacun enregistré en tant que ContentDocument, avec une liste mise à jour pour afficher tous les enregistrements.

Considérations clés

• Stockage des données : Activez Enregistrer en tant que Content Document pour conserver l'audio sous forme de fichiers ; liez l'ID de l'entité liée aux enregistrements pertinents.

• Enregistrements multiples : Utilisez Autoriser plusieurs enregistrements pour les scénarios en masse ; assurez-vous que les titres sont uniques (par ex., incluez des horodatages).

• Visualiseur : Activez pour un retour en temps réel, notamment sur les appareils mobiles.

• Interactions : Utilisez $Component.API_Name.Value pour les données audio dans les flux ou les mises à jour ; testez les limites de stockage des fichiers.

• Libellés : Personnalisez pour plus de clarté ; assurez-vous que Pause/Annuler sont intuitifs pour les utilisateurs.

• Accessibilité : Fournissez un texte de libellé clair ; testez la compatibilité du visualiseur avec les lecteurs d'écran.

Dépannage des problèmes courants

• Le enregistreur ne s'ouvre pas : Vérifiez les autorisations du microphone de l'appareil ; assurez-vous qu'il n'est pas désactivé.

• Aucun audio enregistré : Vérifiez que Enregistrer en tant que Content Document est activé ; vérifiez les liaisons du Titre du Content Document/ID de l'entité liée.

• Échec des enregistrements multiples : Assurez-vous que Autoriser plusieurs enregistrements est activé ; testez les quotas de stockage.

• Visualiseur manquant : Activez/désactivez Afficher le visualiseur ; vérifiez la compatibilité du navigateur.

• Erreurs d'interaction : Confirmez la liaison $Component.API_Name.Value ; testez avec des données statiques.

• Encombrement de l'interface : Ajustez le texte des libellés pour la brièveté ; testez sur mobile pour la visibilité des boutons.

Résumé

Le composant Avonni Microphone simplifie la capture audio dans Salesforce, avec des options pour des enregistrements uniques ou multiples, le stockage de fichiers et des interactions dynamiques. Il est parfait pour les notes vocales, les retours ou la documentation.