Componente precompilado de inscripción de la tarjeta de crédito

El componente compilado previamente 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 para identificar si es un cliente nuevo o existente. Para un usuario nuevo, el componente recopila los detalles obligatorios, como sus ingresos mensuales y la categoría de gastos o beneficios de la tarjeta de crédito que desea. Después de recopilar toda la información necesaria, el componente organiza una devolución de llamada y proporciona el número de solicitud al usuario.

Para un cliente existente, el componente recupera la información del usuario registrado y presenta las opciones de tarjetas de crédito disponibles para el usuario según sus preferencias y la información recuperada, incluida su calificación crediticia. Después de que el cliente selecciona una opción de tarjeta de crédito, el componente envía un vínculo para completar el procedimiento de inscripción con los canales registrados, incluidos WhatsApp o SMS.

Este componente usa los componentes Recopilación de números de teléfono y Recopilación de códigos postales para recopilar y validar los detalles del usuario.

Limitaciones

Además de las limitaciones comunes de los componentes compilados previamente, este componente compilado previamente incluye las siguientes limitaciones:

  • Este componente no encripta ningún dato.

Diálogos de muestra

En los diálogos de muestra, se indican situaciones comunes que controla este componente precompilado. Demuestran el comportamiento cuando el usuario llama al componente con la telefonía, lo que activa el intent de bienvenida predeterminado y la primera respuesta del agente al comienzo de la conversación.

Usuario nuevo

  1. El componente verifica si el usuario llama con un número de teléfono registrado para identificar si es un usuario nuevo.
  2. El componente recopila la categoría de tarjeta de crédito para la que el usuario desea inscribirse y recopila información para identificarlo, incluidos el código postal y el número de teléfono.
  3. El componente organiza una devolución de llamada y proporciona el número de solicitud.
Entrada del usuario Respuesta del agente
¿Puedes confirmar si ya eres cliente de nuestro banco?
No lo soy
Nos alegra que quieras solicitar una tarjeta de crédito con nosotros. Tenemos una amplia gama de tarjetas de crédito que son adecuadas para ti.

Para proporcionarte las mejores tarjetas de crédito 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 que seleccionaste 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 precompilado Recopilación de códigos postales.
Mencionaste que el código postal es 10011, ¿es correcto?
Sí, es correcto.
Genial, ya terminamos de recopilar el código postal.
El agente recopila el número de teléfono del usuario con el componente precompilado Recopilación de números de teléfono.
Entendido. El número que mencionaste es +16502530000, ¿es correcto?
Sí
Excelente, ya recopilamos 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 existente

  1. El componente identifica a un cliente registrado con su número de teléfono y, luego, solicita información, como la categoría y el tipo de tarjeta para la que el usuario desea inscribirse.
  2. Una vez que el usuario confirma esta información, el componente le solicita que seleccione un canal para completar el proceso de inscripción y envía el vínculo al canal registrado.
Entrada del usuario Respuesta del agente
Nos alegra 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í
Hay 3 tipos de tarjetas que se adaptan a tu tipo de solicitud: tarjeta de viaje platino, tarjeta de viaje dorada y tarjeta de viaje clásica. ¿Quieres obtener información sobre todas las tarjetas o sobre una en particular? Por ejemplo, si buscas específicamente una tarjeta clásica, di "tarjeta clásica".
¿Puedes darme información sobre la tarjeta Platinum?
Claro, para una tarjeta de viajes Platinum, la tarifa anual es de USD 95. Los beneficios incluyen: obtén 10,000 millas de bonificación cada año, gana 2 veces más millas ilimitadas en todas las demás compras, las millas son fáciles de ganar y de usar. Puedes encontrar más información sobre los beneficios o las bonificaciones en nuestro sitio web.

Confirma si quieres inscribirte para obtener la tarjeta de viajes Platinum.
Sí, hagámoslo
Compartiremos un vínculo con los pasos del procedimiento de inscripción. ¿Quieres que compartamos estos detalles de la 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. ¿Podrías confirmar si recibiste el vínculo diciendo sí o no?
¡Lo tengo!
Genial, ahora puedes abrir el vínculo y consultar 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

Cuando el usuario se niega a proporcionar la información necesaria para inscribirse en una tarjeta de crédito, el componente sale con un mensaje de error.

Entrada del usuario Respuesta del agente
¿Puedes confirmar si ya eres cliente de nuestro banco?
No, no lo soy
Nos alegra que quieras solicitar una tarjeta de crédito con nosotros. Tenemos una amplia gama de tarjetas de crédito que son adecuadas para ti.

Para proporcionarte las mejores tarjetas de crédito disponibles, ¿podrías indicar tus ingresos mensuales en USD?
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 precompilado usa las siguientes convenciones de nombres:

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 configuran ciertos comportamientos del componente. Una o más condiciones dentro del flujo usan estos parámetros para determinar cómo se comporta el componente. Debes establecer parámetros con alcance de flujo en la página de inicio del componente. Puedes establecer parámetros centrados en la sesión usando un flujo de llamadas o en la página de inicio de este componente.

Este componente precompilado toma 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. integer
$session.params.phone_number (opcional) El número de teléfono del usuario. Si no se proporciona este parámetro, el componente recopila el número de teléfono del usuario. cadena
$flow.max_retry_count Especifica la cantidad de reintentos que se le otorgan al usuario. El valor predeterminado es 3. integer
$flow.currency_name Especifica la moneda que se espera 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.

  1. Abre la consola de Dialogflow CX.
  2. Elige tu proyecto de Google Cloud.
  3. Selecciona el agente.
  4. Selecciona la pestaña Build.
  5. Haz clic en el componente importado en la sección Flujos.
  6. Haz clic en la página de inicio en la sección Páginas.
  7. Haz clic en la ruta true en la página de inicio.
  8. En la ventana Route, edita los valores de Parameter Presets según sea necesario.
  9. Haz clic en Guardar.

Los parámetros de resultado

Los parámetros de salida son parámetros de sesión que permanecen activos después de salir del componente. Estos parámetros contienen información importante que recopila el componente.

Este componente precompilado proporciona valores para los siguientes parámetros de salida:

Nombre del parámetro Descripción Formato de salida
phone_number Es el número de teléfono local del usuario, sin el código de país, que se usa para identificarlo. cadena
transfer_reason Este parámetro indica el motivo por el que se cerró el flujo, si no se completó correctamente. El valor que se devuelve es uno de los siguientes:

agent: El usuario solicitó un agente humano en algún momento de la conversación.

denial_of_information: El usuario rechazó compartir la información que solicitó el componente.

max_no_input: La conversación alcanzó la cantidad máxima de reintentos para eventos sin entrada. Consulta eventos integrados sin entrada.

max_no_match: La conversación alcanzó la cantidad máxima de reintentos para eventos sin coincidencia. Consulta los eventos integrados de no 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 compilado previamente, haz lo siguiente:

  1. Importa el componente compilado previamente (consulta Importa el componente compilado previamente).
  2. Configura los webhooks flexibles proporcionados para describir tus servicios externos. Para obtener más información, consulta la sección Configuración de webhook.

Configuración del webhook

Para usar este componente, configura los webhooks flexibles incluidos para recuperar la información necesaria de tus servicios externos.

Obtener detalles de la cuenta

El componente usa el webhook prebuilt_components_credit_card_enrollment:get_account_details para recuperar los detalles de la cuenta del usuario, si existe una cuenta.

Parámetros de 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 Es el número de teléfono local del usuario, sin el código de país, que se usa para identificarlo. cadena

Parámetros de respuesta de la API

El componente recupera los siguientes parámetros de la respuesta de la API:

Nombre del parámetro Descripción Formato de salida
account_count Es la cantidad de cuentas asociadas con el número de teléfono registrado. integer
credit_score Es la calificación crediticia registrada del usuario. integer

Para configurar el webhook Obtener detalles de la cuenta para este componente, expande las instrucciones.

  1. Abre la consola de Dialogflow CX.
  2. Elige tu proyecto de Google Cloud.
  3. Selecciona el agente.
  4. Selecciona la pestaña Administrar.
  5. Haz clic en Webhooks.
  6. Selecciona el webhook prebuilt_components_credit_card_enrollment:get_account_details.
  7. 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.
  8. Revisa y actualiza el cuerpo de la solicitud para formar el formato de solicitud adecuado para tu webhook.
  9. Revisa y actualiza la Configuración de la 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 requiere para acceder a los valores de campo que se devuelven.
  10. Revisa y actualiza la configuración de Autenticación según sea necesario.
  11. Haz clic en Guardar.

Obtener el recuento de tarjetas

El componente usa el webhook prebuilt_components_credit_card_enrollment:get_card_count para recuperar la cantidad de tarjetas de crédito asociadas con la cuenta de usuario registrado.

Parámetros de 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 Es el número de teléfono local del usuario, sin el código de país, que se usa para identificarlo. cadena

Parámetros de respuesta de la API

El componente recupera los siguientes parámetros 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 Obtener recuento de tarjetas de crédito para este componente, expande las instrucciones.

  1. Abre la consola de Dialogflow CX.
  2. Elige tu proyecto de Google Cloud.
  3. Selecciona el agente.
  4. Selecciona la pestaña Administrar.
  5. Haz clic en Webhooks.
  6. Selecciona el webhook prebuilt_components_credit_card_enrollment:get_card_count.
  7. 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.
  8. Revisa y actualiza el cuerpo de la solicitud para formar el formato de solicitud adecuado para tu webhook.
  9. Revisa y actualiza la Configuración de la 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 requiere para acceder a los valores de campo que se devuelven.
  10. Revisa y actualiza la configuración de Autenticación según sea necesario.
  11. Haz clic en Guardar.

Obtén tarjetas de crédito disponibles

El componente usa el webhook prebuilt_components_credit_card_enrollment:get_available_card para recuperar la lista de tarjetas de crédito disponibles para el usuario para una categoría de gastos específica según su calificación crediticia.

Parámetros de 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 en la que el usuario se inscribió. 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 La calificación crediticia del usuario, que el componente recupera con el webhook Obtener detalles de la cuenta. integer

Parámetros de respuesta de la API

El componente recupera los siguientes parámetros de la respuesta de la API:

Nombre del parámetro Descripción Formato de salida
available_card_names Es una lista de tarjetas de crédito disponibles para el usuario, por ejemplo, ["gold shopping card","classic shopping card"]. Lista (cadena)
cards_count Es la cantidad de tarjetas de crédito disponibles para el usuario. integer

Para configurar el webhook Obtener tarjetas disponibles para este componente, expande las instrucciones.

  1. Abre la consola de Dialogflow CX.
  2. Elige tu proyecto de Google Cloud.
  3. Selecciona el agente.
  4. Selecciona la pestaña Administrar.
  5. Haz clic en Webhooks.
  6. Selecciona el webhook prebuilt_components_credit_card_enrollment:get_available_card.
  7. 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.
  8. Revisa y actualiza el cuerpo de la solicitud para formar el formato de solicitud adecuado para tu webhook.
  9. Revisa y actualiza la Configuración de la 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 requiere para acceder a los valores de campo que se devuelven.
  10. Revisa y actualiza la configuración de Autenticación según sea necesario.
  11. Haz clic en Guardar.

Obtén los detalles de la tarjeta de crédito seleccionada

El componente usa el webhook prebuilt_components_credit_card_enrollment:get_selected_card para recuperar las tarifas y los beneficios anuales de la tarjeta de crédito seleccionada.

Parámetros de 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 de crédito que el usuario seleccionó 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 en la que el usuario se inscribió. 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 La calificación crediticia del usuario, que el componente recupera con el webhook Obtener detalles de la cuenta. integer

Parámetros de respuesta de la API

El componente recupera los siguientes parámetros de la respuesta de la API:

Nombre del parámetro Descripción Formato de salida
selected_card_benefits Información sobre los beneficios de la tarjeta de crédito seleccionada. cadena
selected_card_annual_fee La tarifa anual de la tarjeta de crédito seleccionada. integer
selected_card_name Es el nombre de la tarjeta de crédito seleccionada. cadena

Para configurar el webhook Obtener detalles de la tarjeta de crédito seleccionada para este componente, expande las instrucciones.

  1. Abre la consola de Dialogflow CX.
  2. Elige tu proyecto de Google Cloud.
  3. Selecciona el agente.
  4. Selecciona la pestaña Administrar.
  5. Haz clic en Webhooks.
  6. Selecciona el webhook prebuilt_components_credit_card_enrollment:get_selected_card.
  7. 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.
  8. Revisa y actualiza el cuerpo de la solicitud para formar el formato de solicitud adecuado para tu webhook.
  9. Revisa y actualiza la Configuración de la 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 requiere para acceder a los valores de campo que se devuelven.
  10. Revisa y actualiza la configuración de Autenticación según sea necesario.
  11. Haz clic en Guardar.

Envía la solicitud de inscripción

El componente usa el webhook prebuilt_components_credit_card_enrollment:submit_enroll para crear una solicitud de inscripción de tarjeta de crédito según 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 a la API:

Nombre del parámetro Descripción Formato de entrada
$session.params.phone_number Es el número de teléfono local del usuario, sin el código de país, que se usa para identificarlo. cadena
$flow.zipcode Es el código postal que proporcionó el usuario. cadena
$flow.monthly_salary El salario mensual proporcionado por el usuario. integer
$flow.currency_name Es la moneda del salario mensual, configurada en los parámetros de entrada del componente. Consulta Parámetros de entrada. cadena

Parámetros de respuesta de la API

El componente recupera los siguientes parámetros de la respuesta de la API:

Nombre del parámetro Descripción Formato de salida
request_number Es el número de solicitud para el registro correcto de la solicitud de inscripción de la tarjeta de crédito. integer

Para configurar el webhook de envío de solicitud de inscripción para este componente, expande las instrucciones.

  1. Abre la consola de Dialogflow CX.
  2. Elige tu proyecto de Google Cloud.
  3. Selecciona el agente.
  4. Selecciona la pestaña Administrar.
  5. Haz clic en Webhooks.
  6. Selecciona el webhook prebuilt_components_credit_card_enrollment:submit_enroll.
  7. 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.
  8. Revisa y actualiza el cuerpo de la solicitud para formar el formato de solicitud adecuado para tu webhook.
  9. Revisa y actualiza la Configuración de la 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 requiere para acceder a los valores de campo que se devuelven.
  10. Revisa y actualiza la configuración de Autenticación según sea necesario.
  11. Haz clic en Guardar.

Enviar mensaje

El componente usa el webhook prebuilt_components_credit_card_enrollment:send_message para enviar un mensaje que contiene un vínculo para completar la inscripción de la tarjeta de crédito de los clientes existentes.

Parámetros de 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 Es el número de teléfono local del usuario, sin el código de país, que se usa para identificarlo. cadena
$flow.channel Es el canal que el usuario seleccionó 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 Es una lista de tarjetas de crédito seleccionadas por el usuario, por ejemplo, ["gold shopping card","classic shopping card"]. Lista (cadena)

Parámetros de respuesta de la API

El componente recupera los siguientes parámetros 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 envío de mensajes para este componente, expande las instrucciones.

  1. Abre la consola de Dialogflow CX.
  2. Elige tu proyecto de Google Cloud.
  3. Selecciona el agente.
  4. Selecciona la pestaña Administrar.
  5. Haz clic en Webhooks.
  6. Selecciona el webhook prebuilt_components_credit_card_enrollment:send_message.
  7. 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.
  8. Revisa y actualiza el cuerpo de la solicitud para formar el formato de solicitud adecuado para tu webhook.
  9. Revisa y actualiza la Configuración de la 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 requiere para acceder a los valores de campo que se devuelven.
  10. Revisa y actualiza la configuración de Autenticación según sea necesario.
  11. Haz clic en Guardar.

Completado

El componente precompilado de inscripción de tarjetas de crédito y sus webhooks ya están configurados y listos para probarse.