> ## 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.

# PhoneIdentifierEnrollment

> Décrit tous les hooks et les méthodes disponibles pour personnaliser l’écran `phone-identifier-enrollment` de Universal Login.

L’écran `phone-identifier-enrollment` s’affiche lorsqu’un utilisateur doit inscrire un numéro de téléphone comme identifiant. Il lui permet de sélectionner sa méthode de vérification préférée (SMS ou appel vocal), puis de poursuivre le processus d’inscription ou de revenir à l’étape précédente.

<Frame>
  <img style={{maxHeight:"400px"}} src="https://mintcdn.com/translations/c0RQ9V0YAcT0-8l5/docs/images/cdy7uua7fh8z/7kuQwDVmt0NkHCbQObLj8d/b690fd899f7c8525532d6d640298f2cd/PhoneIdentifierEnrollment.png?fit=max&auto=format&n=c0RQ9V0YAcT0-8l5&q=85&s=9cfe30a57c6dc034a55943924f55d5a0" alt="ACUL Inscription de l’identifiant téléphonique" width="480" height="628" data-path="docs/images/cdy7uua7fh8z/7kuQwDVmt0NkHCbQObLj8d/b690fd899f7c8525532d6d640298f2cd/PhoneIdentifierEnrollment.png" />
</Frame>

<div id="import">
  ## Importation
</div>

Chaque écran a son propre ensemble de hooks et de méthodes. Le SDK prend en charge l’**importation partielle** et l’**importation racine** pour chaque écran.

* L’importation partielle vous permet d’inclure uniquement le code nécessaire à votre cas d’utilisation.
* L’importation racine vous permet de charger tous les écrans à partir d’un seul bundle, ce qui est utile si vous voulez qu’un build unifié prenne en charge tous les écrans possibles.

```jsx Import Example theme={null}
// importation racine
import { usePhoneIdentifierEnrollment } from '@auth0/auth0-acul-react';

// importation partielle
import {
  usePhoneIdentifierEnrollment,
  // Hooks de contexte
  useUser,
  useTenant,
  useBranding,
  useClient,
  useOrganization,
  usePrompt,
  useScreen,
  useTransaction,
  useUntrustedData,
  // Hooks communs
  useCurrentScreen,
  useAuth0Themes,
  useErrors,
  // Hooks utilitaires
  useChangeLanguage,
  // Méthodes
  continuePhoneEnrollment,
  returnToPrevious,
} from '@auth0/auth0-acul-react/phone-identifier-enrollment';

function PhoneIdentifierEnrollmentScreen() {
  const { continuePhoneEnrollment } = usePhoneIdentifierEnrollment();
  return (
    <button onClick={() => continuePhoneEnrollment({ type: 'text' })}>Send Code via SMS</button>
  );
}
```

<div id="context-hooks">
  ## Hooks de contexte
</div>

Hooks associés à l’écran qui fournissent un accès en lecture seule aux données de contexte Auth0 sur l’écran `phone-identifier-enrollment`. Importez-les depuis `@auth0/auth0-acul-react/phone-identifier-enrollment`.

<ParamField body="useBranding" type={<span>() =&gt; <a href="/docs/fr-ca/libraries/acul/react-sdk/API-Reference/Types/interfaces/BrandingMembers">BrandingMembers</a></span>}>
  Ce hook fournit les configurations d’image de marque, comme le logo, les couleurs et les paramètres de thème affichés sur l’écran `phone-identifier-enrollment`.

  ```jsx Example theme={null}
  import { useBranding } from '@auth0/auth0-acul-react/phone-identifier-enrollment';
  function CustomTheme() {
    const branding = useBranding();
  }
  ```
</ParamField>

<ParamField body="useClient" type={<span>() =&gt; <a href="/docs/fr-ca/libraries/acul/react-sdk/API-Reference/Types/interfaces/ClientMembers">ClientMembers</a></span>}>
  Ce hook fournit des configurations liées au client, comme `id`, `name` et `logoUrl`, pour l’écran `phone-identifier-enrollment`.

  ```jsx Example theme={null}
  import { useClient } from '@auth0/auth0-acul-react/phone-identifier-enrollment';
  function AppInfo() {
    const client = useClient();
  }
  ```
</ParamField>

<ParamField body="useOrganization" type={<span>() =&gt; <a href="/docs/fr-ca/libraries/acul/react-sdk/API-Reference/Types/interfaces/OrganizationMembers">OrganizationMembers</a></span>}>
  Ce hook fournit de l’information sur l’Organization de l’utilisateur si l’inscription du téléphone est associée à une Organization. Retourne `null` lorsqu’aucun contexte Organization n’est présent.

  ```jsx Example theme={null}
  import { useOrganization } from '@auth0/auth0-acul-react/phone-identifier-enrollment';
  function OrgSelector() {
    const organization = useOrganization();
    if (!organization) {
      return <p>No Organization context</p>;
    }
  }
  ```
</ParamField>

<ParamField body="usePrompt" type={<span>() =&gt; <a href="/docs/fr-ca/libraries/acul/react-sdk/API-Reference/Types/interfaces/PromptMembers">PromptMembers</a></span>}>
  Ce hook contient des données sur le prompt actuel dans le flux d’authentification.

  ```jsx Example theme={null}
  import { usePrompt } from '@auth0/auth0-acul-react/phone-identifier-enrollment';
  function FlowInfo() {
    const prompt = usePrompt();
  }
  ```
</ParamField>

<ParamField body="useScreen" type={<span>() =&gt; <a href="/docs/fr-ca/libraries/acul/react-sdk/API-Reference/Types/interfaces/ScreenMembersOnPhoneIdentifierEnrollment">ScreenMembersOnPhoneIdentifierEnrollment</a></span>}>
  Ce hook contient des détails propres à l’écran `phone-identifier-enrollment`, y compris sa configuration et son contexte.

  L’objet `screen.data` expose trois champs facultatifs : `phone`, `messageType` et `username`. Utilisez `screen.data?.username` pour afficher le nom d’utilisateur associé à la session d’inscription actuelle.

  ```jsx Example theme={null}
  import { useScreen } from '@auth0/auth0-acul-react/phone-identifier-enrollment';
  function ScreenDebug() {
    const screen = useScreen();
    const username = screen.data?.username;
  }
  ```
</ParamField>

<ParamField body="useTenant" type={<span>() =&gt; <a href="/docs/fr-ca/libraries/acul/react-sdk/API-Reference/Types/interfaces/TenantMembers">TenantMembers</a></span>}>
  Ce hook contient des données liées au tenant, comme `id` et les métadonnées associées.

  ```jsx Example theme={null}
  import { useTenant } from '@auth0/auth0-acul-react/phone-identifier-enrollment';
  function TenantInfo() {
    const tenant = useTenant();
  }
  ```
</ParamField>

<ParamField body="useTransaction" type={<span>() =&gt; <a href="/docs/fr-ca/libraries/acul/react-sdk/API-Reference/Types/interfaces/TransactionMembers">TransactionMembers</a></span>}>
  Ce hook fournit des données propres à la transaction pour l’écran `phone-identifier-enrollment`, comme les connexions actives et l’état actuel du flux.

  ```jsx Example theme={null}
  import { useTransaction } from '@auth0/auth0-acul-react/phone-identifier-enrollment';
  function TransactionInfo() {
    const transaction = useTransaction();
  }
  ```
</ParamField>

<ParamField body="useUntrustedData" type={<span>() =&gt; <a href="/docs/fr-ca/libraries/acul/react-sdk/API-Reference/Types/interfaces/UntrustedDataMembers">UntrustedDataMembers</a></span>}>
  Ce hook gère les données non fiables transmises à l’écran, comme des paramètres préremplis provenant de chaînes de requête d’URL.

  ```jsx Example theme={null}
  import { useUntrustedData } from '@auth0/auth0-acul-react/phone-identifier-enrollment';
  function PrefilledForm() {
    const untrustedData = useUntrustedData();
  }
  ```
</ParamField>

<ParamField body="useUser" type={<span>() =&gt; <a href="/docs/fr-ca/libraries/acul/react-sdk/API-Reference/Types/interfaces/UserMembers">UserMembers</a></span>}>
  Ce hook fournit des renseignements sur l’utilisateur actif, notamment son `username`, son `email` et les méthodes d’authentification disponibles.

  ```jsx Example theme={null}
  import { useUser } from '@auth0/auth0-acul-react/phone-identifier-enrollment';
  function UserProfile() {
    const user = useUser();
  }
  ```
</ParamField>

<ParamField body="usePhoneIdentifierEnrollment" type={<a href="/docs/fr-ca/libraries/acul/react-sdk/API-Reference/Types/interfaces/PhoneIdentifierEnrollmentMembers">PhoneIdentifierEnrollmentMembers</a>}>
  Ce hook retourne toutes les méthodes et tout le contexte disponibles sur l’écran `phone-identifier-enrollment`.
</ParamField>

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

<ParamField body="continuePhoneEnrollment" type="Promise<void>">
  Cette méthode envoie le mode de vérification téléphonique privilégié par l’utilisateur et poursuit l’inscription.

  ```jsx Example theme={null}
  import { usePhoneIdentifierEnrollment } from '@auth0/auth0-acul-react/phone-identifier-enrollment';

  function EnrollButton() {
    const { continuePhoneEnrollment } = usePhoneIdentifierEnrollment();
    return (
      <button onClick={() => continuePhoneEnrollment({ type: 'text' })}>
        Envoyer le code par SMS
      </button>
    );
  }
  ```

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

  <Expandable title="Paramètres">
    <ParamField body="options">
      [PhoneEnrollmentOptions](/docs/fr-ca/libraries/acul/react-sdk/API-Reference/Types/interfaces/PhoneEnrollmentOptions).
    </ParamField>

    <ParamField body="type" type="&#x22;text&#x22; | &#x22;voice&#x22;" required>
      Le mode d’envoi du code de vérification. Utilisez "text" pour les SMS ou "voice" pour un appel téléphonique.
    </ParamField>
  </Expandable>
</ParamField>

<ParamField body="returnToPrevious" type="Promise<void>">
  Cette méthode ramène l’utilisateur à l’étape précédente du flux d’authentification.

  ```jsx Example theme={null}
  import { usePhoneIdentifierEnrollment } from '@auth0/auth0-acul-react/phone-identifier-enrollment';

  function BackButton() {
    const { returnToPrevious } = usePhoneIdentifierEnrollment();
    return (
      <button onClick={() => returnToPrevious()}>
        Retour
      </button>
    );
  }
  ```
</ParamField>

<div id="commonutility-hooks">
  ## Hooks communs/utilitaires
</div>

<ParamField body={<a href="/docs/fr-ca/libraries/acul/react-sdk/API-Reference/Hooks/useAuth0Themes">useAuth0Themes</a>} type="Hooks">
  Ce hook récupère les options du thème actuel avec une configuration aplatie à partir du contexte d’image de marque.
</ParamField>

<ParamField body={<a href="/docs/fr-ca/libraries/acul/react-sdk/API-Reference/Hooks/useChangeLanguage">useChangeLanguage</a>} type="Hooks">
  Ce hook renvoie une fonction permettant de changer la langue d’affichage sur l’écran ACUL actuel.
</ParamField>

<ParamField body={<a href="/docs/fr-ca/libraries/acul/react-sdk/API-Reference/Hooks/useCurrentScreen">useCurrentScreen</a>} type="Hooks">
  Ce hook récupère le contexte et l’état de l’écran actuel.
</ParamField>

<ParamField body={<a href="/docs/fr-ca/libraries/acul/react-sdk/API-Reference/Hooks/useErrors">useErrors</a>} type="Hooks">
  Ce hook lit et gère les erreurs côté serveur, côté client et côté développeur sur l’écran.
</ParamField>
