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

# Déclencheurs d’action : Objet d’événement custom-phone-provider

> Découvrez comment utiliser l’objet d’événement de fournisseur de services téléphoniques personnalisés pour configurer un fournisseur de services téléphoniques personnalisés.

<Callout icon="file-lines" color="#0EA5E9" iconType="regular">
  Les fournisseurs de messagerie téléphonique sont actuellement en accès anticipé. Pour en savoir plus sur les étapes de diffusion d’Auth0, consultez [Étapes de la diffusion du produit](https://auth0.com/docs/troubleshoot/product-lifecycle/product-release-stages).
</Callout>

L’objet `event` pour le déclencheur d’actions `custom-phone-provider` fournit des informations contextuelles sur la demande d’envoi et de réception d’un message téléphonique personnalisé.

<table class="table">
  <thead>
    <tr>
      <th>Propriété</th>
      <th>Description</th>
    </tr>
  </thead>

  <tbody>
    <tr>
      <td>
        <p>`event.client`</p>
      </td>

      <td>
        <p>
          Informations sur le client avec lequel la transaction de connexion a
          été initiée.
        </p>

        <p>Comprend les propriétés suivantes :</p>

        <ul>
          <li>
            `client_id` <em>Chaîne</em>.
            <span>L’ID client de l’application à laquelle l’utilisateur se connecte.</span>
          </li>

          <li>
            `metadata` <em>Dictionnaire</em>.
            <span>Un objet qui contient les autres propriétés d’une application.</span>
          </li>

          <li>
            `name` <em>Chaîne</em>.
            <span>Le nom de l’application (comme défini dans le Dashboard).</span>
          </li>
        </ul>
      </td>
    </tr>

    <tr>
      <td>
        <p>`event.connection`</p>
        <p><em>(Facultatif)</em></p>
      </td>

      <td>
        <p>
          Détails sur la connexion utilisée pour authentifier l’utilisateur.
        </p>

        <p>Comprend les propriétés suivantes :</p>

        <ul>
          <li>
            `id` <em>Chaîne facultative</em>.
            <span>L’identifiant unique de la connexion.</span>
          </li>

          <li>
            `metadata` <em>Dictionnaire facultatif</em>.
            <span>Métadonnées associées à la connexion.</span>
          </li>

          <li>
            `name` <em>Chaîne facultative</em>.
            <span>Le nom de la connexion utilisée pour authentifier l’utilisateur (par ex. :
            `twitter` ou `some-g-suite-domain`).</span>
          </li>

          <li>
            `strategy` <em>Chaîne facultative</em>.
            <span>Le type de connexion. Pour les connexions sociales,
            `event.connection.strategy === event.connection.name`.
            Pour les connexions d’entreprise, la stratégie est la suivante :
            `waad` (Windows Entra ID), `ad` (Active
            Directory/LDAP), `auth0` (connexions aux bases de données),
            etc.</span>
          </li>
        </ul>
      </td>
    </tr>

    <tr>
      <td>
        <p>`event.notification`</p>
      </td>

      <td>
        <p>Comprend les propriétés suivantes :</p>

        <ul>
          <li>
            `from` <em>Chaîne</em>.
            <span>Le numéro de téléphone conforme au format E.164 pour l’expéditeur.</span>
          </li>

          <li>
            `locale` <em>Chaîne</em>.
            <span>La langue dans laquelle nous avons rendu le message, par exemple
            `en_US`, telle que définie dans la spécification BCP-47.</span>
          </li>

          <li>
            `message_type` <em>Chaîne</em>.

            <p>
              Le type de message envoyé, par exemple
              `otp_verify` ou `blocked_account`.
            </p>

            <p>Les valeurs possibles sont les suivantes :</p>

            <ul>
              <li>`otp_verify`</li>
              <li>`otp_enroll`</li>
              <li>`blocked_account`</li>
              <li>`change_password`</li>
              <li>`password_breach`</li>
            </ul>
          </li>

          <li>
            `recipient` <em>Chaîne</em>.
            <span>Le numéro de téléphone conforme au format E.164 pour le destinataire.</span>
          </li>

          <li>
            `delivery_method` <em>Enum</em>.
            <span>La manière dont le message doit être transmis. Peut être `text` ou `voice`.</span>
          </li>

          <li>
            `code` <em>Chaîne</em>.
            <span>Mot de passe à usage unique pour certains `message_types` (par exemple `otp_verify`, `otp_enroll`).</span>
          </li>

          <li>
            `as_text` <em>Chaîne</em>.
            <span>Le texte rendu prêt à être livré en tant que message texte.</span>
          </li>

          <li>
            `as_voice` <em>Chaîne</em>.
            <span>Le texte rendu prêt à être livré en tant que message vocal.</span>
          </li>
        </ul>
      </td>
    </tr>

    <tr>
      <td>
        <p>`event.organization`</p>
        <p><em>(Facultatif)</em></p>
      </td>

      <td>
        <p>
          Détails sur l’Organization associée à la transaction
          en cours.
        </p>

        <p>Comprend les propriétés suivantes :</p>

        <ul>
          <li>
            `display_name` <em>Chaîne</em>.
            <span>Le nom convivial de l’Organization.</span>
          </li>

          <li>
            `id` <em>Chaîne</em>.
            <span>L‘identifiant de l’Organization.</span>
          </li>

          <li>
            `metadata` <em>Dictionnaire</em>.
            <span>Métadonnées associées à l’Organization.</span>
          </li>

          <li>
            `name` <em>Chaîne</em>.
            <span>Le nom de l’Organization.</span>
          </li>
        </ul>
      </td>
    </tr>

    <tr>
      <td>
        <p>`event.request`</p>
        <p><em>(Facultatif)</em></p>
      </td>

      <td>
        <p>Détails à propos de la demande à l’origine de la transaction.</p>
        <p>Comprend les propriétés suivantes :</p>

        <ul>
          <li>
            `geoip` <em>Objet facultatif</em>.
            <p>Comprend les propriétés suivantes :</p>

            <ul>
              <li>`countryCode` <em>Chaîne facultative</em>.</li>
              <li>`countryCode3` <em>Chaîne facultative</em>.</li>
              <li>`cityName` <em>Chaîne facultative</em>.</li>
              <li>`latitude` <em>Chaîne facultative</em>.</li>
              <li>`longitude` <em>Chaîne facultative</em>.</li>
              <li>`timeZone` <em>Chaîne facultative</em>.</li>
              <li>`subdivisionCode` <em>Chaîne facultative</em>.</li>
              <li>`subdivisionName` <em>Chaîne facultative</em>.</li>
              <li>`continentCode` <em>Chaîne facultative</em>.</li>
              <li>`continentCode` <em>Chaîne facultative</em>.</li>
            </ul>
          </li>

          <li>
            `ip` <em>Chaîne facultative</em>.
            <span>L’adresse IP initiale de la demande.</span>
          </li>

          <li>
            `hostname` <em>Chaîne facultative</em>.
            <span>Le nom d’hôte utilisé pour le flux d’authentification.</span>
          </li>

          <li>
            `method` <em>Chaîne facultative</em>.
            <span>La méthode HTTP utilisée pour la demande.</span>
          </li>

          <li>
            `language` <em>Chaîne facultative</em>.
            <span>La langue demandée par le navigateur.</span>
          </li>

          <li>
            `user_agent` <em>Chaîne facultative</em>.
            <span>La valeur de l’en-tête `User-Agent` reçu lorsque de la transaction
            a été initiée.</span>
          </li>
        </ul>
      </td>
    </tr>

    <tr>
      <td>
        <p>`event.tenant`</p>
      </td>

      <td>
        <p>Comprend les propriétés suivantes :</p>

        <ul>
          <li>
            `friendly_name` <em>Chaîne facultative</em>.
            <span>Le nom convivial du locataire, généralement une
            version plus lisible de l’ID.</span>
          </li>

          <li>
            `home_url` <em>Chaîne facultative</em>.
            <span>L’URL d’accueil du locataire, si elle est définie et telle qu’elle figure dans ses
            paramètres.</span>
          </li>

          <li>
            `id` <em>Chaîne</em>.
            <span>Le nom du locataire.</span>
          </li>

          <li>
            `logo_url` <em>Chaîne facultative</em>.
            <span>L’URL du logo du locataire, si elle est définie et telle qu’elle figure dans ses
            paramètres.</span>
          </li>

          <li>
            `support_email` <em>Chaîne facultative</em>.
            <span>Le courriel du service de soutien du locataire, s’il est défini et tel qu’il figure
            dans ses paramètres.</span>
          </li>

          <li>
            `support_url` <em>Chaîne facultative</em>.
            <span>L’URL du service de soutien du locataire, si elle est définie et tel qu’elle figure
            dans ses paramètres.</span>
          </li>
        </ul>
      </td>
    </tr>

    <tr>
      <td>
        <p>`event.user`</p>
      </td>

      <td>
        <p>
          Objet décrivant l’utilisateur au nom duquel la transaction en cours
          a été initiée.
        </p>

        <p>Comprend les propriétés suivantes :</p>

        <ul>
          <li>
            `app_metadata` <em>Dictionnaire</em>.
            <span>Champs personnalisés qui stockent des informations sur un utilisateur qui influencent
            l’accès de l’utilisateur, comme le plan de soutien, les rôles de sécurité ou les groupes
            de contrôle d’accès.</span>
          </li>

          <li>
            `email` <em>Chaîne facultative</em>.
            <span>(unique) Adresse électronique de l’utilisateur.</span>
          </li>

          <li>
            `email_verified` <em>Valeur booléenne</em>.
            <span>Indique si l’utilisateur a vérifié son adresse
            de courriel.</span>
          </li>

          <li>
            `family_name` <em>Chaîne facultative</em>.
            <span>Nom de famille de l’utilisateur.</span>
          </li>

          <li>
            `given_name` <em>Chaîne facultative</em>.
            <span>Prénom de l’utilisateur.</span>
          </li>

          <li>
            `name` <em>Chaîne facultative</em>.
            <span>Nom complet de l’utilisateur.</span>
          </li>

          <li>
            `nickname` <em>Chaîne facultative</em>.
            <span>Pseudonyme de l’utilisateur.</span>
          </li>

          <li>
            `picture` <em>Chaîne facultative</em>.
            <span>URL pointant vers la
            <a href="https://auth0.com/docs/users/change-user-picture">photo de profil de l’utilisateur</a>.</span>
          </li>

          <li>
            `user_id` <em>Chaîne</em>.
            <span>(unique) Identifiant unique de l’utilisateur.</span>
          </li>

          <li>
            `user_metadata` <em>Dictionnaire</em>.
            <span>Champs personnalisés qui stockent des informations sur un utilisateur et qui n’ont pas d’incidence
            sur les données auxquelles il peut ou ne peut pas accéder, comme l’adresse professionnelle, l’adresse
            personnelle ou les préférences de l’utilisateur.</span>
          </li>

          <li>
            `username` <em>Chaîne facultative</em>.
            <span>(unique) Nom d’utilisateur</span>
          </li>
        </ul>
      </td>
    </tr>
  </tbody>
</table>