Personaliza los mensajes SMS y de voz de la autenticación multifactor

Aprende a personalizar los mensajes SMS y de voz que Auth0 envía durante el registro y la verificación.

Para personalizar los mensajes SMS y de voz de la autenticación multifactor que envía Auth0:

1. Ve a Dashboard > Security > Multi-factor Auth y haz clic en Phone Message.
2. En la sección Enrollment Template o Verification Template, personaliza el mensaje.
3. Haz clic en Save.

La Enrollment Template define el mensaje que se envía cuando un usuario registra un dispositivo nuevo por primera vez mediante MFA. La Verificiation Template define el mensaje que se envía cuando un usuario inicia sesión después del registro.

​

Sintaxis

La sintaxis de Liquid es el motor de plantillas compatible que se utiliza al acceder a los atributos del usuario en las plantillas de SMS. Los siguientes atributos están disponibles:

Atributo	Descripción
message_type	Indica qué tipo de mensaje se envía: sms o voice.
code	Código de inscripción/verificación. Al enviar mensajes de voz, los valores de las variables se separan con puntos entre los dígitos (1.2.3.4.5) para que los proveedores de mensajería de voz los pronuncien correctamente.
locale	Para Universal Login o MFA API. Indica el idioma.
requestInfo.lang	Para la localización de Classic Login. Encabezado accept-language del navegador. Por ejemplo: es-AR,es;q=8.0, en-US,en.
tenant.friendlyName	El Friendly Name configurado en Dashboard > Tenant Settings.
custom_domain.domain	El nombre de dominio del tenant.
custom_domain.domain_metadata	Los campos de metadatos del dominio personalizado (como pares clave-valor).

Un ejemplo de uso de la sintaxis de Liquid para enviar mensajes diferentes para voz y SMS según el idioma:

{% if message_type == "voice" %}
    {% if locale contains "fr" %}
        Bonjour, vous avez demandé à recevoir un code de vérification pour vous enregister avec {{tenant.friendly_name}}. Votre code est: {{pause}} {{code}}. Je répète, votre code est: {{pause}}{{code}}.
    {% elsif locale contains "es" %}
        Usted ha requerido un código de verificación para inscribirse con {{tenant.friendly_name}}. Su código es: {{pause}}{{code}}. Repito, su código es: {{pause}}{{code}}.
    {% else %}
        Hello, you requested a verification code to enroll with {{tenant.friendly_name}}. Your code is: {{pause}}{{code}}. I repeat, your code is: {{pause}}{{code}}.
    {% endif %}
{% else %}
    {% if locale contains "fr" %}
        {{code}} est votre code de vérification pour vous enregistrer avec {{tenant.friendly_name}}.
    {% elsif locale contains "es" %}
        {{code}} es su código para inscribirse con {{tenant.friendly_name}}.
    {% else %}
        {{code}} is your verification code to enroll with {{tenant.friendly_name}}.
    {% endif %}
{% endif %}

​

Localización

En la API de autenticación de Auth0, el endpoint Get Code or Link, el endpoint de solicitud de desafío de MFA y el endpoint para agregar un autenticador de MFA admiten el encabezado x-request-language.

Para usarlo, configura los idiomas admitidos en Tenant > Settings (en Supported Languages). Cuando se envía el encabezado x-request-lanuage, esa configuración regional está disponible en la variable locale de las plantillas de mensajes telefónicos de MFA. Consulta Compatibilidad multilingüe de Passwordless para obtener más información.

​

Más información

• Autenticación multifactor (MFA)
• Configurar notificaciones por SMS y voz para MFA
• Registrar y desafiar autenticadores por SMS y voz