El componente prediseñado de apertura de cuenta permite a los usuarios nuevos y actuales abrir una cuenta o consultar el estado de las solicitudes que ya hayan enviado. Este componente usa los componentes predefinidos Recogida de fecha de nacimiento, Recogida de nombre y Recogida de número de teléfono para recoger información de los usuarios y registrar una cuenta nueva.
Tipos de cuentas
De forma predeterminada, este componente admite los siguientes tipos de cuentas:
- Cuentas de ahorro
- Cuentas corrientes
- Cuentas desmaterializadas
- Cuentas nómina
Los tipos de cuenta admitidos se pueden añadir o quitar modificando la entidad personalizada prebuilt_components_open_account_account_type.
Limitaciones
Además de las limitaciones comunes de los componentes prediseñados, este componente prediseñado tiene las siguientes limitaciones:
- Este componente no cifra ningún dato.
Ejemplos de cuadros de diálogo
En los siguientes ejemplos de cuadros de diálogo se muestran situaciones habituales que gestiona este componente prediseñado. Los diálogos de ejemplo muestran el comportamiento cuando se llama al componente por telefonía, lo que activa el intent de bienvenida predeterminado y la primera respuesta del agente al inicio de la conversación.
Usuario nuevo
El agente recoge el número de teléfono del usuario e identifica que no tiene una cuenta registrada. A continuación, el agente recoge información como el nombre completo y la fecha de nacimiento del usuario, y genera una solicitud que se envía al número de teléfono que ha proporcionado el usuario.
| Entrada del usuario | Respuesta del agente |
|---|---|
| Indícanos el número de teléfono para que podamos validarlo. | |
| El agente recoge el número de teléfono del usuario mediante el componente precompilado Recogida del número de teléfono | |
| Genial, ya hemos recogido el número de teléfono. Nos alegra que quieras abrir una cuenta con nosotros. |
|
| El agente recoge el nombre completo del usuario mediante el componente prediseñado Recogida de nombre | |
| Gracias, Juan García. | |
| El agente recoge el número de teléfono del usuario mediante el componente prediseñado Recogida de fecha de nacimiento | |
| Genial, ya tenemos tu fecha de nacimiento. ¿Qué tipo de cuenta quieres abrir? Puedes decir "ahorro", "corriente", "sueldo" o "desmaterialización". |
|
| Cuenta actual | |
| Para confirmar, ¿quieres abrir una nueva cuenta corriente? | |
| Sí | |
| Gracias por proporcionarnos la información. Espera mientras generamos tu solicitud. El ID de tu solicitud es 81037. Completa tu solicitud haciendo clic en el enlace que se ha enviado al número de teléfono móvil que has registrado. |
Usuario del dominio
El agente identifica que el usuario ya se ha autenticado y confirma qué tipo de cuenta quiere abrir. El agente crea una aplicación para el usuario y le envía instrucciones al número de teléfono registrado.
| Entrada del usuario | Respuesta del agente |
|---|---|
| Nos alegra que quieras abrir una cuenta con nosotros. ¿Qué tipo de cuenta quieres abrir? Puedes decir "ahorro", "corriente", "sueldo" o "desmaterialización". |
|
| Cuenta de ahorro, por favor | |
| Para confirmarlo, ¿quieres abrir una nueva cuenta de ahorro? | |
| Sí, es correcto | |
| Gracias por proporcionarnos la información. Espera mientras generamos tu solicitud. Tu ID de solicitud es 21430. Completa tu solicitud haciendo clic en el enlace que se ha enviado al número de teléfono móvil que has registrado. |
Aplicación ya publicada
El agente identifica que el usuario ha abierto previamente una sola aplicación y le muestra el estado actual. El usuario rechaza abrir otra aplicación para crear una cuenta.
| Entrada del usuario | Respuesta del agente |
|---|---|
| Indícanos el número de teléfono para que podamos validarlo. | |
| El agente recoge el número de teléfono del usuario mediante el componente precompilado Recogida del número de teléfono | |
| Genial, ya hemos recogido el número de teléfono. Tu solicitud con el ID 12234 para abrir una cuenta de ahorro está en curso. ¿Quieres abrir otra cuenta? |
|
| No | |
| De acuerdo, gracias por llamarnos. |
Convenciones de nombres
Este componente prediseñado usa las siguientes convenciones de nomenclatura:
| Función | Formato | Ejemplo |
|---|---|---|
| Flujo | [Component Name] | Abrir cuenta |
| Intención específica del componente | prebuilt_components_[component_name]_[intent_name] | prebuilt_components_open_account_account_type |
| Tipo de entidad | prebuilt_components_[component_name]_[entity_type] | prebuilt_components_open_account_account_type |
| Webhook | prebuilt_components_[component_name]:[webhook_action] | prebuilt_components_open_account:generate_application |
Parámetros de entrada
Los parámetros de entrada son parámetros que se usan para configurar determinados comportamientos del componente. Los parámetros los usarán una o varias condiciones del flujo para determinar cómo debe comportarse el componente. Los parámetros de ámbito de flujo deben definirse en la página de inicio del componente, tal como se describe a continuación. Los parámetros de ámbito de sesión se pueden definir mediante un flujo de llamada o en la página de inicio de este componente.
Este componente prediseñado acepta los siguientes parámetros de entrada:
| Nombre del parámetro | Descripción | Formato de entrada |
|---|---|---|
| $session.params.auth_level | (Opcional) Indica el nivel de autenticación de la persona que llama. | entero |
| $session.params.phone_number | (Opcional) Número de teléfono registrado del cliente que se usa para la autenticación. | cadena |
| $session.params.min_age_limit | Especifica la edad mínima permitida para los usuarios que abran una cuenta nueva. El valor predeterminado es 18. |
entero |
| $session.params.max_age_limit | Especifica la edad máxima permitida para los usuarios que abren una cuenta nueva. El valor predeterminado es 100. |
entero |
| $flow.max_dob_retry_count | Especifica el número de reintentos permitidos al recoger una fecha de nacimiento válida. El valor predeterminado es 2. |
entero |
| $flow.max_retry_account_type | Especifica el número de reintentos permitidos al recoger el tipo de cuenta que quiere abrir el usuario. El valor predeterminado es 2. |
entero |
| $flow.max_retry_another_account | Especifica el número de reintentos permitidos cuando el usuario quiere cambiar el tipo de cuenta que ha seleccionado. El valor predeterminado es 2. |
entero |
Para configurar los parámetros de entrada de este componente, despliega las instrucciones.
- Abre la consola de Dialogflow CX.
- Elige tu proyecto de Google Cloud.
- Selecciona tu agente.
- Selecciona la pestaña Crear.
- En la sección Flujos, haz clic en el componente importado.
- En la sección Páginas, haz clic en Página de inicio.
- Haz clic en la ruta true de la página de inicio.
- En la ventana Ruta, edita los valores de Preajustes de parámetros según sea necesario.
- Haz clic en Guardar.
Parámetros de salida
Los parámetros de salida son parámetros de sesión que permanecerán activos después de salir del componente. Estos parámetros contienen información importante recogida por el componente. Este componente prediseñado proporciona valores para los siguientes parámetros de salida:
| Nombre del parámetro | Descripción | Formato de salida |
|---|---|---|
| phone_number | Número de teléfono local del usuario, sin el código de país, que se usa para identificar al usuario. | cadena |
| transfer_reason | Este parámetro indica el motivo por el que se ha cerrado el flujo, si no se ha completado correctamente. El valor devuelto es uno de los siguientes:agent: el usuario final ha solicitado un agente humano en algún momento de la conversación.denial_of_information: el usuario final se ha negado a compartir la información solicitada por el componente.max_no_input: la conversación ha alcanzado el número máximo de reintentos para eventos sin entrada. Consulta los eventos integrados sin entrada.max_no_match: la conversación ha alcanzado el número máximo de reintentos para los eventos sin coincidencias. Consulte los eventos integrados sin coincidencias.webhook_error: se ha producido un error de webhook. Consulte el evento integrado webhook.error. webhook_not_found: no se ha podido acceder a una URL de webhook. Consulte el evento integrado webhook.error.not-found. |
cadena |
Configuración básica
Para configurar este componente prediseñado, sigue estos pasos:
- Importa el componente precompilado.
- Configura los webhooks flexibles proporcionados con la configuración que describe tus servicios externos. Consulta la sección Configuración de webhook más abajo.
Configuración de webhook
Para usar este componente, debes configurar los webhooks flexibles incluidos para obtener la información necesaria de tus servicios externos.
Verificación por teléfono
El webhook prebuilt_components_open_account:telephone_verification se usa por el componente para obtener información sobre las cuentas registradas y las aplicaciones anteriores asociadas al número de teléfono del usuario.
Parámetros de solicitud a la API
El componente proporciona los siguientes parámetros como entradas para la solicitud de la API.
| Nombre del parámetro | Descripción | Formato de entrada |
|---|---|---|
| $session.params.phone_number | Número de teléfono local del usuario, sin el código de país, que se usa para identificar al usuario. | cadena |
Parámetros de respuesta de la API
Los siguientes parámetros se extraen de la respuesta de la API para que los use el componente.
| Nombre del parámetro | Descripción | Formato de salida |
|---|---|---|
| account_count | Número de cuentas asociadas al número de teléfono registrado. Estas cuentas incluyen cuentas propias y cuentas para las que el usuario tiene un poder notarial. Si no hay ninguna cuenta asociada al número de teléfono indicado, este valor es null. |
entero |
| user_first_name | El nombre del usuario registrado. Si el número de teléfono no está asociado a ninguna cuenta registrada, este valor es null. |
cadena |
| user_last_name | Apellidos del usuario registrado. Si el número de teléfono no está asociado a ninguna cuenta registrada, este valor es null. |
cadena |
| user_dob | Fecha de nacimiento del usuario registrado en formato "AAAA-MM-DD". Si el número de teléfono no está asociado a ninguna cuenta registrada, este valor es null. |
cadena |
| application_count | Número de aplicaciones asociadas al número de teléfono registrado. Si no hay ninguna aplicación asociada al número de teléfono indicado, este valor será null. |
entero |
| application_id | Lista que contiene el ID de aplicación de cada aplicación asociada al número de teléfono indicado. Por ejemplo, ["00000", "11111", "22222"]. Cada elemento de esta lista representa la misma aplicación que el elemento con el mismo índice en account_type y application_status. Si no hay ninguna aplicación asociada al número de teléfono indicado, este valor será null. |
Lista (cadena) |
| account_type | Lista que contiene el tipo de cuenta de cada aplicación asociada al número de teléfono proporcionado. Por ejemplo, ["savings", "checking", "demat"]. Cada elemento de esta lista representa la misma aplicación que el elemento con el mismo índice en application_id y application_status. Si no hay ninguna aplicación asociada al número de teléfono indicado, este valor será null. |
Lista (cadena) |
| application_status | Lista que contiene el estado de cada solicitud asociada al número de teléfono proporcionado. Por ejemplo, ["in progress", "on hold", "completed"]. Cada elemento de esta lista representa la misma aplicación que el elemento con el mismo índice en application_id y account_type. Si no hay ninguna aplicación asociada al número de teléfono indicado, este valor será null. |
Lista (cadena) |
Para configurar el webhook de verificación telefónica de este componente, despliega las instrucciones.
- Abre la consola de Dialogflow CX.
- Elige tu proyecto de Google Cloud.
- Selecciona tu agente.
- Selecciona la pestaña Gestionar.
- Haz clic en Webhooks.
- Selecciona el webhook prebuilt_components_open_account:telephone_verification.
- Sustituye la URL del campo URL de webhook de Conversational Agents (Dialogflow CX) por el endpoint del servicio con el que quieras integrar el agente. Seleccione el Método adecuado en el menú desplegable.
- Revisa y actualiza el cuerpo de la solicitud para que tenga el formato adecuado para tu webhook.
- Revisa y actualiza la configuración de la respuesta para extraer campos específicos de la respuesta de tu webhook. No modifique los nombres de los parámetros, ya que el componente los necesita para acceder a los valores de los campos devueltos.
- Revisa y actualiza la configuración de Autenticación según sea necesario.
- Haz clic en Guardar.
Generar aplicación
El webhook prebuilt_components_open_account:generate_application lo usa el componente para generar una aplicación para una cuenta nueva.
Parámetros de solicitud a la API
El componente proporciona los siguientes parámetros como entradas para la solicitud de la API.
| Nombre del parámetro | Descripción | Formato de entrada |
|---|---|---|
| $session.params.phone_number | Número de teléfono local del usuario, sin el código de país, que se usa para identificar al usuario. | cadena |
| user_first_name | Nombre único del usuario de AppDynamics. | cadena |
| user_last_name | Apellidos del usuario. | cadena |
| user_dob | Fecha de nacimiento del usuario en formato "AAAA-MM-DD". | cadena |
Parámetros de respuesta de la API
Los siguientes parámetros se extraen de la respuesta de la API para que los use el componente.
| Nombre del parámetro | Descripción | Formato de salida |
|---|---|---|
| application_id | ID de aplicación generado para la nueva solicitud de cuenta. | cadena |
Para configurar el webhook de la aplicación Generate de este componente, consulta las instrucciones.
- Abre la consola de Dialogflow CX.
- Elige tu proyecto de Google Cloud.
- Selecciona tu agente.
- Selecciona la pestaña Gestionar.
- Haz clic en Webhooks.
- Selecciona el webhook prebuilt_components_open_account:generate_application.
- Sustituye la URL del campo URL de webhook de Conversational Agents (Dialogflow CX) por el endpoint del servicio con el que quieras integrar el agente. Seleccione el Método adecuado en el menú desplegable.
- Revisa y actualiza el cuerpo de la solicitud para que tenga el formato adecuado para tu webhook.
- Revisa y actualiza la configuración de la respuesta para extraer campos específicos de la respuesta de tu webhook. No modifique los nombres de los parámetros, ya que el componente los necesita para acceder a los valores de los campos devueltos.
- Revisa y actualiza la configuración de Autenticación según sea necesario.
- Haz clic en Guardar.
Completado
Tu agente y sus webhooks ya deberían estar configurados y listos para probarse.