Las ofertas componente compilado previamente verifica si el emisor es un usuario registrado. Si el usuario tiene un registro el componente puede brindar información sobre ofertas específicas del usuario y acuerdos. El usuario también puede obtener detalles sobre ofertas y promociones generales o informes problemas con un código de cupón específico. Este componente utiliza el Recopilación alfanumérica creado previamente para recopilar códigos de cupón. El componente también usa Generadores para las llamadas posteriores a la llamada resumen, preguntas frecuentes y detalles de la oferta.
Limitaciones
Además del artículo limitaciones comunes de los componentes compilados previamente, este componente compilado previamente 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 que controla este un componente precompilado. Los diálogos de muestra demuestran el comportamiento cuando el componente se llamada mediante telefonía, lo que activa el intent de bienvenida predeterminado y el primer respuesta de agente al comienzo de la conversación.
Ofertas y promociones generales y específicas para el usuario
El usuario final ya se autenticó anteriormente. El usuario solicita sus ofertas más recientes. y presenta una lista de ofertas específicas para el usuario. El usuario hace algunas preguntas preguntas sobre las ofertas y, luego, solicita las de una categoría específica. El El agente presenta la lista de ofertas en 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 | |
| Me gustaría confirmar que estás buscando ofertas. ¿Verdad? | |
| sí | |
| Encontramos las siguientes ofertas para ti.Estos son los detalles: Oferta 1: Obtén un 5% de descuento en indumentaria, usa el código APPARELS5, válida hasta el 28/03/2024. Oferta 2: Obtén un 15% de descuento en comestibles con el código GROCERY500, válido hasta el 28/03/2024. Esperamos que estas ofertas te resulten interesantes. ¿Tienes alguna consulta sobre ofertas o promociones que podamos responder? |
|
| ¿Hay una compra mínima para la oferta de comestibles? | |
| Sí, hay un valor de compra mínimo de 10 para aprovechar el 15% de descuento en comestibles. Usa el código GROCERY500 para canjear esta oferta, válida hasta el 28 de marzo de 2024. Esperamos poder proporcionarte los detalles que necesitas. ¿Tienes alguna consulta sobre ofertas o promociones que podamos responder? |
|
| ¿Tiene ofertas de artículos electrónicos? | |
| Por supuesto. Estos son los detalles de la oferta: Oferta 1: Disfruta de un 5% de descuento en artículos electrónicos y usa el código ELECTRIC5, válida hasta el 28 de marzo de 2024. Oferta 2: Obtén un 15% de descuento en dispositivos electrónicos y usa el código ELECTRIC15, válido hasta el 28 de marzo de 2024. Esperamos poder proporcionarte los detalles que necesitas. ¿Tienes alguna consulta sobre ofertas o promociones que podamos responder? |
|
| No, terminé | |
| ¿Quieres que se compartan los detalles de la oferta en el dispositivo móvil o correo electrónico que registraste? | |
| No, gracias | |
| Gracias por llamar. |
Problema con el código de un cupón
El usuario final ya se autenticó anteriormente. El usuario menciona que tiene un problema con un código de cupón. El agente recopila el código del cupón y proporciona la con detalles sobre el canje del código del cupón. El usuario confirma que tienen un problema con el código del cupón y el agente envía un ticket a 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 el código de un cupón | |
| Para confirmar, estás buscando códigos de cupones. ¿Verdad? | |
| sí | |
| Lamentamos oír eso. ¿Podrías indicarme el código del cupón que estás usando? | |
| El agente recopila el código del cupón con el componente compilado previamente Colección alfanumérica. | |
| El código de la oferta APPARELS5 asociado con indumentaria necesita un valor de compra mínimo de USD 100 y es válido hasta el 28 de marzo de 2024. Asegúrate de que se cumplan las condiciones necesarias, como el requisito mínimo de compra. ¿Te resultó útil esta información? |
|
| no | |
| Especifica el problema que tienes. Puedes decir que el código de mi cupón no funciona o que no funciona en mi zona. | |
| El código del cupón no funciona | |
| Te confirmo que el problema que proporcionaste con el código del cupón no funciona. ¿Es correcta esta información? | |
| sí | |
| Generamos un ticket para informar tu problema. Gracias por llamar. |
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 de el componente. Los parámetros se utilizarán en una o más condiciones dentro de la para determinar cómo debe comportarse el componente. Los parámetros con alcance de flujo deben establecerse en la página de inicio del componente. Centrado en la sesión los parámetros se pueden configurar mediante un flujo de llamada, o bien 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 utiliza para identificar al usuario | string |
Este componente precompilado permite que se configuren los siguientes parámetros opcionales 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 las 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 el usuario tiene 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 de 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 de 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 de get_coupon_code_details, lo que indica que el código del cupón venció. El valor predeterminado es "expired". |
string |
Si quieres configurar los parámetros de entrada de este componente, expande para obtener 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 permanecerán activos después de salir el componente. Estos parámetros contienen información importante que recopila el este componente. Este componente precompilado proporciona valores para la siguiente salida: parámetros:
| 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 utiliza para identificar al usuario | 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 durante 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 coincidencia. Consulta los eventos integrados sin coincidencias.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 evento integrado webhook.error.not-found. |
string |
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 lo siguiente:
la conversación manejada por el componente.
Preguntas frecuentes generales
El generador General FAQ se usa para responder preguntas frecuentes relacionadas
a descuentos, ventas, compras y programas de lealtad.
- ¿Puedo devolver productos en oferta si cambio de opinión?
- ¿Puedo obtener muestras gratuitas o regalos con la compra de ciertos productos?
- ¿Ofrecen ajustes de precio si el artículo que compré sale a la oferta más tarde?
- ¿Hay un límite de tiempo para canjear 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 lo siguiente:
ofertas específicas para el usuario basadas en la información proporcionada por get_offers_details
webhook.
Ofertas y detalles de las ofertas
El generador Offers and deals details se usa para proporcionar detalles sobre lo siguiente:
ofertas generales y promociones basadas en la información proporcionada por el get_offers_details
webhook.
El usuario puede preguntar sobre ofertas en una categoría específica o pedir más detalles sobre
ofertas específicas.
Preguntas frecuentes sobre las ofertas
El generador Offers and deals FAQ se usa para responder las preguntas frecuentes
relacionadas con las ofertas.
- ¿Hay ofertas especiales para clientes nuevos?
- ¿Cómo me notifican sobre las próximas ofertas?
- ¿Hay ofertas solo disponibles en la tienda o en línea?
- ¿Con qué frecuencia se agregan acuerdos nuevos a tu plataforma?
Preguntas frecuentes sobre descuentos y códigos promocionales
Discount and promo code FAQ se usa para responder las preguntas frecuentes
relacionados 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 compilado previamente, haz lo siguiente:
- Importa el componente precompilado.
- Configura los webhooks flexibles con configuración que describa tus servicios externos de Dialogflow, consulta Webhook configuración.
Configuración de webhook
Para usar este componente, deberás configurar los componentes webhooks flexibles para recuperar la información necesaria de tus servicios externos.
Obtener detalles de las ofertas
Se usa el webhook prebuilt_components_offers_and_deals:get_offers_details
por el componente para recuperar detalles sobre las ofertas generales y específicas del usuario.
Parámetros de solicitud a la API
El componente proporciona los siguientes parámetros como entradas a 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 recuperarán 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 | Es el correo electrónico registrado en la cuenta proporcionada que se usa para enviar los detalles de la oferta. | string |
| user_offer | Es una lista de detalles de la oferta específica para el 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) |
Si quieres configurar el webhook para obtener detalles de las ofertas de este componente, expande el alcance para obtener 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 precompilado_components_offers_and_deals:get_offers_details.
- Reemplaza la URL en el campo URL de webhook de Dialogflow por el extremo del servicio. con los que quieres integrarte. Selecciona el Método adecuado en el menú desplegable.
- Revisa y actualiza el Cuerpo de la solicitud con el fin de formar el formato de solicitud adecuado para tu webhook.
- Revisa y actualiza la Configuración de respuesta para extraer campos específicos de la configuración respuesta. No modifiques los nombres de los parámetros, ya que el componente los requiere para acceder. los valores de campo mostrados.
- 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
Se usa el webhook prebuilt_components_offers_and_deals:get_coupon_code_details
por el componente para recuperar detalles sobre un código de cupón específico que un usuario
ha informado problemas.
Parámetros de solicitud a la API
El componente proporciona los siguientes parámetros como entradas a la solicitud a la API.
| Nombre del parámetro | Descripción | Formato de entrada |
|---|---|---|
| $flow.coupon_code | Código del cupón sobre el que se deben recuperar 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 | Es 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 parámetros de entrada $flow.valid_coupon_code_status, $flow.invalid_coupon_code_status y $flow.valid_coupon_code_status definen los valores válidos. |
string |
| valid_until | Fecha hasta la que es válido el código del cupón, en formato YYYY-MM-DD. |
string |
| minimum_order_value | Es el valor mínimo de pedido para el código del cupón. | string |
Si quieres configurar el webhook para obtener detalles del código de cupón de este componente, expande el alcance para obtener 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 precompilado_components_offers_and_deals:get_coupon_code_details.
- Reemplaza la URL en el campo URL de webhook de Dialogflow por el extremo del servicio. con los que quieres integrarte. Selecciona el Método adecuado en el menú desplegable.
- Revisa y actualiza el Cuerpo de la solicitud con el fin de formar el formato de solicitud adecuado para tu webhook.
- Revisa y actualiza la Configuración de respuesta para extraer campos específicos de la configuración respuesta. No modifiques los nombres de los parámetros, ya que el componente los requiere para acceder. los valores de campo mostrados.
- Revisa y actualiza la configuración de Authentication, según sea necesario.
- Haz clic en Guardar.
Enviar mensaje
Se usa el webhook prebuilt_components_offers_and_deals:send_message
por el componente para enviar un mensaje con los detalles de la oferta al
canal seleccionado.
Parámetros de solicitud a la API
El componente proporciona los siguientes parámetros como entradas a 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 utiliza para identificar al usuario | string |
| $flow.confirmation_channel | Canal que el usuario seleccionó para recibir los detalles de la oferta. La entidad prebuilt_components_channel_email_phone define los valores válidos. |
string |
Si quieres configurar el webhook de envío de mensajes para este componente, expande el alcance para obtener 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 precompilado_components_offers_and_deals:send_message.
- Reemplaza la URL en el campo URL de webhook de Dialogflow por el extremo del servicio. con los que quieres integrarte. Selecciona el Método adecuado en el menú desplegable.
- Revisa y actualiza el Cuerpo de la solicitud con el fin de formar el formato de solicitud adecuado para tu webhook.
- Revisa y actualiza la Configuración de respuesta para extraer campos específicos de la configuración respuesta. No modifiques los nombres de los parámetros, ya que el componente los requiere para acceder. los valores de campo mostrados.
- Revisa y actualiza la configuración de Authentication, según sea necesario.
- Haz clic en Guardar.
Subir ticket
Se usa el webhook prebuilt_components_offers_and_deals:raise_ticket
por el componente para enviar un ticket que informe un problema del usuario con el código de un cupón.
Parámetros de solicitud a la API
El componente proporciona los siguientes parámetros como entradas a 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 utiliza para identificar al usuario | 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 con el código del cupón. | string |
Si quieres configurar el webhook de aumento de tickets para este componente, expande el alcance para obtener 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:crash_ticket.
- Reemplaza la URL en el campo URL de webhook de Dialogflow por el extremo del servicio. con los que quieres integrarte. Selecciona el Método adecuado en el menú desplegable.
- Revisa y actualiza el Cuerpo de la solicitud con el fin de formar el formato de solicitud adecuado para tu webhook.
- Revisa y actualiza la Configuración de respuesta para extraer campos específicos de la configuración respuesta. No modifiques los nombres de los parámetros, ya que el componente los requiere para acceder. los valores de campo mostrados.
- 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.