Ask to Authenticate action

Prerrequisitos

Configure the Apple Messages for Business (AMB) platform integration and add the required OAuth settings in the Authentication section. The Ask to Authenticate action appears in digital bot flows only if you have configured authentication for the AMB integration. For more information about configuring authentication for AMB, see Configure ACD for Apple integrations.

Use the Ask to Authenticate action in digital bot flows to authenticate the bot participant during a messaging conversation.

Note: The Ask to Authenticate action is only available for Apple Messages for Business (AMB) and it appears only if you have configured authentication for the AMB integration. The action takes the failure path if you use it in any other unsupported channels.

Campo	Descripción
Nombre	La etiqueta que se introduce aquí se convierte en el nombre de la acción en el editor de tareas.
Sign In Message	Enter the wording presented to the end customer when prompting to sign in using an authentication action. For example, “Please sign in so we can retrieve your order information.”
Success Message	Enter the message that the bot must send to the participant after the authentication is successful.
Authentication Completion Timeout	Set the timeout for how long that the bot must wait for the participant to complete the authentication. If the authentication is not completed within this time, then a No Input event is triggered. Click Increase or Decrease to adjust the timeout, or manually enter the timeout. You can set the timeout in days, minutes, hours, or seconds.
Sin coincidencia	Introduzca la comunicación que el bot produce cuando la entrada del usuario no es una coincidencia válida. Nota: El bot devuelve el contenido de Settings > User Input > No Match Detected > No Match Apology, combinado con la comunicación No Match.
Personalizar No Match	Activa el campo No Match Reprompts. Utilice esta opción para crear una lista de avisos de no coincidencia que se produzcan de forma incremental cuando el bot reciba eventos de entrada No coincidentes.
No Match Reprompts	Cuando el bot recibe una entrada No Match, el bot devuelve la comunicación en la colección No Match Reprompts que corresponde al número actual de entradas No Match recibidas para esa acción. Por ejemplo, la primera entrada No Match hace que el bot utilice el primer reprompt No Match de la colección definida. La longitud de la colección de Reintentos de No Coincidencia anula el número máximo de reintentos de No Coincidencia que usted defina en Configuración > Entrada de Usuario > No Coincidencia Detectada > Número Máximo de Reintentos de No Coincidencia para esa acción en particular. Por ejemplo, si defines dos reintentos en la colección, el bot reintentará dos veces. Una colección vacía desactiva los reintentos de No Match. Nota: El bot devuelve la comunicación Ajustes > Entrada de usuario > No coincidencia detectada > Apología de no coincidencia combinada con la correspondiente comunicación de reprompt de no coincidencia.
Por defecto Sin coincidencia	Activa el campo por defecto No Match. Utilice esta opción para definir un único aviso de No coincidencia que el bot producirá cuando reciba eventos de entrada No coincidentes.
Salidas de falla	These outputs allow the flow author to map the results of any resulting `errorType` and `errorMessage` variables when the action takes the failure path. errorType: Una cadena no vacía que contiene el tipo o categoría del error. mensaje de error: Un mensaje de error no localizado. La cadena puede estar vacía o NOT_SET. Notas: To expand or collapse the list of variables, click the arrow to the right of Failure Outputs. To display the list of allowable `errorType` values, hover over the information icon to the right of errorType.
Caminos	Número máximo de entradas: Activa o desactiva la ruta de No Entradas Máx. Cuando se activa esta opción, si el bot supera el número máximo de reintentos de no entrada establecido para esta acción, el flujo sigue esta ruta de salida. Max No Matches: Activa o desactiva la ruta Max No Matches. Al activar esta opción, si el bot supera el número máximo de reintentos de no coincidencia que ha establecido para esta acción, el flujo sigue esta ruta de salida. Nota: Si desactiva esta ruta, los flujos que configure para la ruta de salida se ocultarán, no se eliminarán.

Best practices when configuring the Ask to Authenticate action

The following best practices help you in ensuring that the messaging channel supports the authentication request:

Before you add the Ask to Authenticate action, it is recommended that you identify whether the user’s device can handle the authentication request. The device capabilities are included within the participant data of a conversation. To confirm the device capability, you can use the expression, (FindString(Flow.deviceCapabilities,"AUTH") > 0), for example, in a Decision or Switch action before the Ask to Authenticate action. Check for the presence of either “AUTH” or “AUTH2.” If the flow executes the action with a device that does not support AUTH or AUTH2, then the action takes the failure path.
You can also use the Architect built-in variable, Session.Source, to identify the messaging channel type. For more information about this variable, see Architect built-in variables.