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 action | Ce qu'il fait | Appel API | Rôles |
|---|---|---|---|
| Appliquer puis Consentements | Liste les consentements de la session | GET /v1/realtime/sessions/{session_id}/consents | tout utilisateur du tenant |
| Enregistrer un consentement > Créer | Enregistre le consentement, recueilli par vous | POST /v1/realtime/sessions/{session_id}/consents | tenant_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 audio | POST /v1/realtime/sessions/{session_id}/consents/{consent_id}/revoke | tenant_admin, developer, agent |
| Onglet Session | Lit la session | GET /v1/realtime/sessions/{session_id} | tout utilisateur du tenant |
| Onglet Tours de parole | Liste les tours de parole | GET /v1/realtime/sessions/{session_id}/turns | tout utilisateur du tenant |
| Onglet Transcriptions | Liste les transcriptions conservées | GET /v1/realtime/sessions/{session_id}/transcripts | tenant_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
-
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_foundavecrealtime_sessionsignifie que l'identifiant est faux. -
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_endedsignifie que la session est finie ; ouvrez-en une nouvelle.
Retirer un consentement
-
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_foundavecrealtime_consentsignifie que le consentement est déjà révoqué.
Auditer ce qui a été dit
-
Lire les transcriptions. Ouvrez Transcriptions.
Résultat attendu : le texte filtré par la DLP de chaque tour.
En cas d'échec :
forbiddensignifie 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ôme | Cause | Correction |
|---|---|---|
forbidden (403) avec required_roles | Votre rôle n'est pas autorisé pour cette action | Voir la section Rôles |
parameter_invalid (422) avec method | Méthode de consentement inconnue | Utilisez verbal, click, written ou api |
session_ended (409) sur Créer | La session est terminée | Enregistrez le consentement sur une session ouverte |
not_found (404) avec realtime_session | Mauvais identifiant de session | Copiez l'identifiant affiché dans Voix en direct |
not_found (404) avec realtime_consent | Le consentement n'existe pas ou est déjà révoqué | Actualisez la table |
consent_required (403) dans la session vocale | Aucun consentement actif autorisant la transcription ou l'enregistrement | Enregistrez un consentement ici |