El componente prediseñado de ofertas y promociones verifica si el llamador es un usuario registrado. Si el usuario tiene una cuenta registrada, el componente puede proporcionar información sobre ofertas y promociones específicas para el usuario. El usuario también puede obtener detalles sobre ofertas y promociones generales, o bien informar problemas con un código de cupón específico. Este componente usa el componente prediseñado Recopilación alfanumérica para recopilar códigos de cupones. El componente también usa Generadores para el resumen posterior a la llamada, las preguntas frecuentes y los 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 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 ejemplo demuestran el comportamiento cuando se llama al componente por telefonía, lo que activa el intent de bienvenida predeterminado y la primera respuesta del agente al comienzo de la conversación.
Ofertas y promociones generales y específicas para el usuario
El usuario final ya se autenticó. El usuario solicita sus ofertas más recientes y el agente le presenta una lista de ofertas específicas para él. El usuario hace algunas preguntas sobre las ofertas y, luego, pide ofertas en una categoría específica. El agente presenta la lista de ofertas en la categoría. El agente se ofrece a enviar los detalles de la oferta al usuario, pero este se niega.
| Entrada del usuario | Respuesta del agente |
|---|---|
| ¡Te damos la bienvenida! ¿Te gustaría explorar nuestras ofertas más recientes o tienes problemas con un código de cupón específico? | |
| Quiero ver las ofertas más recientes | |
| Para confirmar que estás buscando ofertas ¿Verdad? | |
| sí | |
| Encontramos las siguientes ofertas para ti. Aquí tienes los detalles: Oferta 1: Obtén un 5% de descuento en indumentaria. Usa el código APPARELS5. Válido hasta el 28/3/2024. Oferta 2: Obtén un 15% de descuento en comestibles. Usa el código GROCERY500. Válido hasta el 28/3/2024.8. Esperamos que estas ofertas te resulten interesantes. ¿Tienes alguna pregunta sobre ofertas o promociones que podamos responder? |
|
| ¿Hay un mínimo de compra para la oferta de supermercado? | |
| Sí, hay un valor mínimo de compra de USD 10 para obtener el 15% de descuento en comestibles. 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 pregunta sobre ofertas o promociones que podamos responder? |
|
| ¿Tienen ofertas de productos electrónicos? | |
| Así es. Estos son los detalles de la oferta: Oferta 1: Obtén un 5% de descuento en productos electrónicos con el código ELECTRIC5. Válida hasta el 28/03/2024. Oferta 2: Obtén un 15% de descuento en productos electrónicos con el código ELECTRIC15. Válida hasta el 28/03/2024. Esperamos poder proporcionarte los detalles que necesitas. ¿Tienes alguna pregunta sobre ofertas o promociones que podamos responder? |
|
| No, ya terminé | |
| ¿Quieres que se compartan los detalles de la oferta en tu correo electrónico o dispositivo móvil registrados? | |
| No, gracias | |
| Gracias por llamar. |
Problema con un código de cupón
El usuario final ya se autenticó. El usuario menciona que tiene un problema con un código de cupón. El agente recopila el código del cupón y le 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 un ticket para informar el problema.
| Entrada del usuario | Respuesta del agente |
|---|---|
| ¡Te damos la bienvenida! ¿Te gustaría explorar nuestras ofertas más recientes o tienes problemas con un código de cupón específico? | |
| Tengo problemas con un código de cupón | |
| Para confirmar, estás buscando códigos de cupones. ¿Verdad? | |
| sí | |
| Lamentamos saberlo. ¿Puedes compartir el código de cupón que usas? | |
| El agente recopila el código del cupón con el componente prediseñado Recopilación alfanumérica | |
| El código de oferta APPARELS5 asociado con prendas de vestir necesitaba un valor de compra mínimo de USD 100 y era válido hasta el 28/03/2024. Asegúrate de que se cumplan las condiciones, como el requisito de compra mínima. ¿Te resultó útil esta información? |
|
| no | |
| Especifica el problema que tienes. Puedes decir algo como que mi código de cupón no funciona o que el código no funciona en mi área. | |
| El código del cupón no funciona | |
| Para confirmar, el problema con el código de cupón proporcionado es que el código de cupón no funciona. ¿Esto es correcto? | |
| sí | |
| Generamos un ticket para informar tu problema. Gracias por llamar. |
Convenciones de nombres
Este componente prediseñado usa las siguientes convenciones de nomenclatura:
| Función | Formato | Ejemplo |
|---|---|---|
| Flujo | [Nombre del componente] | 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 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. 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.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 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 la cantidad de reintentos permitidos cuando se selecciona si el usuario desea escuchar ofertas o informar un problema con un código de cupón. El valor predeterminado es 2. |
integer |
| $flow.max_retry_offers_category | Especifica la cantidad de reintentos permitidos cuando se proporciona una categoría para escuchar ofertas. El valor predeterminado es 2. |
integer |
| $flow.max_retry_another_coupon_code | Especifica la cantidad de reintentos permitidos cuando se proporciona el código de cupón específico con el que el usuario tiene un problema. El valor predeterminado es 2. |
integer |
| $flow.max_retry_coupon_code_issue_counter | Especifica la cantidad de reintentos permitidos cuando se proporciona el problema que tiene el usuario con un código de cupón. El valor predeterminado es 2. |
integer |
| $flow.max_retry_message_confirm_channel | Especifica la cantidad de reintentos permitidos cuando se proporciona un canal para recibir detalles de la oferta. El valor predeterminado es 2. |
integer |
| $flow.valid_coupon_code_status | Especifica el valor del campo coupon_code_status que devuelve el webhook de get_coupon_code_details, lo 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 que muestra el webhook de get_coupon_code_details, lo 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 que devuelve el webhook de get_coupon_code_details, lo que indica que el código de cupón venció. El valor predeterminado es "expired". |
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 |
Generadores
Este componente usa Generadores para habilitar partes específicas de la conversación.
Resúmenes
El generador de Summarization se usa para generar un resumen posterior a la llamada que describe la conversación que manejó el componente.
Preguntas frecuentes generales
El generador de General FAQ se usa para responder preguntas frecuentes relacionadas con descuentos, ventas, compras y programas de lealtad.
- ¿Puedo devolver los productos en oferta si cambio de opinión?
- ¿Puedo obtener muestras o regalos gratis con la compra de ciertos productos?
- ¿Ofrecen ajustes de precios si el artículo que compré se pone en oferta más adelante?
- ¿Hay un límite de tiempo para canjear las recompensas del programa de lealtad?
Detalles de la oferta específicos para el usuario
El generador User-specific offer details se usa para proporcionar detalles sobre las ofertas específicas para el usuario en función de la información que proporciona 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 que proporciona el webhook de get_offers_details.
El usuario puede preguntar sobre ofertas en una categoría específica o pedir más detalles sobre ofertas específicas.
Preguntas frecuentes sobre ofertas y promociones
El generador de Offers and deals FAQ se usa para responder preguntas frecuentes relacionadas con ofertas y promociones.
- ¿Hay ofertas especiales para clientes nuevos?
- ¿Cómo puedo recibir notificaciones sobre las próximas ofertas?
- ¿Hay ofertas disponibles exclusivamente en la tienda o en línea?
- ¿Con qué frecuencia se agregan ofertas nuevas a la plataforma?
Preguntas frecuentes sobre descuentos y códigos promocionales
El Discount and promo code FAQ se usa para responder 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 solo pedido?
- ¿Cómo puedo canjear un código de descuento durante la confirmación de la compra?
- ¿Qué sucede si olvidé aplicar un código de descuento durante la confirmación de la compra?
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 webhooks.
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.
Obtén detalles de las ofertas
El webhook prebuilt_components_offers_and_deals:get_offers_details lo usa el componente para recuperar detalles sobre ofertas generales y específicas para el usuario.
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 para recuperar los detalles de la oferta. | 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 |
|---|---|---|
| active_category | Es la lista de categorías de ofertas disponibles para el usuario. Los valores válidos se definen con la entidad prebuilt_components_offers_and_deals_category. |
Lista (cadena) |
| user_email | Es el correo electrónico registrado en la cuenta proporcionada, que se usa para enviar los detalles de la oferta. | cadena |
| user_offer | Es una lista de detalles de la oferta específicos para el usuario. Cada elemento de la lista representa una sola oferta, con pares clave-valor que describen diferentes atributos de la oferta, por ejemplo, {"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"}. |
List (objeto) |
| all_offers | Es la 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. |
List (objeto) |
Para configurar el webhook Get offers 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_offers_and_deals:get_offers_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.
Obtén detalles del código de cupón
El webhook prebuilt_components_offers_and_deals:get_coupon_code_details lo usa el componente para recuperar detalles sobre un código de cupón específico con el que un usuario informó problemas.
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.coupon_code | Es el código del cupón del que se recuperarán 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
El componente usa los siguientes parámetros extraídos de la respuesta de la API.
| Nombre del parámetro | Descripción | Formato de salida |
|---|---|---|
| offer_id | Es el ID de la oferta del código del cupón. | cadena |
| offer_category_name | Es la categoría del código de cupón. Los valores válidos se definen con la entidad prebuilt_components_offers_and_deals_category. |
cadena |
| coupon_code_status | Es el estado del código del cupón. Los valores válidos se definen con los parámetros de entrada $flow.valid_coupon_code_status, $flow.invalid_coupon_code_status y $flow.valid_coupon_code_status. |
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 | Es el valor mínimo del pedido para el código de cupón. | cadena |
Para configurar el webhook de Get coupon code 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_offers_and_deals:get_coupon_code_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.
Enviar mensaje
El webhook prebuilt_components_offers_and_deals:send_message se usa para que el componente envíe un mensaje con detalles de la oferta al canal seleccionado por el usuario.
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.confirmation_channel | Canal que seleccionó el usuario para recibir detalles de la oferta. Los valores válidos se definen con la entidad prebuilt_components_channel_email_phone. |
cadena |
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_offers_and_deals: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.
Enviar ticket
El webhook prebuilt_components_offers_and_deals:raise_ticket se usa para que el componente envíe un ticket en el que se informe un problema del usuario con un código de cupón.
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.coupon_code | Es el código del cupón para el que el usuario informó un problema. | cadena |
| $flow.offer_id | Es el ID de la oferta para el código de cupón proporcionado. | cadena |
| $flow.coupon_code_issue | Es el problema que proporcionó el usuario para el código del cupón. | cadena |
Para configurar el webhook de Raise ticket 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 rebuilt_components_offers_and_deals:raise_ticket.
- 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.