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

> Découvrez comment configurer Unified Phone Experience pour l’authentification Passwordless.

# Utiliser Unified Phone Experience pour Passwordless

<Card title="Avant de commencer">
  Pour migrer vers Unified Phone Experience, vous devez :

  * avoir activé et configuré dans votre tenant les notifications SMS, appel vocal ou SMS+appel vocal de l’authentification multifacteur (MFA), ou
  * avoir activé et configuré Passwordless SMS dans votre tenant

  Si vous n’avez configuré ni MFA ni Passwordless, consultez [Configure Auth0's Unified Phone Experience](/docs/fr-ca/customize/phone-messages/unified-phone/configure-unified-phone) pour partir du bon pied.

  Si vous avez à la fois des intégrations MFA et Passwordless avec des fournisseurs différents, vous devez utiliser un [fournisseur téléphonique personnalisé](/docs/fr-ca/customize/phone-messages/configure-phone-messaging-providers/configure-a-custom-phone-provider).

  Si vous utilisez Phone comme ID, vous utilisez automatiquement Unified Phone Experience et aucune autre action n’est requise.
</Card>

Unified Phone Experience centralise toutes les configurations de vos fournisseurs téléphoniques à un seul endroit dans votre tenant. Vous n’aurez pas à configurer plusieurs fois un fournisseur téléphonique pour différents facteurs d’authentification par téléphone. Pour en savoir plus sur les facteurs téléphoniques pour <Tooltip tip="Passwordless : forme d’authentification qui ne repose pas sur un mot de passe comme premier facteur." cta="Voir le glossaire" href="/docs/fr-ca/glossary?term=Passwordless">Passwordless</Tooltip>, consultez [Passwordless Authentication with SMS](/docs/fr-ca/authenticate/passwordless/authentication-methods/sms-otp).

Si vous avez déjà configuré un fournisseur téléphonique pour Passwordless, vous pouvez migrer cette configuration vers Unified Phone Experience et l’appliquer au niveau du tenant.

<Callout icon="file-lines" color="#0EA5E9" iconType="regular">
  Auth0 n’indique pas à l’utilisateur final si un message téléphonique a été envoyé avec succès au moyen du fournisseur au niveau du tenant. Pour résoudre les problèmes, consultez les [journaux du tenant](/docs/fr-ca/deploy-monitor/logs).
</Callout>

<h2 id="update-your-phone-provider">
  Mettez à jour votre fournisseur téléphonique
</h2>

Pour utiliser Unified Phone Experience, vous devez :

* Vérifier les paramètres actuels
* Configurer votre fournisseur :

  * Configurer Twilio
  * Configurer un fournisseur téléphonique personnalisé
* Mettre à jour les modes d’envoi

<h3 id="verify-current-settings">
  Vérifier les paramètres actuels
</h3>

1. Pour vérifier vos paramètres Passwordless actuels, accédez à [**Auth0 Dashboard > Authentication > Passwordless > SMS**](https://manage.auth0.com/#/connections/passwordless).
2. Sélectionnez **Phone Message**.
3. Si vous pouvez utiliser la fonctionnalité Unified Phone Experience, une bannière vous invite à configurer un fournisseur au niveau du tenant :

<Frame>
  <img src="https://mintlify.s3.us-west-1.amazonaws.com/auth0-actions-modules-ga/docs/images/cdy7uua7fh8z/7piF5GX9dZL0EXC8SRtMzE/41737a34205541cee46cdbf364401bbc/2025-02-12_15-56-26.png" alt="Dashboard > Authentication > Passwordless > SMS" />
</Frame>

<Callout icon="file-lines" color="#0EA5E9" iconType="regular">
  Si vous devez utiliser l’expérience Legacy pour configurer votre fournisseur téléphonique et que la bascule permettant d’utiliser un fournisseur au niveau du tenant est absente, communiquez avec [Auth0 Support](/docs/fr-ca/troubleshoot/customer-support).
</Callout>

<h3 id="configure-twilio-as-a-tenant-level-provider">
  Configurer Twilio comme fournisseur au niveau du tenant
</h3>

Si vous utilisez Twilio comme fournisseur téléphonique pour Passwordless, vous devez ajouter le SID Twilio et l’AuthToken à l’Unified Phone Experience. Vous pouvez copier le SID Twilio à partir de votre configuration existante, mais vous devrez obtenir la valeur de l’AuthToken auprès de Twilio.

1. Accédez à [**Branding > Fournisseur téléphonique**](https://manage.auth0.com/#/phone/templates/phone/provider).
2. Sélectionnez et configurez votre fournisseur :

   <Frame>
     <img src="https://mintlify.s3.us-west-1.amazonaws.com/auth0-actions-modules-ga/docs/images/cdy7uua7fh8z/6TESTIdmhUL0LEitACadIK/fcdc34e18a6b66b47370f6d754c085b5/2025-02-21_12-49-53.png" alt="Branding > Phone Provider > Twilio" />
   </Frame>

   1. Choisissez Twilio comme fournisseur téléphonique.
   2. Choisissez vos modes d’envoi.
   3. Saisissez les paramètres Twilio.
3. **Enregistrez** vos modifications.
4. Sélectionnez **Envoyer un message de test** pour tester le fournisseur au niveau du tenant avant de l’utiliser dans un environnement de production.
   <Callout icon="file-lines" color="#0EA5E9" iconType="regular">
     Les numéros de téléphone non valides renvoient une erreur. Pour en savoir plus sur la validation des numéros de téléphone, consultez [Quelle validation est effectuée lors de l’utilisation du point de terminaison /passwordless/start pour SMS](https://support.auth0.com/center/s/article/What-validation-occurs-when-using-the-passwordless-start-endpoint-for-SMS).
   </Callout>
5. Activez un fournisseur au niveau du tenant.

   1. Accédez à [**Authentication > Passwordless > SMS**](https://manage.auth0.com/#/connections/passwordless).
   2. Sélectionnez **Use Tenant-level Messaging Provider**

      <Warning>
        Si aucune bascule n’existe dans votre tenant, vous utilisez déjà l’Unified Phone Experience.
      </Warning>
6. **Enregistrez** vos modifications.

<h3 id="create-a-new-custom-phone-provider-action-for-passwordless">
  Créer une nouvelle Action custom-phone-provider pour Passwordless
</h3>

L’expérience Unified Phone Experience n’utilise pas la [passerelle SMS personnalisée](/docs/fr-ca/authenticate/passwordless/authentication-methods/use-sms-gateway-passwordless) que vous avez configurée pour Passwordless SMS. Vous pouvez utiliser le <Tooltip tip="Auth0 Dashboard : le principal produit d’Auth0 pour configurer vos services." cta="Voir le glossaire" href="/docs/fr-ca/glossary?term=Auth0+Dashboard">Auth0 Dashboard</Tooltip> ou la <Tooltip tip="Auth0 Dashboard : le principal produit d’Auth0 pour configurer vos services." cta="Voir le glossaire" href="/docs/fr-ca/glossary?term=Management+API">Management API</Tooltip> pour configurer un fournisseur téléphonique personnalisé avec Auth0 Actions. Pour en savoir plus, consultez [Configurer un fournisseur téléphonique personnalisé](/docs/fr-ca/customize/phone-messages/configure-phone-messaging-providers/configure-a-custom-phone-provider).

<h5 id="configure-passwordless-custom-phone-provider">
  Configurer custom-phone-provider pour Passwordless
</h5>

Pour configurer votre fournisseur téléphonique Custom SMS Gateway à l’aide d’une Action de fournisseur de téléphone :

1. Accédez à [**Branding > Fournisseur téléphonique**](https://manage.auth0.com/#/phone/templates/phone/provider).
2. Sélectionnez votre fournisseur :

   1. Choisissez **Custom**.
   2. Sous **Configuration du fournisseur**, ajoutez vos nouvelles Actions `custom-phone-provider` qui transfèrent la notification Passwordless vers une passerelle SMS personnalisée.
3. **Enregistrer** vos modifications.
4. Sélectionnez **Envoyer un message de test** pour tester le fournisseur au niveau du tenant avant de l’utiliser dans un environnement de production.
5. Accédez à [**Authentication > Passwordless > SMS**](https://manage.auth0.com/#/connections/passwordless) pour activer **Use Tenant-level Messaging Provider**.
6. **Enregistrer** vos modifications.

<h5 id="custom-sms-gateway-to-custom-phone-provider-example">
  Exemple de passerelle SMS personnalisée pour custom-phone-provider
</h5>

```javascript lines expandable theme={null}
const request = require('<favorite_http_client>');
/**
* Gestionnaire à exécuter lors de l'envoi d'une notification téléphonique
* 
@param
 {Event} event - Détails sur l'utilisateur et le contexte dans lequel il se connecte.
* 
@param
 {CustomPhoneProviderAPI} api - Méthodes et utilitaires pour modifier le comportement de l'envoi d'une notification téléphonique.
*/
exports.onExecuteCustomPhoneProvider = async (event, api) => {
  const notificationType = event.notification.message_type;
  switch (notificationType) {
    case '<otp_verify>': {
      const req = {
        url: event.secrets.GATEWAY_URL,
        method: 'POST',
        headers: {
          'User-Agent': 'Auth0'
        },
        body: {
          recipient: event.notification.recipient,
          body: event.notification.as_text, // ou event.notification.as_voice
          sender: event.notification.from, // TODO : l'émetteur est absent, nous devons vérifier si nous souhaitons l'ajouter.
          req: event.request || {}, // si non activé, la valeur sera indéfinie
        }
      }
      const response = await request(req);
      console.log(response.statusCode);
      return
    }
    default: {
      // gérer les autres notifications normalement
      return;
    }
  }
};
```

<h3 id="update-delivery-methods">
  Mettre à jour les modes d’envoi
</h3>

| Facteurs téléphoniques | Mode d’envoi actuel au niveau du tenant | Mode d’envoi souhaité au niveau du tenant | Action de l’utilisateur                                                                                                                                                                 |
| ---------------------- | --------------------------------------- | ----------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| SMS                    | SMS                                     | SMS + Voix                                | Aucune                                                                                                                                                                                  |
| SMS                    | SMS                                     | Voix                                      | L’utilisateur doit mettre à jour les facteurs téléphoniques Passwordless afin qu’ils correspondent à un sous-ensemble des modes d’envoi activés pour le fournisseur au niveau du tenant |
| SMS                    | SMS + Voix                              | Voix                                      | L’utilisateur doit mettre à jour les facteurs téléphoniques Passwordless afin qu’ils correspondent à un sous-ensemble des modes d’envoi activés pour le fournisseur au niveau du tenant |
| SMS                    | SMS + Voix                              | SMS                                       | Aucune                                                                                                                                                                                  |

<h2 id="disable-phone-provider">
  Désactiver le fournisseur téléphonique
</h2>

Si vous configurez Unified Phone Experience, puis le désactivez, les intégrations existantes avec votre fournisseur téléphonique, y compris Passwordless, risquent de ne plus fonctionner.

<Frame>
  <img src="https://mintlify.s3.us-west-1.amazonaws.com/auth0-actions-modules-ga/docs/images/cdy7uua7fh8z/3qqa2QWXRNKZV96AQq6O0G/28cdff44a9532f5c005a5e1acb763ab8/2025-02-24_14-58-47.png" alt="" />
</Frame>