Aller au contenu principal

Consentements vocaux

L'écran Consentements vocaux permet d'enregistrer et de révoquer le consentement de chaque participant d'une session vocale temps réel, et de lire la session, ses tours de parole et ses transcriptions filtrées par la DLP. Chemin du portail : /multimodal/consents. Les développeurs et les agents enregistrent les consentements ; les auditeurs et les responsables sécurité lisent les transcriptions.

Ce que montre l'écran​

Le titre de la page est Consentements temps réel. La section Session temps réel contient un champ Identifiant de session et le bouton Appliquer : collez l'identifiant renvoyé à la création de la session. Quatre onglets apparaissent alors :

  • Consentements : la table avec Participant, Finalité, Enregistrement autorisé, Transcription autorisée, Rétention (jours), Méthode, Recueilli par, Recueilli le, Révoqué le. Un clic sur une ligne ouvre un panneau avec le consentement.
  • Session : la fiche JSON de la session.
  • Tours de parole : Tour, Participant, Agent, Statut, Latence (ms), Identifiant de trace, Créé.
  • Transcriptions : Tour, Participant, Texte, Créé. Seul le texte filtré par la DLP est conservé.

Le formulaire Enregistrer un consentement contient Finalité (obligatoire), Rétention (jours) (obligatoire, 30, de 1 à 3650), Participant (vide : le participant de la session), Enregistrement autorisé (décoché), Transcription autorisée (cochée) et Méthode (verbal, click, written, api).

Actions​

Bouton ou actionCe qu'il faitAppel APIRôles
Appliquer puis ConsentementsListe les consentements de la sessionGET /v1/realtime/sessions/{session_id}/consentstout utilisateur du tenant
Enregistrer un consentement > CréerEnregistre le consentement, recueilli par vousPOST /v1/realtime/sessions/{session_id}/consentstenant_admin, developer, agent
Révoquer (menu de ligne, consentement non révoqué)Affiche la confirmation d'impact, puis révoque le consentement ; effet au prochain événement audioPOST /v1/realtime/sessions/{session_id}/consents/{consent_id}/revoketenant_admin, developer, agent
Onglet SessionLit la sessionGET /v1/realtime/sessions/{session_id}tout utilisateur du tenant
Onglet Tours de paroleListe les tours de paroleGET /v1/realtime/sessions/{session_id}/turnstout utilisateur du tenant
Onglet TranscriptionsListe les transcriptions conservéesGET /v1/realtime/sessions/{session_id}/transcriptstenant_admin, developer, auditor, security_officer

Rôles​

Enregistrer un consentement et Révoquer sont masqués pour les utilisateurs qui n'ont aucun des rôles de ROLES.consentWriters dans portal/src/lib/kit.ts (tenant_admin, developer, agent), la même liste que celle vérifiée par le Control Plane dans services/control-plane/src/eai/domains/realtime/__init__.py. Les transcriptions sont lues par tenant_admin, developer, auditor et security_officer. L'enregistrement d'un consentement passe par la décision de politique realtime.consent.record ; enregistrement et révocation sont audités.

Tâches courantes​

Enregistrer le consentement avant une transcription​

  1. Ouvrir la session. Les consentements appartiennent à une session. Collez l'Identifiant de session, puis Appliquer.

    Résultat attendu : les quatre onglets et la table Consentements.

    En cas d'échec : not_found avec realtime_session signifie que l'identifiant est faux.

  2. Enregistrer le consentement. Sans lui, transcription et enregistrement sont refusés hors dev et test. Cliquez sur Enregistrer un consentement, remplissez Finalité, Rétention (jours), cochez Transcription autorisée, choisissez la Méthode, puis Créer.

    Résultat attendu : le message « Créé » et la ligne avec Recueilli par à votre nom.

    En cas d'échec : session_ended signifie que la session est finie ; ouvrez-en une nouvelle.

Retirer un consentement​

  1. Le révoquer. Le participant peut se rétracter à tout moment. Ouvrez le menu de la ligne, choisissez Révoquer et confirmez.

    Résultat attendu : Révoqué le est rempli ; le prochain événement audio n'est plus transcrit.

    En cas d'échec : not_found avec realtime_consent signifie que le consentement est déjà révoqué.

Auditer ce qui a été dit​

  1. Lire les transcriptions. Ouvrez Transcriptions.

    Résultat attendu : le texte filtré par la DLP de chaque tour.

    En cas d'échec : forbidden signifie que votre rôle ne peut pas lire les transcriptions ; une liste vide signifie qu'aucun consentement n'a autorisé la transcription.

Dépannage​

SymptômeCauseCorrection
forbidden (403) avec required_rolesVotre rôle n'est pas autorisé pour cette actionVoir la section Rôles
parameter_invalid (422) avec methodMéthode de consentement inconnueUtilisez verbal, click, written ou api
session_ended (409) sur CréerLa session est terminéeEnregistrez le consentement sur une session ouverte
not_found (404) avec realtime_sessionMauvais identifiant de sessionCopiez l'identifiant affiché dans Voix en direct
not_found (404) avec realtime_consentLe consentement n'existe pas ou est déjà révoquéActualisez la table
consent_required (403) dans la session vocaleAucun consentement actif autorisant la transcription ou l'enregistrementEnregistrez un consentement ici

Pages liées​