El componente precompilado de ofertas y descuentos comprueba si la persona que llama es un usuario registrado. Si el usuario tiene una cuenta registrada, el componente puede proporcionar información sobre ofertas y descuentos específicos para el usuario. El usuario también puede obtener información sobre ofertas y promociones generales o informar de problemas con un código de cupón específico. Este componente usa el componente precompilado Colección alfanumérica para recoger códigos de cupón. El componente también usa Generadores para resúmenes posteriores a la llamada, preguntas frecuentes y detalles de la oferta.
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 mediante telefonía, lo que activa la intención de bienvenida predeterminada y la primera respuesta del agente al inicio de la conversación.
Ofertas y promociones generales y específicas para usuarios
El usuario final ya se ha autenticado. El usuario pregunta por sus últimas ofertas y el agente le presenta una lista de ofertas específicas para él. El usuario hace algunas preguntas sobre las ofertas y, después, pide ofertas de una categoría específica. El agente presenta la lista de ofertas de la categoría. El agente ofrece enviar los detalles de la oferta al usuario, pero este los rechaza.
| Entrada del usuario | Respuesta del agente |
|---|---|
| ¡Te damos la bienvenida! ¿Quieres consultar nuestras últimas ofertas o tienes algún problema con un código de cupón concreto? | |
| Quiero ver las últimas ofertas | |
| Para confirmar que buscas ofertas. ¿Es correcto? | |
| yes | |
| Hemos encontrado las siguientes ofertas para ti. Aquí tienes los detalles: Oferta 1: consigue un 5% de descuento en ropa. Usa el código APPARELS5, válido hasta el 28-03-2024. Oferta 2: consigue un 15% de descuento en comestibles. Usa el código GROCERY500, válido hasta el 28-03-2024. Esperamos que estas ofertas te interesen. ¿Tienes alguna duda sobre ofertas o promociones que podamos resolver? |
|
| ¿Hay un importe mínimo de compra para la oferta de supermercado? | |
| Sí, hay un valor de compra mínimo de 10 € para disfrutar del 15% de descuento en la compra. Usa el código GROCERY500 para canjear esta oferta, válida hasta el 28-03-2024. Esperamos poder proporcionarte los detalles que necesitas. ¿Tienes alguna duda sobre ofertas o promociones que podamos resolver? |
|
| ¿Tenéis alguna oferta de electrónica? | |
| ¡Claro! Estos son los detalles de las ofertas: Oferta 1: disfruta de un 5% de descuento en electrónica. Usa el código ELECTRIC5. Oferta válida hasta el 28-03-2024. Oferta 2: consigue un 15% de descuento en electrónica. Usa el código ELECTRIC15. Oferta válida hasta el 28-03-2024. Esperamos haberte proporcionado la información que necesitabas. ¿Tienes alguna duda sobre ofertas o promociones que podamos resolver? |
|
| No, he terminado | |
| ¿Quieres que los detalles de la oferta se compartan en tu móvil o correo electrónico registrados? | |
| No, gracias | |
| Gracias por llamar. |
Problema con un código de cupón
El usuario final ya se ha autenticado. El usuario menciona que tiene un problema con un código de cupón. El agente recoge el código del cupón y proporciona al usuario detalles sobre el canje del código del cupón. El usuario confirma que tiene un problema con el código del cupón y el agente envía una incidencia para informar del problema.
| Entrada del usuario | Respuesta del agente |
|---|---|
| ¡Te damos la bienvenida! ¿Quieres consultar nuestras últimas ofertas o tienes algún problema con un código de cupón concreto? | |
| Tengo problemas con un código de cupón | |
| Para confirmar que estás buscando códigos de cupón. ¿Es correcto? | |
| yes | |
| Sentimos que estés teniendo problemas. ¿Podrías compartir el código de cupón que estás usando? | |
| El agente recoge el código de cupón mediante el componente prediseñado Recogida alfanumérica. | |
| El código de oferta APPARELS5 asociado a prendas de vestir necesitaba un valor de compra mínimo de 100 USD y era válido hasta el 28-03-2024. Asegúrate de que se cumplen las condiciones, como el requisito de compra mínima. ¿Te resulta útil esta información? |
|
| no | |
| Especifica el problema que estás teniendo. Por ejemplo, puedes decir que tu código de cupón no funciona o que no funciona en tu zona. | |
| El código de cupón no funciona | |
| Para confirmar, el problema con el código de cupón que ha indicado es que no funciona. ¿Es correcto? | |
| yes | |
| Hemos registrado una incidencia para informar de tu problema. Gracias por llamar. |
Convenciones de nombres
Este componente prediseñado usa las siguientes convenciones de nomenclatura:
| Función | Formato | Ejemplo |
|---|---|---|
| Flujo | [Component Name] | Ofertas y promociones |
| Tipo de entidad | prebuilt_components_[component_name]_[entity_type] | prebuilt_components_offers_and_deals_category |
| Webhook | prebuilt_components_[component_name]:[webhook_action] | prebuilt_components_offers_and_deals:get_offers_details |
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 definidos en el flujo deben establecerse en la página de inicio del componente. 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.phone_number | (Opcional) Número de teléfono local del usuario, sin el código de país, que se usa para identificar al usuario. | cadena |
Este componente prediseñado permite usar los siguientes parámetros opcionales para configurar el comportamiento del componente, incluidos los reintentos.
| Nombre del parámetro | Descripción | Formato |
|---|---|---|
| $flow.max_retry_concern_type | Especifica el número de reintentos permitidos al seleccionar si el usuario quiere escuchar ofertas o informar de un problema con un código de cupón. El valor predeterminado es 2. |
entero |
| $flow.max_retry_offers_category | Especifica el número de reintentos permitidos al proporcionar una categoría para escuchar ofertas. El valor predeterminado es 2. |
entero |
| $flow.max_retry_another_coupon_code | Especifica el número de reintentos permitidos al proporcionar el código de cupón específico con el que el usuario tiene un problema. El valor predeterminado es 2. |
entero |
| $flow.max_retry_coupon_code_issue_counter | Especifica el número de reintentos permitidos al proporcionar el problema que tiene el usuario con un código de cupón. El valor predeterminado es 2. |
entero |
| $flow.max_retry_message_confirm_channel | Especifica el número de reintentos permitidos al proporcionar un canal para recibir los detalles de la oferta. El valor predeterminado es 2. |
entero |
| $flow.valid_coupon_code_status | Especifica el valor del campo coupon_code_status devuelto por el get_coupon_code_details webhook que indica que el código de cupón es válido. El valor predeterminado es "valid". |
cadena |
| $flow.invalid_coupon_code_status | Especifica el valor del campo coupon_code_status devuelto por el get_coupon_code_details webhook que indica que el código de cupón no es válido. El valor predeterminado es "invalid". |
cadena |
| $flow.expired_coupon_code_status | Especifica el valor del campo coupon_code_status devuelto por el get_coupon_code_details webhook que indica que el código de cupón ha caducado. El valor predeterminado es "expired". |
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 |
Generadores
Este componente usa Generators para habilitar partes específicas de la conversación.
Creación de resúmenes
El generador Summarization se usa para generar un resumen posterior a la llamada que describa la conversación gestionada por el componente.
Preguntas frecuentes generales
El generador de General FAQ se usa para responder a preguntas frecuentes relacionadas con descuentos, ventas, compras y programas de fidelización.
- ¿Puedo devolver productos rebajados si cambio de opinión?
- ¿Puedo recibir muestras o regalos gratuitos al comprar determinados productos?
- ¿Ofrecéis ajustes de precio si el artículo que he comprado se pone en oferta más adelante?
- ¿Hay un límite de tiempo para canjear las recompensas del programa de fidelización?
Detalles de la oferta específicos del usuario
El generador User-specific offer details se usa para proporcionar detalles sobre ofertas específicas para usuarios en función de la información proporcionada por el get_offers_details
webhook.
Detalles de ofertas y promociones
El generador de Offers and deals details se usa para proporcionar detalles sobre ofertas y promociones generales en función de la información proporcionada por el get_offers_details
webhook.
El usuario puede preguntar sobre ofertas de una categoría específica o pedir más detalles sobre ofertas concretas.
Preguntas frecuentes sobre ofertas y promociones
El generador de Offers and deals FAQ se usa para responder a preguntas frecuentes
relacionadas con ofertas y descuentos.
- ¿Hay ofertas especiales para nuevos clientes?
- ¿Cómo puedo recibir notificaciones sobre las próximas ofertas?
- ¿Hay ofertas disponibles exclusivamente en tienda física o en Internet?
- ¿Con qué frecuencia se añaden nuevas ofertas a tu plataforma?
Preguntas frecuentes sobre descuentos y códigos promocionales
El Discount and promo code FAQ se usa para responder a preguntas frecuentes relacionadas con descuentos y códigos promocionales.
- ¿Puedo usar un código de descuento más de una vez?
- ¿Puedo usar varios descuentos en un mismo pedido?
- ¿Cómo puedo canjear un código de descuento durante la tramitación de la compra?
- ¿Qué ocurre si se me olvida aplicar un código de descuento durante la tramitación de la compra?
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 sobre la configuración de webhooks.
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 detalles de las ofertas
El webhook prebuilt_components_offers_and_deals:get_offers_details se usa por el componente para obtener detalles sobre ofertas generales y específicas de usuarios.
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 del que se van a obtener los detalles de la oferta. | 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 |
|---|---|---|
| active_category | Lista de categorías de ofertas disponibles para el usuario. Los valores válidos se definen en la entidad prebuilt_components_offers_and_deals_category. |
Lista (cadena) |
| user_email | Correo registrado en la cuenta proporcionada, que se usa para enviar los detalles de la oferta. | cadena |
| user_offer | Lista de detalles de la oferta específicos de cada usuario. Cada elemento de la lista representa una sola oferta, con pares clave-valor que describen diferentes atributos de la oferta, como {"valid_from": "2024-01-29", "sale_type": "none", "valid_until": "2024-03-28", "offer_id": "G5E0M2D7A6Y4W9S", "discount_value": "5%", "coupon_code": "ELECTRIC5", "is_redeem_allowed": "true", "minimum_order_value": "1000", "maximum_discount_amount": "200", "offer_category_name": "electronics"}. |
Lista (objeto) |
| all_offers | Lista de detalles generales de la oferta. Cada elemento de la lista representa una sola oferta y sigue el mismo formato que el campo user_offer. |
Lista (objeto) |
Para configurar el webhook Get offers 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_offers_and_deals:get_offers_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 los detalles de un código de cupón
El webhook prebuilt_components_offers_and_deals:get_coupon_code_details lo usa el componente para obtener detalles sobre un código de cupón específico con el que un usuario ha tenido problemas.
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.coupon_code | Código de cupón del que se quieren obtener los detalles. | cadena |
| $session.params.phone_number | Número de teléfono asociado a la cuenta del usuario. | cadena |
Parámetros de respuesta de la API
Los siguientes parámetros se extraen de la respuesta de la API para que los use el componente.
| Nombre del parámetro | Descripción | Formato de salida |
|---|---|---|
| offer_id | ID de oferta del código de cupón. | cadena |
| offer_category_name | Categoría del código de cupón. Los valores válidos se definen en la entidad prebuilt_components_offers_and_deals_category. |
cadena |
| coupon_code_status | Estado del código de cupón. Los valores válidos se definen mediante los $flow.valid_coupon_code_status, $flow.invalid_coupon_code_status y $flow.valid_coupon_code_status parámetros de entrada. |
cadena |
| valid_until | Fecha hasta la que es válido el código de cupón, en formato YYYY-MM-DD. |
cadena |
| minimum_order_value | Valor de pedido mínimo del código de cupón. | cadena |
Para configurar el webhook Get coupon code 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_offers_and_deals:get_coupon_code_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.
Enviar mensaje
El webhook prebuilt_components_offers_and_deals:send_message se usa
para que el componente envíe un mensaje con los detalles de la oferta al canal seleccionado por el usuario.
Parámetros de solicitud a la API
El componente proporciona los siguientes parámetros como entradas para la solicitud de la API.
| Nombre del parámetro | Descripción | Formato de entrada |
|---|---|---|
| $session.params.phone_number | Número de teléfono local del usuario, sin el código de país, que se usa para identificar al usuario. | cadena |
| $flow.confirmation_channel | Canal que ha seleccionado el usuario para recibir los detalles de la oferta. Los valores válidos se definen en la entidad prebuilt_components_channel_email_phone. |
cadena |
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_offers_and_deals: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.
Abrir incidencia
El webhook prebuilt_components_offers_and_deals:raise_ticket se usa
para que el componente envíe una incidencia que informa de un problema de un usuario con un código de cupón.
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.coupon_code | Código de cupón por el que el usuario ha informado de un problema. | cadena |
| $flow.offer_id | ID de oferta del código de cupón proporcionado. | cadena |
| $flow.coupon_code_issue | Problema que ha indicado el usuario con el código del cupón. | cadena |
Para configurar el webhook de creación de incidencia 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 rebuilt_components_offers_and_deals:raise_ticket.
- 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.