Uso de metadatos de autenticación en una respuesta de bot

Las variables del generador de bots permiten personalizar las respuestas de un bot de mensajería en función de los datos relacionados con una conversación. Las variables de metadatos de mensajería son un tipo de variable que se usa en el generador de bots que contiene información de la identidad del cliente actual y de su estado de autenticación.

Las variables de metadatos de mensajería obtienen sus valores de los Tokens Web JSON (JWT) firmados que se utilizan para la autenticación de la mensajería. Durante una conversación, un bot de mensajería puede usar esa información para personalizar sus respuestas, mostrar información pertinente al cliente o ramificar el flujo de la conversación.

Este artículo contiene los siguientes temas:

• Activar las variables de metadatos de mensajería
• Las variables de metadatos de mensajería admitidas
• Mejores prácticas para usar las variables de metadatos de mensajería

Si desea ver una descripción general de las variables de bot y cómo se pueden usar en una respuesta, consulte Uso de variables para personalizar las respuestas de bot.

Activar las variables de metadatos de mensajería

Estas variables no están activadas de manera predeterminada. Para activarlas, un administrador debe crear una clave de firma para generar los JWT de autenticación de mensajería. La autenticación de mensajería y las variables de metadatos de mensajería solo están disponibles para el Web Widget y los canales de SDK para móviles.

Si desea información sobre cómo configurar la autenticación de mensajería, consulte Autenticación de usuarios finales en la mensajería para el Web Widget y el SDK para móviles.

Las variables de metadatos de mensajería admitidas

A diferencia de otros tipos de variables de bot, las variables de metadatos de mensajería tienen nombres predefinidos. No es posible especificar ni cambiar el nombre ni el valor de una variable de metadatos de mensajería en un flujo de respuesta.

Nombre de la variable de metadatos de mensajería	Descripción
Correo electrónico proporcionado	La dirección de correo electrónico del cliente. Se obtiene del JWT usado para la autenticación de mensajería.
Nombre proporcionado	El nombre del cliente. Se extrae del JWT usado para la autenticación de mensajería.
ID externa autenticada	La cadena alfanumérica única que identifica al cliente. Se extrae del JWT usado para la autenticación de mensajería.
Estado autenticado	Si es verdadero, se confirma que el cliente ha sido autenticado. De lo contrario, es falso. Esta variable siempre es verdadera o falsa; nunca está vacía. Cuando se usa la variable Estado autenticado en un paso Ramificar por condición, solo se admite el operador Es.

Uso de las variables Nombre proporcionado y Correo electrónico proporcionado

Es importante tener en cuenta los aspectos que se describen a continuación a la hora de usar las variables Nombre proporcionado y Correo electrónico proporcionado.

• Los bots de mensajería omiten automáticamente la recopilación de las variables Nombre y Correo electrónico de los clientes autenticados en un paso Solicitar detalles. En el caso de los clientes autenticados, estas variables se encuentran vacías y se omiten en los pasos posteriores de la conversación. En su lugar, utilice las variables Nombre proporcionado y Correo electrónico proporcionado.

  Recopilación omitida de las variables Nombre y Correo electrónico del paso Solicitar detalles	Variables Nombre proporcionado y Correo electrónico proporcionado

• Los JWT que se utilizan para la autenticación de la mensajería no requieren el nombre ni la dirección de correo electrónico del cliente. Si su organización no incluye un nombre ni una dirección de correo electrónico en sus JWT, las variables Nombre proporcionado y Correo electrónico proporcionado respectivas se hallan vacías y se omiten durante una conversación.

  En tal caso, le recomendamos que actualice sus JWT para que incluyan un nombre y una dirección de correo electrónico.

• Las variables Nombre proporcionado y Correo electrónico proporcionado están vacías cuando se trata de clientes no autenticados. Se recomienda evitar usarlas en pasos de respuesta de clientes no autenticados.

Uso de las variables de metadatos de mensajería con clientes no autenticados

Si un cliente no está autenticado, el valor de la variable Estado autenticado es falso. Otras variables de metadatos de mensajería se encuentran vacías para los clientes no autenticados y se omiten durante una conversación.

Mejores prácticas para usar las variables de metadatos de mensajería

Para crear una respuesta con variables de metadatos de mensajería, se recomienda seguir las prácticas que se describen a continuación.

• Si no incluye el nombre ni la dirección de correo electrónico del cliente en los JWT que se utilizan para la autenticación de mensajería, evite usar también las variables Nombre proporcionado y Correo electrónico proporcionado.
• Para crear un flujo de respuesta que esté disponible tanto para clientes autenticados como no autenticados, use el paso Ramificar por condición para verificar las variables de Estado autenticado del cliente. Las variables de metadatos de mensajería solo se pueden incluir en ramas donde el valor del Estado autenticado sea verdadero.
• Si está creando una respuesta que solo estará disponible para los clientes autenticados, y los JWT de su organización incluyen un nombre y una dirección de correo electrónico, use las variables Nombre proporcionado y Correo electrónico proporcionado para el nombre y la dirección de correo electrónico del cliente. En este caso no es necesario recopilar esa información nuevamente por medio de un paso Solicitar detalles.