El componente compilado previamente de orden de cambio verifica el nivel de autenticación del usuario. Después de autenticar al usuario, el componente proporciona información sobre sus pedidos más recientes o anteriores. Luego, el usuario puede elegir cambiar varios artículos de un pedido y seleccionar opciones, como los métodos de reembolso y envío.
Este componente usa el componente precompilado de autenticación de venta minorista para autenticar a los usuarios.
El componente también usa generadores para el resumen posterior a la llamada y las preguntas frecuentes.
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.
Cambio en la tienda por un artículo defectuoso
- El usuario ya se autenticó.
- El agente confirma qué artículos del pedido más reciente se deben cambiar y recopila el motivo del cambio.
- El usuario selecciona la opción para cambiar los artículos en una tienda.
- El agente proporciona una lista de las tiendas más cercanas.
- El usuario selecciona una tienda.
- El agente genera una etiqueta de envío que se envía a los canales registrados del usuario.
| Entrada del usuario | Respuesta del agente |
|---|---|
| ¿Llamas por tu pedido más reciente, que termina en 12375, incluye 2 lámparas, 2 Pixel y otros 10 productos, y se realizó el 10 de noviembre de 2023? | |
| sí | |
| Encontramos algunos productos aptos en tu pedido. Indícanos qué producto quieres cambiar. Producto 1: Lámpara de Google, Producto 2: Google Pixel, Producto 3: Luz LED de Google. Di o ingresa el número del producto que quieres seleccionar, o di "siguiente" para mostrar más productos. |
|
| 1 | |
| Para confirmar, te interesa cambiar la lámpara de Google. ¿Esto es correcto? | |
| sí | |
| Podemos ver que la cantidad disponible del producto que seleccionaste es 2. Especifica la cantidad de productos que quieres cambiar. | |
| Dos | |
| Especifica el motivo del intercambio. Por ejemplo, puedes decir: El artículo está defectuoso o no funciona, hay un problema con el tamaño o el ajuste, hay un problema con el pedido incompleto, hay un problema con el estilo, el color es incorrecto, entre otros. | |
| Artículo defectuoso | |
| Gracias por informarnos. Como último paso, ¿cómo quieres cambiar el producto? Por ejemplo, puedes decir: Cambiar en una tienda o Programar para retirar. |
|
| Quiero cambiarlo en una tienda | |
| Podemos encontrar una tienda cercana. | |
| El agente recopila el código postal con el componente precompilado Recopilación de códigos postales. | |
| Esta es la lista de ubicaciones cercanas al código postal que ingresaste. Dirección 1: Google Texas, 500 W 2nd St, Suite 2900 Austin, Texas 78701, EE.UU. Dirección 2: Google California, 19510 Jamboree Road, Irvine, California 92612, EE.UU. Di o ingresa el número de la dirección que quieres seleccionar, o di "siguiente" para mostrar más direcciones de tiendas. |
|
| La primera tienda | |
| Para confirmar, seleccionaste Google Texas, 500 W 2nd St, Suite 2900 Austin, Texas 78701, EE.UU. ¿Verdad? | |
| sí | |
| Perfecto. Enviamos una etiqueta de envío y un número de ticket a tu número de teléfono y correo electrónico registrados. Imprímela, pégala en el paquete y déjalo en un punto de entrega en un plazo de 30 días. Una vez que recibamos el artículo en nuestro almacén, el cambio, si corresponde, tardará entre 3 y 5 días hábiles en aparecer en tu cuenta. El importe del reembolso no incluye los gastos de envío y manipulación. El producto de reemplazo tiene un valor más alto. La diferencia de precio es de USD 20. Pronto recibirás el vínculo de pago en tu número de celular registrado. Realiza el pago en un plazo de 24 horas para realizar el cambio. ¿Quieres cambiar otro pedido? |
|
| no, eso es todo | |
| Gracias por llamar. |
Reembolso por diferencia de precio
- El usuario ya se autenticó.
- El agente recopila el número de pedido, el producto que se cambiará y el motivo del cambio.
- El usuario decide cambiar los artículos por un talle diferente y programa un retiro.
- El agente identifica que el artículo que se intercambiará tiene un precio más bajo que el nuevo y confirma con el usuario la forma de pago para el reembolso.
| Entrada del usuario | Respuesta del agente |
|---|---|
| ¿Llamas por tu pedido más reciente, que termina en 12345, contiene 2 lámparas y se realizó el 10 de noviembre de 2023? | |
| No | |
| ¿Quieres cambiar otro pedido? | |
| Sí | |
| ¿Podrías proporcionar los últimos cinco dígitos del ID del pedido que quieres cambiar? | |
| 12346 | |
| Los últimos cinco dígitos del ID de pedido que recibimos son 12346, ¿es correcto? | |
| Sí | |
| Excelente, ya recopilamos el ID del pedido. Encontramos algunos productos aptos en tu pedido. Dinos qué producto quieres cambiar. Producto 1: Botella de agua de Google, Producto 2: Camiseta de Google. Di o ingresa el número del producto que quieres seleccionar, o di "siguiente" para mostrar más productos. |
|
| Dos | |
| Para verificar, quieres cambiar la camiseta de Google. ¿Esto es correcto? | |
| Sí | |
| Especifica el motivo del intercambio. Puedes decir algo como: El artículo está defectuoso o no funciona, hay un problema con el tamaño o el ajuste, hay un problema con el pedido incompleto, hay un problema con el estilo, el color es incorrecto, o bien puedes decir otros. | |
| Problema de tamaño o ajuste | |
| Gracias por informarnos el motivo del cambio. ¿Puedes decirnos qué talle te gustaría recibir? Tenemos los siguientes tamaños disponibles: Di 1 para pequeño. Di 2 para mediano. Di 3 para grande. Di 4 para XL. Di 5 para XXL. |
|
| 1 | |
| Como último paso, ¿cómo quieres cambiar el producto? Puedes decir algo como: Cambiar en una tienda o Programar para retirar. | |
| Programar para retirar | |
| Perfecto. Enviamos una etiqueta de envío al número de teléfono y al correo electrónico que registraste. Imprímela y pégala en el paquete. Nuestro equipo se comunicará contigo en un plazo de 24 a 48 horas para programar la recolección. Una vez que recibamos el artículo en nuestro almacén, el reembolso del cambio tardará entre 3 y 5 días hábiles en aparecer en tu cuenta. El producto que cambiaste tiene un valor inferior y cumples con los requisitos para recibir un reembolso de USD 5. Indícanos dónde quieres recibir el reembolso. Puedes decir algo como crédito de Store o cuenta de origen. |
|
| Crédito de Google Store | |
| Gracias por verificar que quieres que el reembolso se devuelva a la billetera. ¿Quieres cambiar otro pedido? |
|
| no | |
| Gracias por llamar. |
Pedido no apto
- El usuario ya se autenticó anteriormente.
- El agente revisa el pedido más reciente y descubre que no hay productos aptos para el cambio.
- El agente recopila un número de pedido del usuario y descubre que el pedido proporcionado no tiene ningún producto apto.
| Entrada del usuario | Respuesta del agente |
|---|---|
| No encontramos ningún producto en tu pedido más reciente que cumpla con los requisitos para un cambio. ¿Quieres cambiar otro pedido? |
|
| sí | |
| ¿Podrías proporcionar los últimos cinco dígitos del ID del pedido que quieres cambiar? | |
| 23487 | |
| Los últimos cinco dígitos del ID de pedido que obtuvimos son 23487, ¿es correcto? | |
| sí | |
| Genial, ya recopilamos el ID de pedido. | |
| Lo sentimos, pero, según nuestras políticas, no hay productos en tu pedido que cumplan con los requisitos para un cambio. Puedes encontrar más información sobre nuestra política de cambios en nuestro sitio web. ¿Quieres cambiar otro pedido? |
|
| no | |
| Gracias por llamar. |
Convenciones de nombres
Este componente precompilado usa las siguientes convenciones de nombres:
| Función | Formato | Ejemplo |
|---|---|---|
| Flujo | [Nombre del componente] | Order Status |
| Tipo de entidad | prebuilt_components_[component_name]_[entity_type] | prebuilt_components_exchange_order_location |
| Webhook | prebuilt_components_[component_name]:[webhook_action] | prebuilt_components_exchange_order:get_product_exchange_availability |
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, como se describe a continuación. Puedes establecer parámetros centrados en la sesión con un flujo de llamadas o en la página de inicio de este componente.
Este componente precompilado acepta los siguientes parámetros de entrada:
| Nombre del parámetro | Descripción | Formato de entrada |
|---|---|---|
| $session.params.phone_number | (Opcional) Es el número de teléfono local del usuario, sin el código de país, que se usa para identificarlo. | cadena |
| $session.params.all_recent_order_id | (opcional) Son los IDs de pedido asociados con el usuario autenticado, ordenados por la fecha de realización del pedido en orden descendente. El primer elemento del array representa el pedido más reciente. Si el usuario autenticado no tiene pedidos, el valor de este parámetro es null. |
Lista (cadena) |
| $session.params.email | (Opcional) El correo electrónico registrado con la cuenta. | cadena |
| $session.params.user_first_name | (opcional) El nombre del usuario, que se usa para saludarlo y confirmar la propiedad de la cuenta. | cadena |
Este componente precompilado te permite configurar parámetros opcionales para controlar el comportamiento del componente, incluidos los reintentos.
| Nombre del parámetro | Descripción | Formato |
|---|---|---|
| $flow.max_retry_another_account | Especifica la cantidad de reintentos permitidos cuando se selecciona si se debe continuar con una cuenta alternativa. El valor predeterminado es 3. |
integer |
| $flow.max_retry_order_number | Especifica la cantidad de reintentos permitidos cuando se proporcionan los últimos cinco dígitos de un número de pedido. El valor predeterminado es 3. |
integer |
| $flow.max_retry_another_order | Especifica la cantidad de reintentos permitidos cuando se selecciona otro pedido para la devolución en los casos en que no se encuentra el ID del pedido o este no es apto para el cambio. El valor predeterminado es 2. |
integer |
| $flow.max_retry_select_order_number | Especifica la cantidad de reintentos permitidos cuando se proporciona el número de pedido completo en los casos en que más de un pedido comparte los mismos últimos cinco dígitos. El valor predeterminado es 2. |
integer |
| $flow.max_retry_exchange_reason | Especifica la cantidad de reintentos permitidos cuando se proporciona el motivo del intercambio. El valor predeterminado es 3. |
integer |
| $flow.max_retry_exchange_reason_counter | Especifica la cantidad de reintentos permitidos cuando se confirma el motivo del intercambio. El valor predeterminado es 2. |
integer |
| $flow.order_product_exchange_reason_others | Especifica el valor de la entidad prebuilt_components_exchange_order_reason que indica que el usuario seleccionó el motivo de intercambio "otros". El valor predeterminado es "others". |
cadena |
| $flow.max_product_display_counter | Especifica la cantidad máxima de productos que se presentarán en un solo turno. El valor predeterminado es 2. |
integer |
| $flow.max_product_display | Especifica la cantidad máxima de productos que se presentarán durante toda la conversación. El valor predeterminado es 9. |
integer |
| $flow.max_product_exchange_confirm | Especifica la cantidad máxima de reintentos permitidos cuando se confirma el producto seleccionado. El valor predeterminado es 2. |
integer |
| $flow.max_retry_product_number_counter | Especifica la cantidad máxima de reintentos permitidos cuando se selecciona un producto para intercambiar. El valor predeterminado es 3. |
integer |
| $flow.max_retry_select_quantity | Especifica la cantidad máxima de reintentos permitidos cuando se selecciona la cantidad de productos que se intercambiarán. El valor predeterminado es 2. |
integer |
| $flow.max_retry_size_number_counter | Especifica la cantidad máxima de reintentos permitidos cuando se selecciona el tamaño que se intercambiará. El valor predeterminado es 2. |
integer |
| $flow.max_retry_another_zip_code | Especifica la cantidad máxima de reintentos permitidos cuando se proporciona un código postal. El valor predeterminado es 2. |
integer |
| $flow.max_store_display_counter | Especifica la cantidad máxima de tiendas que se presentarán en un solo turno. El valor predeterminado es 1. |
integer |
| $flow.max_store_display | Especifica la cantidad máxima de tiendas que se presentarán durante toda la conversación. El valor predeterminado es 10. |
integer |
| $flow.max_retry_store_number_counter | Especifica la cantidad máxima de reintentos permitidos cuando se selecciona una tienda. El valor predeterminado es 2. |
integer |
| $flow.max_retry_store_selection | Especifica la cantidad de reintentos permitidos cuando se confirma la selección de la tienda. El valor predeterminado es 3. |
integer |
| $flow.max_available_address_reselection_counter | Especifica la cantidad de reintentos permitidos cuando se confirma si el usuario desea seleccionar otra dirección de la tienda. El valor predeterminado es 2. |
integer |
| $flow.order_payment_mode_COD | Especifica el valor del campo order_payment_mode que devuelve el webhook de get_order_details que indica una forma de pago contra entrega (COD). El valor predeterminado es "COD". |
cadena |
| $flow.order_payment_mode_store_credit | Especifica el valor del campo order_payment_mode que devuelve el webhook de get_order_details que indica una forma de pago con crédito de Store. El valor predeterminado es "store_credit". |
cadena |
| $flow.order_refund_mode_source_account | Especifica el valor de la entidad prebuilt_components_exchange_order_refund_mode que indica que el usuario seleccionó el reembolso a su cuenta de origen. El valor predeterminado es source_account. |
cadena |
| $flow.order_exchange_location_scheduled_for_pickup | Especifica el valor de la entidad prebuilt_components_exchange_order_location que indica que el usuario seleccionó programar un retiro para el cambio. El valor predeterminado es scheduled_for_pickup. |
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 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 |
| all_recent_order_id | Son los IDs de pedido asociados con el usuario autenticado, ordenados por la fecha de realización del pedido en orden descendente. El primer elemento del array representa el pedido más reciente. Si el usuario autenticado no tiene pedidos, el valor de este parámetro es null. |
Lista (cadena) |
| correo electrónico | Es el correo electrónico registrado con la cuenta. | cadena |
| user_first_name | Es el nombre del usuario, que se usa para saludarlo y confirmar la propiedad de la cuenta. | cadena |
| transfer_reason | 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 |
Generadores
Este componente usa generadores para permitirte habilitar partes específicas de la conversación.
Preguntas frecuentes
El generador FAQ controla las preguntas frecuentes sobre devoluciones y
cambios, incluidas las siguientes:
- ¿Hay una fecha límite para el proceso de devolución?
- ¿Se puede cambiar un artículo de regalo?
- El precio del producto y el importe del reembolso son diferentes. ¿Por qué pasa eso?
Resúmenes
El generador Summarization crea un resumen posterior a la llamada que describe la
conversación que controla el componente.
Configuración básica
Para configurar este componente precompilado, completa los siguientes pasos:
- Importa el componente compilado previamente.
- Configura los webhooks flexibles proporcionados con la configuración que describe 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.
Autenticación
Si no configuraste antes los servicios externos necesarios para la autenticación, configúralos para habilitar la autenticación de los usuarios en este componente. Para obtener más información, consulta la documentación de Configuración del webhook de autenticación de Retail.
Obtén los detalles del pedido
El componente usa el webhook prebuilt_components_exchange_order:get_order_details
para recuperar los detalles de un pedido específico.
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.order_id | Es el ID del pedido del que se quieren recuperar detalles. | 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 |
|---|---|---|
| order_date | Es la fecha en la que se realizó el pedido, en formato YYYY-MM-DD. |
cadena |
| order_product_count | Es la cantidad de productos únicos en el pedido. | integer |
| order_payment_mode | Indica la forma de pago que se utilizó cuando se realizó el pedido. | cadena |
| exchangeable_product_id | Es una lista de IDs de productos intercambiables dentro del pedido. | Lista (cadena) |
| exchangeable_product_name | Es una lista de los nombres de los productos intercambiables del pedido. | Lista (cadena) |
| exchangeable_product_brand_name | Es una lista de nombres de marcas de productos intercambiables dentro del pedido. | Lista (cadena) |
| exchangeable_product_quantity | Es una lista de cantidades de productos intercambiables dentro del pedido. | Lista (cadena) |
| exchangeable_product_price | Es una lista de precios de los productos intercambiables del pedido. | Lista (cadena) |
Para configurar el webhook Obtener detalles del pedido 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_exchange_order:get_order_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.
Obtén detalles de pedidos duplicados
El componente usa el webhook prebuilt_components_retail_services:get_duplicate_order_details para recuperar información detallada que te permite distinguir entre pedidos cuando varios números de pedido tienen los mismos últimos cinco dígitos.
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.duplicate_order_id | Es una lista que contiene los últimos cinco dígitos de los números de pedido compartidos entre uno o más pedidos del usuario. | 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 |
|---|---|---|
| all_order_date | Es una lista de fechas de pedidos duplicados con los últimos cinco dígitos especificados en el formato YYYY-MM-DD. Cada elemento de este array corresponde al mismo elemento del array all_order_time. |
Lista (cadena) |
| all_order_time | Es una lista de las horas de los pedidos duplicados con los últimos cinco dígitos especificados en formato HH:MM. Cada elemento de este array corresponde al mismo elemento del array all_order_date. |
Lista (cadena) |
Para configurar el webhook Obtener detalles de pedidos duplicados 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_retail_services:get_duplicate_order_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.
Obtén el tamaño de intercambio disponible
El webhook prebuilt_components_exchange_order:get_available_exchange_size
permite que el componente recupere los tamaños disponibles para el cambio si el usuario quiere
cambiar un artículo debido a problemas de tamaño o ajuste.
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.selected_order_product_id | Es el ID del producto que el usuario quiere intercambiar. | 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 |
|---|---|---|
| product_available_sizes | Es una lista de los tamaños disponibles para el producto seleccionado. | Lista (cadena) |
Para configurar el webhook Obtener tamaño de intercambio disponible 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_exchange_order:get_available_exchange_size.
- 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 la disponibilidad de intercambio de productos
El webhook prebuilt_components_exchange_order:get_product_exchange_availability
permite que el componente verifique si el producto, la cantidad
y el tamaño seleccionados por el usuario están disponibles para el intercambio.
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.order_id | Es el ID del pedido del que se quieren recuperar detalles. | cadena |
| $flow.selected_order_product_id | Es el ID del producto que el usuario quiere intercambiar. | cadena |
| $flow.order_product_quantity_exchange_count | Es la cantidad del producto que el usuario quiere cambiar. | integer |
| $flow.product_selected_size | Es la talla del producto por el que el usuario quiere cambiar el artículo. | 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 |
|---|---|---|
| product_exchange_availability | Indica si el producto, la cantidad y el tamaño seleccionados están disponibles para el cambio. | booleano |
| product_exchange_price | Indica el precio de intercambio de un solo artículo del producto y el tamaño seleccionados. | número |
Para configurar el webhook Obtener disponibilidad de intercambio de productos 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_exchange_order:get_product_exchange_availability.
- 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.
Genera un ticket de pedido incompleto
El componente usa el webhook
prebuilt_components_exchange_order:raise_incomplete_order_ticket
para generar un ticket cuando un usuario quiere cambiar un producto de un pedido porque
está incompleto.
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.order_id | Es el ID del pedido para el que se enviará un ticket. | cadena |
| $flow.selected_order_product_id | Es el ID del producto que el usuario quiere intercambiar. | cadena |
| $flow.order_product_quantity_exchange_count | Es la cantidad del producto que el usuario quiere cambiar. | integer |
| $flow.order_product_exchange_reason | Es el motivo por el que el usuario quiere cambiar el producto. | cadena |
Para configurar el webhook Generar ticket de pedido incompleto 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_exchange_order:raise_incomplete_order_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 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 tienda
El webhook prebuilt_components_exchange_order:get_store_details permite que el componente recupere la lista de tiendas cercanas al código postal que proporcionó el 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 |
|---|---|---|
| $flow.zip_code | Código postal para buscar tiendas cercanas. | 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 |
|---|---|---|
| store_id | Es una lista de IDs de tienda. | Lista (cadena) |
| store_address | Es una lista de direcciones de tiendas que corresponden a cada elemento de store_id. |
Lista (cadena) |
Para configurar el webhook Obtener detalles de la tienda 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_exchange_order:get_store_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.
Detalles del intercambio de publicaciones
El componente usa el webhook prebuilt_components_exchange_order:post_exchange_details para enviar un intercambio.
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.order_id | Es el ID del pedido para el que se enviará un ticket. | cadena |
| $flow.selected_order_product_id | Es el ID del producto que el usuario quiere intercambiar. | cadena |
| $flow.order_product_quantity_exchange_count | Es la cantidad del producto que el usuario quiere cambiar. | integer |
| $flow.product_selected_size | Es la talla del producto por el que el usuario quiere cambiar el artículo. | cadena |
| $flow.order_product_exchange_reason | Es el motivo por el que el usuario quiere cambiar el producto. | cadena |
| $flow.order_exchange_location | Es el modo seleccionado para el intercambio. Los valores válidos se definen con la entidad prebuilt_components_exchange_order_location. |
cadena |
| $flow.order_exchange_store_id | Es el ID de la tienda que seleccionó el usuario para realizar un cambio en la tienda. | cadena |
| $flow.order_refund_mode | Es la forma de pago del reembolso, si corresponde. Los valores válidos se definen con la entidad prebuilt_components_exchange_order_refund_mode. Si no se requiere un reembolso, este valor es null. |
cadena |
| $flow.total_refund_amount | Es el importe que se reembolsará si el precio del producto que se puede cambiar es más alto que el del producto nuevo. Si no se requiere un reembolso, este valor es null. |
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 |
|---|---|---|
| order_exchange_ticket_id | Es el ID del ticket del intercambio enviado. | cadena |
Para configurar el webhook de detalles del intercambio de publicaciones 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 prebuilt_components_exchange_order:post_exchange_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.
Envía la información de reembolso de COD
El webhook prebuilt_components_exchange_order:send_COD_refund_information
permite que el componente envíe información de pago relacionada con el intercambio al 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. | cadena |
| $flow.order_id | Es el ID del pedido para el que se enviará un ticket. | cadena |
| $flow.channel | Es el canal específico al que se enviará la información. Los valores válidos se definen con la entidad prebuilt_components_channel_email_phone. De forma predeterminada, se admiten phone y email. |
cadena |
Para configurar el webhook de envío de información de reembolso de COD 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_exchange_order:send_COD_refund_information.
- 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 compilado previamente y sus webhooks ya están configurados y listos para probarse.