El componente prediseñado de inscripción de tarjetas de crédito permite que los clientes nuevos y existentes soliciten una tarjeta de crédito nueva.
El componente comienza recopilando el número de teléfono del usuario final para identificar si es un cliente nuevo o existente. En el caso de un usuario nuevo, el componente recopilará los detalles necesarios, incluidos sus ingresos mensuales y la categoría de gastos o los beneficios de la tarjeta que solicita el usuario. Una vez que se recopila toda la información requerida, el componente organiza una devolución de llamada y le proporciona al usuario el número de solicitud.
En el caso de un cliente existente, el componente recuperará la información del usuario registrado y presentará las opciones de tarjetas disponibles al usuario final según sus preferencias y la información recuperada, incluido su puntaje crediticio. Una vez que el cliente haya seleccionado una opción de tarjeta, el componente enviará un vínculo para completar el procedimiento de inscripción a través de los canales registrados, incluidos WhatsApp o SMS.
Este componente usa los componentes prediseñados Recopilación de número de teléfono y Recopilación de código postal para recopilar 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 encripta ningún dato.
Diálogos de muestra
En los siguientes diálogos de ejemplo, se muestran situaciones comunes que maneja este componente prediseñado. Los diálogos de muestra demuestran el comportamiento cuando se llama al componente a través de la 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 verifica si el usuario está llamando con un número de teléfono registrado y lo identifica como usuario nuevo. El componente recopila la categoría de tarjeta para la que el usuario desea inscribirse y recopila información para identificar al usuario, incluidos el código postal y el número de teléfono. Luego, el componente organiza una devolución de llamada y le 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 lo soy. | |
| Nos complace que quieras solicitar una tarjeta de crédito con nosotros. Tenemos una amplia variedad de tarjetas de crédito adecuadas para ti. Para ofrecerte las mejores tarjetas disponibles, ¿podrías indicar tus ingresos mensuales en USD? |
|
| 5,000 dólares | |
| ¿Qué gastos o beneficios te interesan? Tenemos una variedad de opciones disponibles, como viajes, combustible y compras. | |
| Me gusta ir de compras | |
| La respuesta seleccionada pertenece a la categoría de compras. Si quieres continuar, di que sí. | |
| Sí | |
| El agente recopila el código postal del usuario con el componente prediseñado Recopilación de código postal | |
| Mencionaste que el código postal es 10011, ¿es correcto? | |
| Sí, así es. | |
| Excelente. Ya terminamos de recopilar el código postal. | |
| El agente recopila el número de teléfono del usuario con el componente prediseñado Recopilación del número de teléfono | |
| Entendido. El número que mencionaste es el +1 6502530000, ¿es correcto? | |
| Sí | |
| Excelente. Terminamos de recopilar el número de teléfono. Uno de nuestros representantes te devolverá la llamada para hablar sobre las tarjetas relacionadas según tus criterios. El número de tu solicitud es 993835. |
Cliente existente
El componente identifica al cliente registrado con su número de teléfono. Luego, el componente solicita información, como la categoría y el tipo de tarjeta para la que el usuario desea inscribirse. Una vez que se confirma esta información, el componente le pide al cliente que seleccione un canal para completar el proceso de inscripción y le envía el vínculo al canal registrado del cliente.
| Entrada del usuario | Respuesta del agente |
|---|---|
| Nos complace que sigas eligiendo nuestros productos y servicios. Tenemos una amplia variedad de tarjetas de crédito que se adaptan a tus necesidades. ¿Qué gastos o beneficios te interesan? Tenemos una variedad de opciones disponibles, como viajes, combustible y compras. |
|
| Quiero una tarjeta que pueda usar en mis próximas vacaciones | |
| La respuesta que seleccionaste pertenece a la categoría de viajes. Si quieres continuar, di que sí. | |
| Sí | |
| Existen 3 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 conocer la información de todas las tarjetas o de una específica? Por ejemplo, si buscas específicamente una tarjeta clásica, di "tarjeta clásica". | |
| ¿Puedes contarme sobre la tarjeta Platinum? | |
| Claro, para una tarjeta de viaje Platinum, la tarifa anual es de USD 95. Entre los beneficios, se incluyen los siguientes: obtén 10,000 millas de bonificación cada año, obtén el doble de millas ilimitadas en todas las demás compras, y las millas son fáciles de obtener y usar. Puedes encontrar más información sobre los beneficios o las bonificaciones en nuestro sitio web. Confirma si deseas inscribirte en la tarjeta de viaje Platinum. |
|
| Sí, hagámoslo. | |
| Te enviaremos un vínculo con los pasos del procedimiento de inscripción. ¿Quieres que compartamos los detalles de esta tarjeta con tu número de celular por SMS o WhatsApp? | |
| SMS, por favor | |
| De acuerdo. Enviaremos el vínculo a tu número de celular registrado. Esta acción puede tardar unos segundos. ¿Puedes confirmar si recibiste el vínculo con un sí o un no? | |
| Ya lo tengo | |
| Excelente. Ahora puedes abrir el vínculo y verificar los detalles de la inscripción de la tarjeta. Una vez que se completen los datos, se iniciará la emisión de la nueva tarjeta y se enviará a tu dirección actual. |
Denegación de información
El usuario rechaza proporcionar la información necesaria para inscribirse en una tarjeta de crédito. El componente se cierra con un mensaje de error.
| Entrada del usuario | Respuesta del agente |
|---|---|
| ¿Podrías confirmar si ya eres cliente de nuestro banco? | |
| No, no lo soy. | |
| Nos complace que quieras solicitar una tarjeta de crédito con nosotros. Tenemos una amplia variedad de tarjetas de crédito adecuadas para ti. Para ofrecerte las mejores tarjetas disponibles, ¿podrías indicar tus ingresos mensuales en USD? |
|
| No quiero darte esa información | |
| Gracias por llamar. Lamentamos no poder 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 | [Nombre del componente] | Inscripción 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 los que se usan para configurar ciertos comportamientos del componente. Los parámetros se usarán en una o más condiciones dentro del flujo para determinar cómo debe comportarse el componente. Los parámetros con alcance de flujo se deben establecer en la página de inicio del componente, como se describe a continuación. Los parámetros con alcance de sesión se pueden establecer a través de 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. | integer |
| $session.params.phone_number | (Opcional) Número de teléfono del usuario final. Si no se proporciona este parámetro, el componente recopilará el número de teléfono del usuario final. | cadena |
| $flow.max_retry_count | Especifica la cantidad de reintentos que se le otorgan al usuario final. El valor predeterminado es 3. |
integer |
| $flow.currency_name | Especifica la moneda esperada cuando se recopilan los detalles de los ingresos mensuales. El valor predeterminado es "USD". |
cadena |
Para configurar los parámetros de entrada de este componente, expande las instrucciones.
- Abre la consola de Dialogflow CX.
- Elige tu proyecto de Google Cloud.
- Selecciona el agente.
- Selecciona la pestaña Build.
- Haz clic en el componente importado en la sección Flujos.
- Haz clic en la página de inicio en la sección Pages.
- Haz clic en la ruta true en la página de inicio.
- En la ventana Route, edita los valores de Parameter Presets según sea necesario.
- Haz clic en Guardar.
Los parámetros de resultado
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 que recopila 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 salió del flujo, si no se completó correctamente. El valor devuelto es uno de los siguientes:agent: El usuario final solicitó un agente humano en algún momento de la conversación.denial_of_information: El usuario final se negó a compartir la información que solicitó el componente.max_no_input: La conversación alcanzó la cantidad máxima de reintentos para los eventos sin entrada. Consulta los eventos integrados sin entrada.max_no_match: La conversación alcanzó la cantidad máxima de reintentos para los eventos de sin coincidencia. Consulta los eventos integrados de sin coincidencia.webhook_error: Se produjo un error de webhook. Consulta el evento integrado webhook.error. webhook_not_found: No se pudo acceder a una URL de webhook. Consulta el evento integrado webhook.error.not-found. |
cadena |
Configuración básica
Para configurar este componente prediseñado, haz lo siguiente:
- Importa el componente compilado previamente.
- Configura los webhooks flexibles proporcionados con la configuración que describe tus servicios externos. Consulta la configuración de webhook a continuación.
Configuración de webhook
Para usar este componente, deberás configurar los webhooks flexibles incluidos para recuperar la información necesaria de tus servicios externos.
Obtener detalles de la cuenta
El webhook prebuilt_components_credit_card_enrollment:get_account_details se usa en el componente para recuperar los detalles de la cuenta del usuario, si existe una cuenta.
Parámetros de la solicitud a la API
El componente proporciona los siguientes parámetros como entradas para la solicitud a 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
El componente usa los siguientes parámetros extraídos de la respuesta de la API.
| Nombre del parámetro | Descripción | Formato de salida |
|---|---|---|
| account_count | Es la cantidad de cuentas asociadas al número de teléfono registrado. | integer |
| credit_score | Es la calificación crediticia registrada del usuario. | integer |
Para configurar el webhook Get account details para este componente, expande las instrucciones.
- Abre la consola de Dialogflow CX.
- Elige tu proyecto de Google Cloud.
- Selecciona el agente.
- Selecciona la pestaña Administrar.
- Haz clic en Webhooks.
- Selecciona el webhook prebuilt_components_credit_card_enrollment:get_account_details.
- Reemplaza la URL en el campo URL de webhook de Dialogflow CX por el extremo del servicio con el que deseas realizar la integración. Selecciona el Método adecuado en el menú desplegable.
- Revisa y actualiza el cuerpo de la solicitud para formar el formato de solicitud adecuado para tu webhook.
- Revisa y actualiza la configuración de respuesta para extraer campos específicos de la respuesta de tu webhook. No modifiques 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 Authentication según sea necesario.
- Haz clic en Guardar.
Obtener el recuento de tarjetas
El webhook prebuilt_components_credit_card_enrollment:get_card_count lo usa el componente para recuperar la cantidad de tarjetas de crédito asociadas a las cuentas de un usuario registrado.
Parámetros de la solicitud a la API
El componente proporciona los siguientes parámetros como entradas para la solicitud a 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
El componente usa los siguientes parámetros extraídos de la respuesta de la API.
| Nombre del parámetro | Descripción | Formato de salida |
|---|---|---|
| card_count | Es la cantidad total de tarjetas de crédito en las cuentas de un usuario registrado. | integer |
Para configurar el webhook de recuento de tarjetas Get para este componente, expande las instrucciones.
- Abre la consola de Dialogflow CX.
- Elige tu proyecto de Google Cloud.
- Selecciona el agente.
- Selecciona la pestaña Administrar.
- Haz clic en Webhooks.
- Selecciona el webhook prebuilt_components_credit_card_enrollment:get_card_count.
- Reemplaza la URL en el campo URL de webhook de Dialogflow CX por el extremo del servicio con el que deseas realizar la integración. Selecciona el Método adecuado en el menú desplegable.
- Revisa y actualiza el cuerpo de la solicitud para formar el formato de solicitud adecuado para tu webhook.
- Revisa y actualiza la configuración de respuesta para extraer campos específicos de la respuesta de tu webhook. No modifiques 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 Authentication según sea necesario.
- Haz clic en Guardar.
Obtén tarjetas disponibles
El webhook prebuilt_components_credit_card_enrollment:get_available_card lo usa el componente para recuperar la lista de tarjetas disponibles para el usuario en una categoría específica según su calificación crediticia.
Parámetros de la solicitud a la API
El componente proporciona los siguientes parámetros como entradas para la solicitud a la API.
| Nombre del parámetro | Descripción | Formato de entrada |
|---|---|---|
| $flow.expense_category | Es la categoría de gastos que seleccionó el usuario para inscribirse. Los valores válidos se definen con la entidad personalizada prebuilt_components_cc_enroll_expense_category. De forma predeterminada, se admiten fuel, shopping y travel. |
cadena |
| $flow.credit_score | Es la calificación crediticia del usuario, que el componente recupera con el webhook Get account details. | integer |
Parámetros de respuesta de la API
El componente usa los siguientes parámetros extraídos de la respuesta de la API.
| Nombre del parámetro | Descripción | Formato de salida |
|---|---|---|
| available_card_names | Es la lista de tarjetas disponibles para el usuario, por ejemplo, ["gold shopping card","classic shopping card"]. |
Lista (cadena) |
| cards_count | Es la cantidad de tarjetas disponibles para el usuario. | integer |
Para configurar el webhook de Get available cards para este componente, expande las instrucciones.
- Abre la consola de Dialogflow CX.
- Elige tu proyecto de Google Cloud.
- Selecciona el agente.
- Selecciona la pestaña Administrar.
- Haz clic en Webhooks.
- Selecciona el webhook prebuilt_components_credit_card_enrollment:get_available_card.
- Reemplaza la URL en el campo URL de webhook de Dialogflow CX por el extremo del servicio con el que deseas realizar la integración. Selecciona el Método adecuado en el menú desplegable.
- Revisa y actualiza el cuerpo de la solicitud para formar el formato de solicitud adecuado para tu webhook.
- Revisa y actualiza la configuración de respuesta para extraer campos específicos de la respuesta de tu webhook. No modifiques 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 Authentication según sea necesario.
- Haz clic en Guardar.
Obtén los detalles de la tarjeta seleccionada
El webhook prebuilt_components_credit_card_enrollment:get_selected_card se usa en el componente para recuperar las tarifas y los beneficios anuales de la tarjeta seleccionada.
Parámetros de la solicitud a la API
El componente proporciona los siguientes parámetros como entradas para la solicitud a la API.
| Nombre del parámetro | Descripción | Formato de entrada |
|---|---|---|
| $flow.card_type | Es el tipo de tarjeta que seleccionó el usuario para inscribirse. Los valores válidos se definen con la entidad personalizada prebuilt_components_cc_enroll_card_type. De forma predeterminada, se admiten classic, gold y platinum. |
cadena |
| $flow.expense_category | Es la categoría de gastos que seleccionó el usuario para inscribirse. Los valores válidos se definen con la entidad personalizada prebuilt_components_cc_enroll_expense_category. De forma predeterminada, se admiten fuel, shopping y travel. |
cadena |
| $flow.credit_score | Es la calificación crediticia del usuario, que el componente recupera con el webhook Get account details. | integer |
Parámetros de respuesta de la API
El componente usa los siguientes parámetros extraídos de la respuesta de la API.
| Nombre del parámetro | Descripción | Formato de salida |
|---|---|---|
| selected_card_benefits | Es la información sobre los beneficios de la tarjeta seleccionada. | cadena |
| selected_card_annual_fee | Es la comisión anual de la tarjeta seleccionada. | integer |
| selected_card_name | Es el nombre de la tarjeta seleccionada. | cadena |
Para configurar el webhook Get selected card details para este componente, expande las instrucciones.
- Abre la consola de Dialogflow CX.
- Elige tu proyecto de Google Cloud.
- Selecciona el agente.
- Selecciona la pestaña Administrar.
- Haz clic en Webhooks.
- Selecciona el webhook prebuilt_components_credit_card_enrollment:get_selected_card.
- Reemplaza la URL en el campo URL de webhook de Dialogflow CX por el extremo del servicio con el que deseas realizar la integración. Selecciona el Método adecuado en el menú desplegable.
- Revisa y actualiza el cuerpo de la solicitud para formar el formato de solicitud adecuado para tu webhook.
- Revisa y actualiza la configuración de respuesta para extraer campos específicos de la respuesta de tu webhook. No modifiques 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 Authentication según sea necesario.
- Haz clic en Guardar.
Enviar solicitud de inscripción
El webhook prebuilt_components_credit_card_enrollment:submit_enroll se usa para que el componente cree una solicitud de inscripción de tarjeta según las preferencias y los detalles del usuario nuevos.
Parámetros de la solicitud a la API
El componente proporciona los siguientes parámetros como entradas para la solicitud a 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 | Es el código postal que proporcionó el usuario. | cadena |
| $flow.monthly_salary | Es el salario mensual que proporciona el usuario. | integer |
| $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
El componente usa los siguientes parámetros extraídos de la respuesta de la API.
| Nombre del parámetro | Descripción | Formato de salida |
|---|---|---|
| request_number | Es el número de solicitud del registro exitoso de la solicitud de inscripción de la tarjeta. | integer |
Para configurar el webhook de Submit enrollment request para este componente, expande las instrucciones.
- Abre la consola de Dialogflow CX.
- Elige tu proyecto de Google Cloud.
- Selecciona el agente.
- Selecciona la pestaña Administrar.
- Haz clic en Webhooks.
- Selecciona el webhook prebuilt_components_credit_card_enrollment:submit_enroll.
- Reemplaza la URL en el campo URL de webhook de Dialogflow CX por el extremo del servicio con el que deseas realizar la integración. Selecciona el Método adecuado en el menú desplegable.
- Revisa y actualiza el cuerpo de la solicitud para formar el formato de solicitud adecuado para tu webhook.
- Revisa y actualiza la configuración de respuesta para extraer campos específicos de la respuesta de tu webhook. No modifiques 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 Authentication según sea necesario.
- Haz clic en Guardar.
Enviar mensaje
El webhook prebuilt_components_credit_card_enrollment:send_message se usa para que el componente envíe un mensaje que contenga un vínculo para completar la inscripción de la tarjeta de crédito de los clientes existentes.
Parámetros de la solicitud a la API
El componente proporciona los siguientes parámetros como entradas para la solicitud a 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 | Es el canal que seleccionó el usuario para recibir el mensaje. Los valores válidos se definen con 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
El componente usa los siguientes parámetros extraídos de la respuesta de la API.
| Nombre del parámetro | Descripción | Formato de salida |
|---|---|---|
| message_sent | Indica si el mensaje se envió correctamente al canal especificado por el usuario. | booleano |
Para configurar el webhook de Send message para este componente, expande las instrucciones.
- Abre la consola de Dialogflow CX.
- Elige tu proyecto de Google Cloud.
- Selecciona el agente.
- Selecciona la pestaña Administrar.
- Haz clic en Webhooks.
- Selecciona el webhook prebuilt_components_credit_card_enrollment:send_message.
- Reemplaza la URL en el campo URL de webhook de Dialogflow CX por el extremo del servicio con el que deseas realizar la integración. Selecciona el Método adecuado en el menú desplegable.
- Revisa y actualiza el cuerpo de la solicitud para formar el formato de solicitud adecuado para tu webhook.
- Revisa y actualiza la configuración de respuesta para extraer campos específicos de la respuesta de tu webhook. No modifiques 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 Authentication según sea necesario.
- Haz clic en Guardar.
Completado
Tu agente y sus webhooks ya deberían estar configurados y listos para la prueba.