El componente compilado previamente de ofertas y acuerdos verifica si el emisor es un usuario registrado. Si el usuario tiene una cuenta registrada, el componente puede proporcionar información sobre ofertas específicas del usuario. El usuario también puede obtener detalles sobre ofertas y promociones generales, o informar problemas con un código de cupón específico. Este componente usa el componente compilado previamente Recopilación alfanumérica para recopilar códigos de cupones. 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 compilados previamente, este tiene las siguientes limitaciones:
- Este componente no encripta ningún dato.
Diálogos de muestra
En los siguientes diálogos de muestra, se muestran situaciones comunes controladas por este componente compilado previamente. Los diálogos de muestra demuestran el comportamiento cuando se llama al componente mediante telefonía, lo cual activa el intent de bienvenida predeterminado y la primera respuesta del agente al comienzo de la conversación.
Ofertas y acuerdos para usuarios generales y específicos
El usuario final se autenticó con anterioridad. El usuario solicita sus ofertas más recientes y el agente presenta una lista de ofertas específicas para el usuario. El usuario hace algunas preguntas sobre las ofertas y, luego, solicita las 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, y este la rechaza.
| Entrada del usuario | Respuesta del agente |
|---|---|
| ¡Te damos la bienvenida! ¿Te gustaría explorar nuestras ofertas más recientes o tienes algún problema con un código de cupón específico? | |
| Quiero ver las ofertas más recientes | |
| Para confirmar, estás buscando ofertas. ¿Verdad? | |
| sí | |
| Encontramos las siguientes ofertas para ti: Oferta 1: Obtén un 5% de descuento en indumentaria, usa el código APPARELS5, válido hasta el 28/03/2024. Oferta 2: Obtén un 15% de descuento en tiendas de comestibles. Usa el código GROCERY500, válido hasta el 2024/03/28.8. Espero que estas ofertas te resulten interesantes. ¿Tienes alguna consulta sobre ofertas o promociones que podamos responder? |
|
| ¿Hay un mínimo de compra para la oferta de supermercado? | |
| Sí, el valor mínimo de compra es de 10 para poder aprovechar el 15% de descuento en comestibles. Usa el código GROCERY500 para canjear esta oferta, válida hasta el 28/03/2024. Esperamos poder brindarte los detalles que necesitas. ¿Tienes alguna consulta sobre ofertas o promociones que podamos responder? |
|
| ¿Tiene alguna oferta de productos electrónicos? | |
| Por supuesto. Estos son los detalles de la oferta: Oferta 1: Disfruta de un 5% de descuento en electrónica, usa el código ELECTRIC5, válido hasta el 28/03/2024. Oferta 2: Obtén un 15% de descuento en artículos electrónicos y usa el código ELECTRIC15, válido hasta el 28/03/2024. Esperamos poder brindarte todos los detalles que necesites. ¿Tienes alguna consulta sobre ofertas o promociones que podamos responder? |
|
| No, eso es todo | |
| ¿Quieres que los detalles de la oferta se compartan en el dispositivo móvil o correo electrónico que registraste? | |
| No, gracias | |
| Gracias por llamarme. |
Problema con un código de cupón
El usuario final se autenticó con anterioridad. El usuario menciona que tiene un problema con el código del cupón. El agente recopila el código del cupón y le proporciona al usuario detalles sobre su canje. 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 algún problema con un código de cupón específico? | |
| Tengo problemas con un código de cupón | |
| Para confirmarlo, estás buscando códigos de cupones. ¿Verdad? | |
| sí | |
| Lamentamos saber eso. ¿Podrías compartir el código del cupón que usas? | |
| El agente recopila el código del cupón con el componente precompilado de colección alfanumérica. | |
| El código de oferta APPARELS5 asociado con indumentaria necesita un valor de compra mínimo de USD 100 y es 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. Puede que digas que el código de mi 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 que proporcionaste es que no funciona. ¿Es correcta esta información? | |
| sí | |
| Creamos un ticket para informar tu problema. Gracias por llamarme. |
Convenciones de nombres
Este componente compilado previamente usa las siguientes convenciones de nomenclatura:
| Atributo | 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 parámetros que se usan para configurar ciertos comportamientos del componente. Una o más condiciones dentro del flujo usarán los parámetros para determinar cómo debe comportarse el componente. Los parámetros centrados en el flujo deben establecerse en la página de inicio del componente. Los parámetros centrados en la sesión se pueden configurar mediante un flujo de llamada o en la página de inicio de este componente.
Este componente compilado previamente 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 | string |
Este componente precompilado permite que los siguientes parámetros opcionales configuren 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 quiere 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 problemas. 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 muestra el webhook get_coupon_code_details, lo que indica que el código del cupón es válido. El valor predeterminado es "valid". |
string |
| $flow.invalid_coupon_code_status | Especifica el valor del campo coupon_code_status que muestra el webhook get_coupon_code_details, lo que indica que el código del cupón no es válido. El valor predeterminado es "invalid". |
string |
| $flow.expired_coupon_code_status | Especifica el valor del campo coupon_code_status que muestra el webhook get_coupon_code_details, lo que indica que venció el código del cupón. El valor predeterminado es "expired". |
string |
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 de 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 permanecerán activos después de salir del componente. Estos parámetros contienen información importante que recopila el componente. Este componente compilado previamente 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. | string |
| transfer_reason | Este parámetro indica el motivo por el que se cerró el flujo, si no fue exitoso. El valor que se muestra 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 rechazó compartir la información solicitada por el componente.max_no_input: La conversación alcanzó la cantidad máxima de reintentos para eventos sin entrada. Consulta los eventos integrados sin entrada.max_no_match: La conversación alcanzó la cantidad máxima de reintentos para eventos sin coincidencias. Consulta los eventos integrados sin coincidencias.webhook_error: Se produjo un error de webhook. Consulta evento integrado de webhook.error. webhook_not_found: No se pudo acceder a una URL de webhook. Consulta webhook.error.not-found contenido integrado. |
string |
Generadores
Este componente usa generadores para habilitar partes específicas de la conversación.
Resumen
El generador de Summarization se usa para generar un resumen posterior a la llamada que describe la conversación que maneja el componente.
Preguntas frecuentes generales
El generador de General FAQ se usa para responder las preguntas frecuentes relacionadas con descuentos, ofertas, compras y programas de lealtad.
- ¿Puedo devolver productos en oferta si cambio de opinión?
- ¿Puedo obtener muestras gratis o regalos con la compra de ciertos productos?
- ¿Ofrecen ajustes de precio si el artículo que compré sale a la venta más tarde?
- ¿Hay un límite de tiempo para canjear las recompensas del programa de lealtad?
Detalles de la oferta específica para el usuario
El generador de User-specific offer details se usa para proporcionar detalles sobre ofertas específicas para el usuario según la información que proporciona el webhook de get_offers_details.
Ofertas y detalles de promociones
El generador de Offers and deals details se usa para proporcionar detalles sobre
ofertas y acuerdos generales según la información que proporciona el
webhook de get_offers_details.
El usuario puede preguntar sobre ofertas de una categoría específica o solicitar más detalles sobre ofertas específicas.
Preguntas frecuentes sobre ofertas y promociones
El generador de Offers and deals FAQ se usa para responder las preguntas frecuentes relacionadas con las ofertas y los acuerdos.
- ¿Hay ofertas especiales para clientes nuevos?
- ¿Cómo me notifican sobre las próximas ofertas?
- ¿Hay ofertas disponibles exclusivamente en la tienda o en línea?
- ¿Con qué frecuencia se agregan ofertas nuevas a tu plataforma?
Preguntas frecuentes sobre los códigos promocionales y de descuento
El Discount and promo code FAQ se usa para responder las 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 precompilado, haz lo siguiente:
- Importa el componente precompilado.
- Para configurar los webhooks flexibles proporcionados con la configuración que describe tus servicios externos de Dialogflow, consulta la configuración de webhook.
Configuración de webhooks
Si deseas usar este componente, deberás configurar los webhooks flexibles incluidos para recuperar la información necesaria de tus servicios externos.
Obtener detalles de las ofertas
El componente usa el webhook prebuilt_components_offers_and_deals:get_offers_details para recuperar detalles sobre ofertas específicas y generales del usuario.
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. | Número de teléfono para el que se deben recuperar los detalles de la oferta. | string |
Parámetros de respuesta de la API
Los siguientes parámetros se extraen de la respuesta de la API para que los utilice el componente.
| Nombre del parámetro | Descripción | Formato de salida |
|---|---|---|
| active_category | Es la lista de categorías de ofertas disponibles para el usuario. La entidad prebuilt_components_offers_and_deals_category define los valores válidos. |
Lista (cadena) |
| user_email | Correo electrónico registrado en la cuenta proporcionada, que se usa para enviar los detalles de la oferta. | string |
| user_offer | Lista de detalles de ofertas 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"}. |
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) |
Si quieres configurar el webhook para obtener detalles de las ofertas de este componente, expande la sección de 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 compilado_components_offers_and_deals:get_offers_details.
- Reemplaza la URL en el campo URL de webhook de Dialogflow con el extremo del servicio con el que deseas integrarte. Selecciona el Método adecuado en el menú desplegable.
- Revisa y actualiza el Cuerpo de la solicitud a fin de obtener 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 requiere para acceder a los valores de campo que se muestran.
- Revisa y actualiza la configuración de Authentication según sea necesario.
- Haz clic en Guardar.
Obtén detalles del código del cupón
El componente usa el webhook prebuilt_components_offers_and_deals:get_coupon_code_details para recuperar detalles sobre un código de cupón específico con el que un usuario informó problemas.
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.coupon_code. | Código del cupón para obtener los detalles. | string |
| $session.params.phone_number. | Es el número de teléfono asociado con la cuenta del usuario. | string |
Parámetros de respuesta de la API
Los siguientes parámetros se extraen de la respuesta de la API para que los utilice el componente.
| Nombre del parámetro | Descripción | Formato de salida |
|---|---|---|
| offer_id | Es el ID de oferta del código del cupón. | string |
| offer_category_name | La categoría del código del cupón. La entidad prebuilt_components_offers_and_deals_category define los valores válidos. |
string |
| 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. |
string |
| valid_until | Fecha hasta la que el código del cupón es válido, en formato YYYY-MM-DD. |
string |
| minimum_order_value | Es el valor mínimo de pedido del código del cupón. | string |
Si deseas configurar el webhook para obtener detalles del código del cupón 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 Administrar.
- Haz clic en Webhooks.
- Selecciona el webhook compilado_components_offers_and_deals:get_coupon_code_details.
- Reemplaza la URL en el campo URL de webhook de Dialogflow con el extremo del servicio con el que deseas integrarte. Selecciona el Método adecuado en el menú desplegable.
- Revisa y actualiza el Cuerpo de la solicitud a fin de obtener 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 requiere para acceder a los valores de campo que se muestran.
- Revisa y actualiza la configuración de Authentication según sea necesario.
- Haz clic en Guardar.
Enviar mensaje
El componente usa el webhook prebuilt_components_offers_and_deals:send_message para enviar un mensaje que contenga detalles de la oferta al canal seleccionado del usuario.
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. | string |
| $flow.confirmación_channel | Es el canal que seleccionó el usuario para recibir los detalles de la oferta. La entidad prebuilt_components_channel_email_phone define los valores válidos. |
string |
Si deseas configurar el webhook de envío de mensajes para este componente, expande la sección de 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 compilado_components_offers_and_deals:send_message.
- Reemplaza la URL en el campo URL de webhook de Dialogflow con el extremo del servicio con el que deseas integrarte. Selecciona el Método adecuado en el menú desplegable.
- Revisa y actualiza el Cuerpo de la solicitud a fin de obtener 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 requiere para acceder a los valores de campo que se muestran.
- Revisa y actualiza la configuración de Authentication según sea necesario.
- Haz clic en Guardar.
Aumentar ticket
El componente usa el webhook prebuilt_components_offers_and_deals:raise_ticket para enviar un ticket en el que se informa un problema del 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 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. | string |
| $flow.coupon_code. | Es el código de cupón con el que el usuario informó un problema. | string |
| $flow.offer_id | Es el ID de oferta del código del cupón proporcionado. | string |
| $flow.coupon_code_issue | Problema proporcionado por el usuario para el código del cupón. | string |
Si deseas configurar el webhook de generación de tickets para este componente, expande la sección de 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:rise_ticket.
- Reemplaza la URL en el campo URL de webhook de Dialogflow con el extremo del servicio con el que deseas integrarte. Selecciona el Método adecuado en el menú desplegable.
- Revisa y actualiza el Cuerpo de la solicitud a fin de obtener 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 requiere para acceder a los valores de campo que se muestran.
- Revisa y actualiza la configuración de Authentication según sea necesario.
- Haz clic en Guardar.
Completada
Tu agente y sus webhooks ya deberían estar configurados y listos para las pruebas.