El componente precompilado de la tarjeta de bloqueo autentica al usuario, obtiene las tarjetas registradas y permite que el usuario bloquee una tarjeta temporalmente, la bloquee permanentemente o la reactive. Después de confirmar una tarjeta bloqueada, el componente permite al usuario solicitar una nueva tarjeta. Este componente usa una versión personalizada del componente prediseñado Authentication para autenticar a los titulares de tarjetas.
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 no autenticado con varias tarjetas
El agente identifica que el usuario no se ha autenticado previamente y recoge información para verificar que es el titular de la tarjeta registrada. Una vez que el usuario se ha autenticado, el agente obtiene información sobre las tarjetas registradas por el usuario. El usuario confirma que quiere bloquear temporalmente una tarjeta seleccionada y el agente genera la solicitud de bloqueo.
| Entrada del usuario | Respuesta del agente |
|---|---|
| El agente autentica al usuario mediante el componente prediseñado Autenticación. | |
| Gracias, se ha autenticado correctamente. | |
| Espera mientras obtenemos los detalles de tu tarjeta. Hemos encontrado varias tarjetas registradas con tu número. Tenemos una tarjeta Visa que termina en 5555, otra Visa que termina en 6666, una MasterCard que termina en 4444 y otra MasterCard que termina en 4449. Indícanos los cuatro últimos dígitos de la tarjeta que quieras bloquear o reactivar. |
|
| 4444 | |
| Los últimos cuatro dígitos del número de la tarjeta que tenemos son 4444. ¿Son correctos? | |
| Sí | |
| ¿Quieres bloquear tu tarjeta de forma temporal o permanente? | |
| Quiero bloquearlo temporalmente | |
| Indícanos por qué quieres bloquear tu tarjeta. Puedes elegir entre opciones como dañado, robado, perdido u otras. | |
| Se ha dañado | |
| Lo siento. Por motivos de seguridad, debemos validar tu identidad, por lo que te enviaremos un código. ¿Prefieres recibir el código por teléfono o por correo electrónico? | |
| Envíalo a mi teléfono | |
| Antes de continuar, vamos a enviar un código al número de móvil que has registrado. ¿Puedes confirmar tu código para validar la solicitud? | |
| 123456 | |
| De acuerdo, tu tarjeta que termina en 4444 se bloqueará temporalmente. Una vez bloqueada, no podrás hacer ninguna transacción online ni en terminales de puntos de venta con esa tarjeta. ¿Confirmas esta acción? | |
| Sí | |
| Tu tarjeta se ha bloqueado correctamente. Tu número de solicitud es el 9711485 y se ha compartido correctamente con tu número de móvil registrado. |
Usuario autenticado con una sola tarjeta
El agente identifica que el usuario ya se ha autenticado y obtiene información sobre la tarjeta registrada por el usuario. El usuario selecciona la opción para bloquear la tarjeta permanentemente y el agente genera la solicitud de bloqueo permanente de la tarjeta. A continuación, el agente pregunta al usuario si quiere volver a emitir una tarjeta nueva para la tarjeta bloqueada permanentemente y crea una solicitud de reedición de la tarjeta.
| Entrada del usuario | Respuesta del agente |
|---|---|
| Espera mientras obtenemos los detalles de tu tarjeta. Hemos encontrado tu MasterCard que acaba en 4444. ¿Quieres bloquear tu tarjeta de forma temporal o permanente? |
|
| Permanentemente | |
| Indícanos por qué quieres bloquear tu tarjeta. Puedes elegir entre opciones como dañado, robado, perdido u otras. | |
| Estaba dañado | |
| Lo siento. No te preocupes, bloquearemos tu tarjeta de forma permanente. ¿Puedes confirmar si la tarjeta termina en 4444? | |
| Sí | |
| Antes de continuar, vamos a enviar un código al número de móvil que has registrado. ¿Puedes confirmar tu código para validar la solicitud? | |
| 123456 | |
| De acuerdo, tu tarjeta que termina en 4444 se bloqueará temporalmente. Una vez bloqueada, no podrás hacer ninguna transacción online ni en terminales de puntos de venta con esa tarjeta. ¿Confirmas esta acción? | |
| Sí | |
| Tu tarjeta se ha bloqueado correctamente. El número de tu solicitud es el 6108410 y se ha compartido correctamente con tu número de móvil registrado. ¿Quieres volver a emitir una tarjeta? |
|
| Sí | |
| Enviaremos la tarjeta a tu dirección registrada. ¿Puedes confirmar el código postal de tu dirección de entrega, 12345? | |
| Es correcto | |
| De acuerdo, espera unos segundos mientras enviamos la solicitud para volver a emitir una tarjeta nueva. La solicitud para volver a emitir la tarjeta nueva se ha enviado correctamente. Tu número de solicitud es el 3808109 y se ha compartido correctamente con tu número de móvil registrado. La tarjeta se entregará en tu dirección registrada en un plazo de 3 días hábiles. Para usar la tarjeta, sigue las instrucciones que se te hayan proporcionado. |
Reactivar tarjeta
El agente identifica que el usuario necesita autenticación adicional y envía una contraseña de un solo uso para verificar su identidad. El usuario solicita reactivar una tarjeta y el agente le pasa con un agente humano para continuar.
| Entrada del usuario | Respuesta del agente |
|---|---|
| Por motivos de seguridad, debemos validar tu identidad, por lo que te enviaremos un código. ¿Prefieres recibir el código por teléfono? | |
| Sí | |
| Hemos enviado un código a tu número de teléfono registrado, que termina en 5041. Este proceso puede tardar unos segundos. ¿Puede confirmar el código? | |
| 123456 | |
| Gracias, se ha validado correctamente. Espera mientras obtenemos los detalles de tu tarjeta. Hemos encontrado varias tarjetas registradas con tu número. Tenemos una tarjeta Visa que acaba en 1456, una MasterCard que acaba en 1457, una American Express que acaba en 1345 y una Visa que acaba en 3456. Dinos los cuatro últimos dígitos de la tarjeta que quieras bloquear o reactivar. |
|
| 1456 | |
| Los cuatro últimos dígitos del número de la tarjeta que hemos recibido son 1456. ¿Son correctos? | |
| Sí | |
| La tarjeta solicitada ya está bloqueada temporalmente. ¿Quieres reactivar la tarjeta o bloquearla permanentemente? | |
| Reactivarlo | |
| Mantente a la espera mientras transferimos tu llamada para poder ayudarte mejor. |
Convenciones de nombres
Este componente prediseñado usa las siguientes convenciones de nomenclatura:
| Función | Formato | Ejemplo |
|---|---|---|
| Flujo | [Component Name] | Bloquear tarjeta |
| Tipo de entidad | prebuilt_components_[component_name]_[entity_type] | prebuilt_components_lock_card_locked_reason |
| Webhook | prebuilt_components_[component_name]:[webhook_action] | prebuilt_components_lock_card:lock_card_ticket_number |
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.auth_level_req | Indica el nivel de autenticación necesario para que un usuario pueda acceder a su historial de transacciones. Este valor se configura en los preajustes de parámetros del cumplimiento de la entrada de página de la página check auth level. De forma predeterminada, este valor es 1. |
entero |
| $session.params.account_auth_enabled | Indica si el usuario debe autenticarse como titular de la cuenta, tal como se describe en Tipos de autenticación. Este valor se configura en los preajustes de parámetros del cumplimiento de la entrada de página de la página check auth level. De forma predeterminada, este valor es false. |
booleano |
| $session.params.card_auth_enabled | Indica si el usuario debe autenticarse como titular de la tarjeta, tal como se describe en Tipos de autenticación. Este valor se configura en los preajustes de parámetros del cumplimiento de la entrada de página de la página check auth level. De forma predeterminada, este valor es true. |
booleano |
| $session.params.phone_number | (Opcional) Número de teléfono registrado del cliente que se usa para la autenticación. | cadena |
| $session.params.card_count | (opcional) Número de tarjetas de crédito asociadas al usuario autenticado. | entero |
| $flow.card_status_active | Especifica el valor del parámetro devuelto por el webhook de validación de tarjeta para indicar que la tarjeta seleccionada está activa. De forma predeterminada, el valor es "active". |
cadena |
| $flow.card_status_lock_temp | Especifica el valor del parámetro devuelto por el webhook de validación de tarjeta para indicar que la tarjeta seleccionada está bloqueada temporalmente. De forma predeterminada, el valor es "inactive". |
cadena |
| $flow.card_status_lock_permanent | Especifica el valor del parámetro devuelto por el webhook de validación de tarjeta para indicar que la tarjeta seleccionada está bloqueada permanentemente. De forma predeterminada, el valor es "blocked". |
cadena |
| $flow.card_status_reactivate | Especifica el valor del parámetro devuelto por el webhook de la tarjeta de validación para indicar que la tarjeta seleccionada se ha reactivado. De forma predeterminada, el valor es "reactivate". |
cadena |
| $flow.max_retry_card_number | Especifica el número de reintentos permitidos al recoger los cuatro últimos dígitos de la tarjeta de crédito. El valor predeterminado es 3. |
entero |
| $flow.max_otp_retry_count | Especifica el número de reintentos permitidos al recoger la contraseña de un solo uso (OTP) del usuario. El valor predeterminado es 3. |
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 |
|---|---|---|
| auth_level | Indica el nivel de autenticación de la persona que llama. | entero |
| 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 |
| card_count | El número de tarjetas asociadas al número de teléfono registrado. | entero |
| last_four_digit_of_card_number | Si un usuario tiene una sola tarjeta, se devuelven los cuatro últimos dígitos del número de la tarjeta. Si un usuario tiene más de una tarjeta, el valor de este parámetro son los cuatro últimos dígitos de la tarjeta que ha seleccionado para bloquearla o para solicitar una nueva. | 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.
Autenticación
Si no has configurado previamente los servicios externos necesarios para la autenticación, tendrás que hacerlo para habilitar la autenticación de los usuarios de este componente. Consulta las instrucciones detalladas en el artículo sobre la configuración del webhook de autenticación.
Obtener los detalles de la tarjeta
El webhook prebuilt_components_account_services:get_card_details lo usa el componente para obtener información sobre las tarjetas registradas de un 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 |
|---|---|---|
| last_four_digit_of_all_cards | Lista que contiene los últimos cuatro dígitos de cada tarjeta registrada del usuario. Por ejemplo, ["0000", "1111", "2222"]. Cada elemento de esta lista representa la misma tarjeta que el elemento con el mismo índice en card_vendor_all. |
Lista (cadena) |
| card_vendor_all | Lista que contiene el proveedor de la tarjeta de crédito de cada tarjeta registrada por el usuario. Por ejemplo, ["Visa", "Mastercard", "Discover"]. Cada elemento de esta lista representa la misma tarjeta que el elemento con el mismo índice en last_four_digit_of_all_cards. |
Lista (cadena) |
| card_count | Número de tarjetas asociadas al usuario autenticado. | entero |
Para configurar el webhook Get card details 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_account_services:get_card_details.
- 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.
Validar tarjeta
El webhook prebuilt_components_lock_card:validate_card lo usa el componente para obtener información sobre una tarjeta específica registrada en la cuenta de un 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 |
| $session.params.last_four_digit_of_card_number | Los cuatro últimos dígitos del número de la tarjeta que el usuario ha solicitado bloquear. | 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 |
|---|---|---|
| zip_code | El código postal registrado en la cuenta del usuario. | cadena |
| card_vendor | El proveedor de la tarjeta de crédito seleccionada. | cadena |
| card_status | Indica el estado actual de la tarjeta. De forma predeterminada, los valores válidos son activo, bloqueado temporalmente o bloqueado permanentemente. Estos estados se especifican mediante los parámetros $flow.card_status_active, $flow.card_status_lock_temp y $flow.card_status_lock_permanent. Consulta los parámetros de entrada. |
cadena |
Para configurar el webhook Validate card 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_lock_card:validate_card.
- 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.
Bloquear tarjeta
El webhook prebuilt_components_lock_card:lock_card_ticket_number lo usa el componente para crear una solicitud de bloqueo de una tarjeta seleccionada.
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 |
| $session.params.last_four_digit_of_card_number | Los cuatro últimos dígitos del número de la tarjeta que el usuario ha solicitado bloquear. | cadena |
| $flow.lock_type | Indica el tipo de bloqueo que se aplicará a la tarjeta del usuario. Los valores válidos se definen en la entidad personalizada prebuilt_components_lock_card_lock_type_active. De forma predeterminada, se admiten "blocked" (bloqueo permanente) y "inactive (bloqueo temporal). |
cadena |
| $flow.lock_reason | Indica el motivo por el que el usuario ha solicitado que se bloquee la tarjeta. Los valores válidos se definen en la entidad personalizada prebuilt_components_lock_card_locked_reason. De forma predeterminada, se admiten "damaged", "stolen", "lost" y "others". |
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 |
|---|---|---|
| ticket_number | Número de la incidencia de la solicitud de tarjeta de acceso creada. | entero |
Para configurar el webhook de la tarjeta de bloqueo 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_lock_card:lock_card_ticket_number.
- 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.
Reemitir tarjeta
El webhook prebuilt_components_lock_card:reissue_card_number lo usa el componente para crear una solicitud de reedición de una tarjeta nueva o actualizada.
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 |
| $session.params.last_four_digit_of_card_number | Los cuatro últimos dígitos del número de la tarjeta que el usuario ha solicitado bloquear. | cadena |
| zip_code | El código postal registrado en la cuenta del 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 |
|---|---|---|
| acknowledgement_number | Número de incidencia de la solicitud de reedición de tarjeta creada. | entero |
Para configurar el webhook de la tarjeta de reedición 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_lock_card:reissue_card_number.
- 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.