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
- El componente verifica si el usuario llama con un número de teléfono registrado para identificar si es un usuario nuevo.
- 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.
- 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
- 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.
- 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.
- 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 Páginas.
- 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 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:
- Importa el componente compilado previamente (consulta Importa el componente compilado previamente).
- 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.
- 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 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.
- Revisa y actualiza la configuración de Autenticación según sea necesario.
- 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.
- 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 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.
- Revisa y actualiza la configuración de Autenticación según sea necesario.
- 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.
- 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 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.
- Revisa y actualiza la configuración de Autenticación según sea necesario.
- 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.
- 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 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.
- Revisa y actualiza la configuración de Autenticación según sea necesario.
- 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.
- 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 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.
- Revisa y actualiza la configuración de Autenticación según sea necesario.
- 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.
- 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 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.
- Revisa y actualiza la configuración de Autenticación según sea necesario.
- 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.