El componente empieza recogiendo el número de teléfono del usuario final para identificar si es un cliente nuevo o actual. En el caso de un nuevo usuario, el componente recogerá los detalles necesarios, como sus ingresos mensuales y la categoría de gastos o las ventajas de la tarjeta que solicite el usuario. Una vez que se ha recogido toda la información necesaria, el componente organiza una devolución de llamada y proporciona el número de solicitud al usuario.
En el caso de un cliente actual, el componente recuperará la información del usuario registrado y mostrará las opciones de tarjeta disponibles al usuario final en función de sus preferencias y de la información recuperada, incluida su puntuación de crédito. Una vez que el cliente haya seleccionado una opción de tarjeta, el componente enviará un enlace para completar el procedimiento de registro a través de los canales registrados, como WhatsApp o SMS.
Este componente usa los componentes prediseñados Recogida del número de teléfono y Recogida del código postal para recoger y validar los detalles del usuario.
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 componente comprueba si el usuario llama con un número de teléfono registrado e identifica que es un usuario nuevo. El componente recoge la categoría de tarjeta para la que quiere registrarse el usuario y recoge información para identificarlo, como el código postal y el número de teléfono. A continuación, el componente organiza una devolución de llamada y proporciona al usuario el número de solicitud.
| Entrada del usuario | Respuesta del agente |
|---|---|
| ¿Podrías confirmar si ya eres cliente de nuestro banco? | |
| No | |
| Nos alegra que quieras solicitar una tarjeta de crédito con nosotros. Tenemos una amplia gama de tarjetas de crédito que se adaptan a tus necesidades. Para ofrecerte las mejores tarjetas disponibles, ¿podrías indicarnos tus ingresos mensuales en dólares estadounidenses? |
|
| 5000 dólares | |
| ¿Qué gastos o prestaciones te interesan? Tenemos varias opciones disponibles, como viajes, combustible y compras. | |
| Me gusta ir de compras | |
| La respuesta que has seleccionado pertenece a la categoría de compras. Si quieres continuar, di que sí. | |
| Sí | |
| El agente recoge el código postal del usuario mediante el componente prediseñado Recogida de código postal | |
| Has mencionado que el código postal es 10011, ¿es correcto? | |
| Sí, es correcto | |
| Genial, ya hemos terminado de recoger el código postal. | |
| El agente recoge el número de teléfono del usuario mediante el componente precompilado Recogida del número de teléfono | |
| Entendido. El número que has mencionado es +1 6502530000, ¿es correcto? | |
| Sí | |
| Estupendo, ya hemos recogido el número de teléfono. Uno de nuestros representantes te llamará para hablar sobre las tarjetas relacionadas según tus criterios. Tu número de solicitud es 993835. |
Cliente actual
El componente identifica al cliente registrado mediante su número de teléfono. A continuación, el componente solicita información como la categoría y el tipo de tarjeta que quiere registrar el usuario. Una vez que se haya confirmado esta información, el componente pedirá al cliente que seleccione un canal para completar el proceso de registro y enviará el enlace al canal registrado del cliente.
| Entrada del usuario | Respuesta del agente |
|---|---|
| Nos alegra que sigas eligiendo nuestros productos y servicios. Tenemos una amplia gama de tarjetas de crédito que se adaptan a tus necesidades. ¿Qué gastos o ventajas te interesan? Tenemos varias opciones disponibles, como viajes, combustible y compras. |
|
| Quiero una tarjeta que pueda usar en mis próximas vacaciones | |
| La respuesta que has seleccionado pertenece a la categoría de viajes. Si quieres continuar, di que sí. | |
| Sí | |
| Hay tres tipos de tarjetas para adaptarse a tu tipo de solicitud: tarjeta de viaje platino, tarjeta de viaje oro y tarjeta de viaje clásica. ¿Quieres saber información sobre todas las tarjetas o sobre una en concreto? Por ejemplo, si buscas una tarjeta clásica, di "tarjeta clásica". | |
| ¿Puedes informarme sobre la tarjeta Platinum? | |
| Claro, la cuota anual de la tarjeta de viaje Platinum es de 95 dólares. Entre las ventajas se incluyen las siguientes: consigue 10.000 millas extra cada año, gana el doble de millas en todas las demás compras, y las millas son fáciles de conseguir y de usar. Puedes consultar más información sobre las ventajas o los bonos en nuestro sitio web. Confirma si quieres solicitar la tarjeta de viaje Platinum. |
|
| Sí, vamos a hacerlo | |
| Te enviaremos un enlace con los pasos del procedimiento de registro. ¿Quieres que compartamos los detalles de esta tarjeta con tu número de móvil por SMS o WhatsApp? | |
| SMS, por favor | |
| De acuerdo, vamos a enviar el enlace a tu número de móvil registrado. Esta acción puede tardar unos segundos. ¿Puedes confirmar si has recibido el enlace diciendo sí o no? | |
| Lo tengo | |
| Genial. Ahora puedes abrir el enlace y consultar los detalles del registro de la tarjeta. Una vez que se hayan completado los datos, se iniciará la emisión de la nueva tarjeta y se enviará a tu dirección actual. |
Negación de información
El usuario se niega a proporcionar la información necesaria para solicitar una tarjeta de crédito. El componente sale con un mensaje de error.
| Entrada del usuario | Respuesta del agente |
|---|---|
| ¿Podrías confirmar si ya eres cliente de nuestro banco? | |
| No | |
| Nos alegra que quieras solicitar una tarjeta de crédito con nosotros. Tenemos una amplia gama de tarjetas de crédito que se adaptan a tus necesidades. Para ofrecerte las mejores tarjetas disponibles, ¿podrías indicarnos tus ingresos mensuales en dólares estadounidenses? |
|
| No quiero darte esa información | |
| Gracias por llamar. Lamentablemente, no podemos continuar sin la información solicitada en este momento. |
Convenciones de nombres
Este componente prediseñado usa las siguientes convenciones de nomenclatura:
| Función | Formato | Ejemplo |
|---|---|---|
| Flujo | [Component Name] | Registro de tarjeta de crédito |
| Intención específica del componente | prebuilt_components_[component_name]_[intent_name] | prebuilt_components_cc_enroll_collect_cardtype |
| Tipo de entidad | prebuilt_components_[component_name]_[entity_type] | prebuilt_components_cc_enroll_expense_category |
| Webhook | prebuilt_components_[component_name]:[webhook_action] | prebuilt_components_credit_card_enrollment:get_available_card |
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 actual del usuario final. | entero |
| $session.params.phone_number | (Opcional) Número de teléfono del usuario final. Si no se proporciona este parámetro, el componente recogerá el número de teléfono del usuario final. | cadena |
| $flow.max_retry_count | Especifica el número de reintentos que se le dan al usuario final. El valor predeterminado es 3. |
entero |
| $flow.currency_name | Especifica la moneda que se espera al recoger los detalles de los ingresos mensuales. El valor predeterminado es "USD". |
cadena |
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.
Obtener los detalles de la cuenta
El webhook prebuilt_components_credit_card_enrollment:get_account_details lo usa el componente para obtener los detalles de la cuenta del usuario, si existe.
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. | entero |
| credit_score | La calificación crediticia registrada del usuario. | entero |
Para configurar el webhook Get account 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_credit_card_enrollment:get_account_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.
Obtener el número de tarjetas
El webhook prebuilt_components_credit_card_enrollment:get_card_count lo usa el componente para obtener el número de tarjetas de crédito asociadas a las cuentas de un usuario registrado.
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 |
|---|---|---|
| card_count | El número total de tarjetas de crédito de las cuentas de un usuario registrado. | entero |
Para configurar el webhook Get card count 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_credit_card_enrollment:get_card_count.
- 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.
Obtener tarjetas disponibles
El webhook prebuilt_components_credit_card_enrollment:get_available_card lo usa el componente para obtener la lista de tarjetas disponibles para el usuario de una categoría específica en función de su historial crediticio.
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 |
|---|---|---|
| $flow.expense_category | La categoría de gastos que ha seleccionado el usuario para registrarse. Los valores válidos se definen en la entidad personalizada prebuilt_components_cc_enroll_expense_category. De forma predeterminada, se admiten fuel, shopping y travel. |
cadena |
| $flow.credit_score | La calificación crediticia del usuario, obtenida por el componente mediante el webhook Get account details (Obtener detalles de la cuenta). | entero |
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 |
|---|---|---|
| available_card_names | Lista de tarjetas disponibles para el usuario, por ejemplo, ["gold shopping card","classic shopping card"]. |
Lista (cadena) |
| cards_count | Número de tarjetas disponibles para el usuario. | entero |
Para configurar el webhook Get available cards 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_credit_card_enrollment:get_available_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.
Obtener los detalles de la tarjeta seleccionada
El webhook prebuilt_components_credit_card_enrollment:get_selected_card lo usa el componente para obtener las cuotas anuales y las ventajas de la 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 |
|---|---|---|
| $flow.card_type | El tipo de tarjeta que ha seleccionado el usuario para registrarse. Los valores válidos se definen en la entidad personalizada prebuilt_components_cc_enroll_card_type. De forma predeterminada, se admiten classic, gold y platinum. |
cadena |
| $flow.expense_category | La categoría de gastos que ha seleccionado el usuario para registrarse. Los valores válidos se definen en la entidad personalizada prebuilt_components_cc_enroll_expense_category. De forma predeterminada, se admiten fuel, shopping y travel. |
cadena |
| $flow.credit_score | La calificación crediticia del usuario, obtenida por el componente mediante el webhook Get account details (Obtener detalles de la cuenta). | entero |
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 |
|---|---|---|
| selected_card_benefits | Información sobre las ventajas de la tarjeta seleccionada. | cadena |
| selected_card_annual_fee | La cuota anual de la tarjeta seleccionada. | entero |
| selected_card_name | El nombre de la tarjeta seleccionada. | cadena |
Para configurar el webhook Get selected 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_credit_card_enrollment:get_selected_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.
Enviar solicitud de registro
El webhook prebuilt_components_credit_card_enrollment:submit_enroll se usa por el componente para crear una solicitud de registro de tarjeta basada en las preferencias y los detalles del usuario nuevo.
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 |
| $flow.zipcode | Código postal proporcionado por el usuario. | cadena |
| $flow.monthly_salary | Salario mensual proporcionado por el usuario. | entero |
| $flow.currency_name | Moneda del salario mensual, configurada en los parámetros de entrada del componente. Consulta los parámetros de entrada. | 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 |
|---|---|---|
| request_number | Número de solicitud del registro correcto de la solicitud de registro de la tarjeta. | entero |
Para configurar el webhook de envío de solicitudes de registro 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_credit_card_enrollment:submit_enroll.
- 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.
Enviar mensaje
El webhook prebuilt_components_credit_card_enrollment:send_message lo usa el componente para enviar un mensaje que contiene un enlace para completar el registro de la tarjeta de crédito de los clientes actuales.
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 |
| $flow.channel | Canal que ha seleccionado el usuario para recibir el mensaje. Los valores válidos se definen en la entidad personalizada prebuilt_components_cc_enroll_channel. De forma predeterminada, se admiten SMS y WhatsApp. |
cadena |
| $flow.selected_card_name | Lista de tarjetas seleccionadas por el usuario, por ejemplo, ["gold shopping card","classic shopping card"]. |
Lista (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 |
|---|---|---|
| message_sent | Indica si el mensaje se ha enviado correctamente al canal especificado por el usuario. | booleano |
Para configurar el webhook de envío de mensajes 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_credit_card_enrollment:send_message.
- 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.