> ## Documentation Index
> Fetch the complete documentation index at: https://translations.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# MfaVoiceChallenge

> Décrit toutes les propriétés et méthodes disponibles pour personnaliser l’écran `mfa-voice-challenge` dans Universal Login.

La classe MfaVoiceChallenge implémente la fonctionnalité de l’écran `mfa-voice-challenge`. Cet écran s’affiche lorsque l’utilisateur doit saisir un code reçu par appel vocal pour vérifier son identité.

<Frame>
  <img style={{maxHeight:"400px"}} src="https://mintcdn.com/translations/MV7tE-x71x8RWRES/docs/images/cdy7uua7fh8z/5L3KKdJ5negUbZJueVaMi8/ee711dc884da655088a63bb116f277f9/Screenshot_2025-04-23_at_18.17.24.png?fit=max&auto=format&n=MV7tE-x71x8RWRES&q=85&s=92f09b9dfb3324bdf60b3bce5b317d4a" alt="MfaVoiceChallenge" width="363" height="532" data-path="docs/images/cdy7uua7fh8z/5L3KKdJ5negUbZJueVaMi8/ee711dc884da655088a63bb116f277f9/Screenshot_2025-04-23_at_18.17.24.png" />
</Frame>

<div id="constructors">
  ## Constructeurs
</div>

Créez une instance du gestionnaire de l’écran MFA Voice Challenge :

```typescript Example theme={null}
import MfaVoiceChallenge from '@auth0/auth0-acul-js/mfa-voice-challenge';

const mfaVoiceChallenge = new MfaVoiceChallenge();
await mfaVoiceChallenge.continue({ code: '123456' });
```

<div id="properties">
  ## Propriétés
</div>

<ParamField body="branding" type={<span><a href="/fr-CA/docs/libraries/acul/js-sdk/Screens/interfaces/BrandingMembers">BrandingMembers</a></span>}>
  Fournit des configurations d’image de marque, comme le thème et les paramètres associés.
</ParamField>

<ParamField body="client" type={<span><a href="/fr-CA/docs/libraries/acul/js-sdk/Screens/interfaces/ClientMembers">ClientMembers</a></span>}>
  Fournit des configurations liées à l’application, comme `id`, `name` et `logoUrl`, pour l’écran `mfa-voice-challenge`.
</ParamField>

<ParamField body="organization" type={<span><a href="/fr-CA/docs/libraries/acul/js-sdk/Screens/interfaces/OrganizationMembers">OrganizationMembers</a></span>}>
  Fournit des renseignements sur l’organisation de l’utilisateur, comme `id` et `name`.
</ParamField>

<ParamField body="prompt" type={<span><a href="/fr-CA/docs/libraries/acul/js-sdk/Screens/interfaces/PromptMembers">PromptMembers</a></span>}>
  Contient des données sur l’invite en cours dans le flux d’authentification.
</ParamField>

<ParamField body="screen" type={<span><a href="/fr-CA/docs/libraries/acul/js-sdk/Screens/interfaces/ScreenMembersOnMfaVoiceChallenge">ScreenMembersOnMfaVoiceChallenge</a></span>}>
  Contient des détails propres à l’écran `mfa-voice-challenge`, y compris sa configuration et son contexte.
</ParamField>

<ParamField body="tenant" type={<span><a href="/fr-CA/docs/libraries/acul/js-sdk/Screens/interfaces/TenantMembers">TenantMembers</a></span>}>
  Contient des données liées au locataire, comme `id` et les métadonnées associées.
</ParamField>

<ParamField body="transaction" type={<span><a href="/fr-CA/docs/libraries/acul/js-sdk/Screens/interfaces/TransactionMembers">TransactionMembers</a></span>}>
  Fournit des données propres à la transaction pour l’écran `mfa-voice-challenge`, comme les identifiants actifs et les états du flux.
</ParamField>

<ParamField body="untrustedData" type={<span><a href="/fr-CA/docs/libraries/acul/js-sdk/Screens/interfaces/UntrustedDataMembersOnMfaVoiceChallenge">UntrustedDataMembersOnMfaVoiceChallenge</a></span>}>
  Gère les données non fiables transmises au SDK, comme les saisies de l’utilisateur lors de la vérification vocale MFA.
</ParamField>

<ParamField body="user" type={<span><a href="/fr-CA/docs/libraries/acul/js-sdk/Screens/interfaces/UserMembers">UserMembers</a></span>}>
  Renseignements sur l’utilisateur actif, y compris `username`, `email` et `roles`.
</ParamField>

<div id="methods">
  ## Méthodes
</div>

<ParamField body="changeLanguage" type="Promise<void>">
  Cette méthode modifie la langue d’affichage de la page Universal Login.

  ```typescript Example theme={null}
  import MfaVoiceChallenge from '@auth0/auth0-acul-js/mfa-voice-challenge';

  const mfaVoiceChallenge = new MfaVoiceChallenge();
  mfaVoiceChallenge.changeLanguage({
    language: 'fr',
  });
  ```

  **Paramètres de la méthode**

  <Expandable title="Paramètres">
    <ParamField body="options">
      [LanguageChangeOptions](/fr-CA/docs/libraries/acul/js-sdk/Screens/interfaces/LanguageChangeOptions).
    </ParamField>

    <ParamField body="language" type="string" required>
      Le code de paramètre régional de la langue souhaitée (par exemple, `'en'`, `'fr'`, `'es'`).
    </ParamField>

    <ParamField body="persist?" type="&#x22;session&#x22;">
      Lorsqu’elle est définie sur `'session'`, la langue sélectionnée est conservée pendant toute la session.
    </ParamField>
  </Expandable>
</ParamField>

<ParamField body="continue" type="Promise<void>">
  Cette méthode soumet le code de vérification vocale pour valider le défi MFA.

  ```typescript Example theme={null}
  import MfaVoiceChallenge from '@auth0/auth0-acul-js/mfa-voice-challenge';

  const mfaVoiceChallenge = new MfaVoiceChallenge();
  await mfaVoiceChallenge.continue({
    code: '123456',
    rememberDevice: true,
  });
  ```

  **Paramètres de la méthode**

  <Expandable title="Paramètres">
    <ParamField body="options">
      [MfaVoiceChallengeContinueOptions](/fr-CA/docs/libraries/acul/js-sdk/Screens/interfaces/MfaVoiceChallengeContinueOptions).
    </ParamField>

    <ParamField body="code" type="string" required>
      Le code de vérification reçu par appel vocal.
    </ParamField>

    <ParamField body="rememberDevice?" type="boolean">
      Lorsque `true`, le navigateur est mémorisé pour les futurs défis MFA. S’applique uniquement si `screen.showRememberDevice` est `true`.
    </ParamField>
  </Expandable>
</ParamField>

<ParamField body="getErrors" type={<span><a href="/fr-CA/docs/libraries/acul/js-sdk/Screens/interfaces/Error">Error</a>[]</span>}>
  Cette méthode récupère le tableau des erreurs de transaction à partir du contexte, ou un tableau vide s’il n’y en a aucune.
</ParamField>

<ParamField body="pickPhone" type="Promise<void>">
  Cette méthode accède à l’écran où l’utilisateur peut sélectionner un autre numéro de téléphone.

  ```typescript Example theme={null}
  import MfaVoiceChallenge from '@auth0/auth0-acul-js/mfa-voice-challenge';

  const mfaVoiceChallenge = new MfaVoiceChallenge();
  await mfaVoiceChallenge.pickPhone();
  ```
</ParamField>

<ParamField body="resendCode" type="Promise<void>">
  Cette méthode demande un nouvel appel vocal avec un code de vérification.

  ```typescript Example theme={null}
  import MfaVoiceChallenge from '@auth0/auth0-acul-js/mfa-voice-challenge';

  const mfaVoiceChallenge = new MfaVoiceChallenge();
  await mfaVoiceChallenge.resendCode();
  ```
</ParamField>

<ParamField body="resendManager" type={<span><a href="/fr-CA/docs/libraries/acul/js-sdk/Screens/interfaces/ResendControl">ResendControl</a></span>}>
  Cette méthode fournit une fonctionnalité de renvoi avec un délai d’expiration et une gestion d’état configurables.

  ```typescript Example theme={null}
  import MfaVoiceChallenge from '@auth0/auth0-acul-js/mfa-voice-challenge';

  const mfaVoiceChallenge = new MfaVoiceChallenge();
  const { startResend } = mfaVoiceChallenge.resendManager({
    timeoutSeconds: 15,
    onStatusChange: (remainingSeconds, isDisabled) => {
      console.log(`Resend available in ${remainingSeconds}s, disabled: ${isDisabled}`);
    },
    onTimeout: () => {
      console.log('Resend is now available');
    },
  });

  startResend();
  ```

  **Paramètres de la méthode**

  <Expandable title="Paramètres">
    <ParamField body="options">
      [StartResendOptions](/fr-CA/docs/libraries/acul/js-sdk/Screens/interfaces/StartResendOptions).
    </ParamField>

    <ParamField body="onStatusChange?" type={<span><a href="/fr-CA/docs/libraries/acul/js-sdk/Screens/type-aliases/OnStatusChangeCallback">OnStatusChangeCallback</a></span>}>
      Fonction de rappel invoquée chaque fois que l’état du renvoi change; elle reçoit le nombre de secondes restantes et indique si le renvoi est actuellement désactivé.
    </ParamField>

    <ParamField body="onTimeout?" type="() => void">
      Fonction de rappel invoquée lorsque le délai d’expiration du renvoi est écoulé et que l’option de renvoi devient disponible.
    </ParamField>

    <ParamField body="timeoutSeconds?" type="number">
      Le nombre de secondes avant que l’option de renvoi ne devienne disponible.
    </ParamField>
  </Expandable>
</ParamField>

<ParamField body="switchToSms" type="Promise<void>">
  Cette méthode bascule la méthode de vérification vers le SMS.

  ```typescript Example theme={null}
  import MfaVoiceChallenge from '@auth0/auth0-acul-js/mfa-voice-challenge';

  const mfaVoiceChallenge = new MfaVoiceChallenge();
  await mfaVoiceChallenge.switchToSms();
  ```
</ParamField>

<ParamField body="tryAnotherMethod" type="Promise<void>">
  Cette méthode permet à l’utilisateur d’utiliser une autre méthode de MFA.

  ```typescript Example theme={null}
  import MfaVoiceChallenge from '@auth0/auth0-acul-js/mfa-voice-challenge';

  const mfaVoiceChallenge = new MfaVoiceChallenge();
  await mfaVoiceChallenge.tryAnotherMethod();
  ```
</ParamField>
