Devolver y reembolsar un componente prediseñado

El componente precompilado de devoluciones y reembolsos comprueba el nivel de autenticación de un usuario. Una vez que se ha autenticado al usuario, el componente proporciona información sobre sus pedidos más recientes o anteriores. El usuario puede elegir devolver varios artículos de un pedido y seleccionar opciones, como los métodos de reembolso y devolución. Este componente usa el componente prediseñado Retail authentication para autenticar a los usuarios. El componente también usa Generators para generar resúmenes y preguntas frecuentes después de las llamadas.

Limitaciones

Además de las limitaciones comunes de los componentes prediseñados, este componente prediseñado tiene las siguientes limitaciones:

• Este componente no cifra ningún dato.

Ejemplos de cuadros de diálogo

En los siguientes ejemplos de cuadros de diálogo se muestran situaciones habituales que gestiona este componente prediseñado. Los diálogos de ejemplo muestran el comportamiento cuando se llama al componente mediante telefonía, lo que activa la intención de bienvenida predeterminada y la primera respuesta del agente al inicio de la conversación.

Devolución en tienda de un solo producto

El usuario final ya se ha autenticado. El agente confirma qué artículos del pedido más reciente se deben devolver y pregunta al cliente el motivo de la devolución. El usuario selecciona la opción de devolver los artículos en una tienda y el agente le proporciona una lista de las tiendas más cercanas. El usuario selecciona una tienda y 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, con número de pedido que termina en 12345, que contiene 2 lámparas y que hiciste el 10 de noviembre del 2023?
yes
	Para confirmar que quieres devolver la lámpara de Google. ¿Es correcto?
yes
	Vemos que la cantidad disponible del producto que ha seleccionado es 2. Indique la cantidad de productos que quiere devolver.
dos
	Especifica el motivo de la devolución. Puedes decir algo como: el artículo está defectuoso o no funciona, ya no lo necesito, no me vale o no me queda bien, me han enviado el artículo incorrecto, el artículo ha llegado demasiado tarde, lo he comprado por error o cualquier otro motivo.
otros
	Indica el motivo de la devolución.
mala calidad
	Para verificarlo, el motivo de la devolución es la mala calidad. ¿Es correcto?
yes
	Indícanos dónde quieres recibir el reembolso. Puedes decir algo como "saldo de la tienda" o "cuenta de origen".
cuenta de origen
	Gracias por confirmar que quieres que el reembolso se devuelva al método de pago original. Como último paso, ¿cómo quieres devolver el producto? Puedes decir algo como "Devolver en tienda", "Dejar en un punto de entrega" o "Programar recogida".
devolución en tienda
	Vamos a buscar una tienda cerca de ti.
	El agente recoge el código postal mediante el componente prediseñado Recogida de código postal
	Esta es la lista de ubicaciones cercanas al código postal que has introducido. 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 introduce el número de la dirección que quieras seleccionar, o di "siguiente" para ver más direcciones de tiendas.
1
	Para confirmar, has seleccionado Google Texas, 500 W 2nd St, Suite 2900 Austin, Texas 78701, EE. UU. ¿Es correcto?
yes
	Perfecto. Hemos enviado una etiqueta de envío y un número de incidencia al número de teléfono y a la dirección de correo registrados. Imprímela, adjúntala al paquete y déjalo en el punto de entrega en un plazo de 30 días. Una vez que recibamos el artículo en nuestro almacén, el reembolso aparecerá en tu cuenta en un plazo de entre 3 y 5 días hábiles. Nota: El importe del reembolso no incluye los gastos de envío y gestión. Gracias por llamar.

Convenciones de nombres

Este componente prediseñado usa las siguientes convenciones de nomenclatura:

Función	Formato	Ejemplo
Flujo	[Component Name]	Devolución y reembolso
Tipo de entidad	prebuilt_components_[component_name]_[entity_type]	prebuilt_components_return_refund_mode_of_return
Webhook	prebuilt_components_[component_name]:[webhook_action]	prebuilt_components_return_refund:post_return_details

Parámetros de entrada

Los parámetros de entrada son parámetros que se usan para configurar determinados comportamientos del componente. Los parámetros los usarán una o varias condiciones del flujo para determinar cómo debe comportarse el componente. Los parámetros definidos en el flujo deben establecerse en la página de inicio del componente. Los parámetros de ámbito de sesión se pueden definir mediante un flujo de llamada o en la página de inicio de este componente.

Este componente prediseñado acepta los siguientes parámetros de entrada:

Nombre del parámetro	Descripción	Formato de entrada
$session.params.phone_number	(Opcional) Número de teléfono local del usuario, sin el código de país, que se usa para identificar al usuario.	cadena
$session.params.all_recent_order_id	(opcional) Este parámetro muestra los IDs de pedido asociados al 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 un usuario no tiene ningún pedido, el valor de este parámetro es null.	Lista (cadena)
$session.params.email	(Opcional) El correo registrado en la cuenta.	cadena
$session.params.user_first_name	Nombre del usuario (opcional). Se usa para saludar al usuario y confirmar la propiedad de la cuenta.	cadena

Este componente prediseñado permite usar los siguientes parámetros opcionales para configurar el comportamiento del componente, incluidos los reintentos.

Nombre del parámetro	Descripción	Formato
$flow.max_retry_another_account_counter	Especifica el número de reintentos permitidos al seleccionar si se debe continuar con una cuenta alternativa. El valor predeterminado es 2.	entero
$flow.max_retry_order_number	Especifica el número de reintentos permitidos al proporcionar los últimos cinco dígitos de un número de pedido. El valor predeterminado es 3.	entero
$flow.max_retry_another_order	Especifica el número de reintentos permitidos al seleccionar otro pedido para la devolución en los casos en los que no se encuentra el ID de pedido o el pedido no cumple los requisitos para la devolución. El valor predeterminado es 2.	entero
$flow.max_retry_select_order_number	Especifica el número de reintentos permitidos al proporcionar el número de pedido completo en los casos en los que varios pedidos comparten los mismos cinco últimos dígitos. El valor predeterminado es 2.	entero
$flow.max_product_display_counter	Especifica el número máximo de productos que se pueden presentar en un solo turno. El valor predeterminado es 2.	entero
$flow.max_product_display	Especifica el número máximo de productos que se pueden presentar en toda la conversación. El valor predeterminado es 9.	entero
$flow.max_retry_product_number_counter	Especifica el número máximo de reintentos permitidos al seleccionar un producto para devolverlo. El valor predeterminado es 2.	entero
$flow.max_product_return_confirm_counter	Especifica el número máximo de reintentos permitidos al confirmar el producto seleccionado. El valor predeterminado es 2.	entero
$flow.max_retry_return_reason_counter	Especifica el número de reintentos permitidos al confirmar el motivo de la devolución. El valor predeterminado es 2.	entero
$flow.order_product_return_reason_others	Especifica el valor de la entidad prebuilt_components_return_refund_reason que indica que el usuario ha seleccionado el motivo de devolución "Otros". El valor predeterminado es "others".	cadena
$flow.max_retry_select_quantity	Especifica el número máximo de reintentos permitidos al seleccionar la cantidad de producto que se va a devolver. El valor predeterminado es 2.	entero
$flow.max_store_display_counter	Especifica el número máximo de tiendas que se pueden presentar en un solo turno. El valor predeterminado es 1.	entero
$flow.max_store_display	Especifica el número máximo de tiendas que se pueden presentar durante toda la conversación. El valor predeterminado es 10.	entero
$flow.max_retry_store_number_counter	Especifica el número máximo de reintentos permitidos al seleccionar una tienda. El valor predeterminado es 2.	entero
$flow.max_retry_store_selection	Especifica el número de reintentos permitidos al confirmar la selección de la tienda. El valor predeterminado es 2.	entero
$flow.max_retry_another_zip_code	Especifica el número máximo de reintentos permitidos al proporcionar un código postal. El valor predeterminado es 2.	entero
$flow.order_payment_mode_COD	Especifica el valor del campo order_payment_mode devuelto por el get_order_details webhook que indica un método de pago contra reembolso. El valor predeterminado es "COD".	cadena
$flow.order_payment_mode_store_credit	Especifica el valor del campo order_payment_mode devuelto por el get_order_details webhook que indica un método de pago con saldo de Google Store. El valor predeterminado es "store_credit".	cadena
$flow.order_refund_mode_source_account	Especifica el valor de la entidad prebuilt_components_return_refund_mode_of_refund que indica que el usuario ha seleccionado la opción de reembolsar el importe a su cuenta de origen. El valor predeterminado es source_account.	cadena
$flow.order_return_location_scheduled_for_pickup	Especifica el valor de la entidad prebuilt_components_exchange_order_location que indica que el usuario ha seleccionado programar una recogida para la devolución. El valor predeterminado es scheduled_for_pickup.	cadena

Parámetros de salida

Los parámetros de salida son parámetros de sesión que permanecerán activos después de salir del componente. Estos parámetros contienen información importante recogida por el componente. Este componente prediseñado proporciona valores para los siguientes parámetros de salida:

Nombre del parámetro	Descripción	Formato de salida
phone_number	Número de teléfono local del usuario, sin el código de país, que se usa para identificar al usuario.	cadena
all_recent_order_id	Este parámetro muestra los IDs de pedido asociados al usuario autenticado, ordenados por la fecha de realización del pedido de forma descendente. El primer elemento del array representa el pedido más reciente. Si un usuario no tiene ningún pedido, el valor de este parámetro es null.	Lista (cadena)
correo electrónico	El correo registrado en la cuenta.	cadena
user_first_name	Nombre del usuario, que se usa para saludarle y confirmar que es el propietario de la cuenta.	cadena
transfer_reason	Este parámetro indica el motivo por el que se ha cerrado el flujo, si no se ha completado correctamente. El valor devuelto es uno de los siguientes: agent: el usuario final ha solicitado un agente humano en algún momento de la conversación. denial_of_information: el usuario final se ha negado a compartir la información solicitada por el componente. max_no_input: la conversación ha alcanzado el número máximo de reintentos para eventos sin entrada. Consulta los eventos integrados sin entrada. max_no_match: la conversación ha alcanzado el número máximo de reintentos para los eventos sin coincidencias. Consulte los eventos integrados sin coincidencias. webhook_error: se ha producido un error de webhook. Consulte el evento integrado webhook.error. webhook_not_found: no se ha podido acceder a una URL de webhook. Consulte el evento integrado webhook.error.not-found.	cadena

Generadores

Este componente usa Generators para habilitar partes específicas de la conversación.

Preguntas frecuentes

El generador de FAQ se usa para responder a preguntas frecuentes sobre devoluciones y cambios, como las siguientes:

• ¿Hay un plazo para el proceso de devolución?
• ¿Puedo cambiar un artículo de regalo?
• El precio del producto y el importe del reembolso son diferentes. ¿Por qué?

Creación de resúmenes

El generador Summarization se usa para generar un resumen posterior a la llamada que describa la conversación gestionada por el componente.

Configuración básica

Para configurar este componente prediseñado, sigue estos pasos:

1. Importa el componente precompilado.
2. Configura los webhooks flexibles proporcionados con la configuración que describe tus servicios externos. Consulta la sección sobre la configuración de webhooks.

Configuración de webhook

Para usar este componente, debes configurar los webhooks flexibles incluidos para obtener la información necesaria de tus servicios externos.

Autenticación

Si no has configurado previamente los servicios externos necesarios para la autenticación, tendrás que hacerlo para habilitar la autenticación de los usuarios de este componente. Consulta las instrucciones detalladas para configurar el webhook de autenticación de comercio.

Obtener detalles del pedido

El webhook prebuilt_components_return_refund:get_order_details lo usa el componente para obtener los detalles de un pedido concreto.

Parámetros de solicitud a la API

El componente proporciona los siguientes parámetros como entradas para la solicitud de la API.

Nombre del parámetro	Descripción	Formato de entrada
$flow.order_id	ID del pedido del que se quieren obtener los detalles.	cadena

Parámetros de respuesta de la API

Los siguientes parámetros se extraen de la respuesta de la API para que los use el componente.

Nombre del parámetro	Descripción	Formato de salida
order_date	Fecha en la que se hizo el pedido, en formato YYYY-MM-DD.	cadena
order_product_count	Número de productos únicos de un pedido.	entero
order_payment_mode	Indica el método de pago utilizado al hacer el pedido.	cadena
returnable_product_id	Lista de IDs de producto de los productos que se pueden devolver del pedido.	Lista (cadena)
returnable_product_name	Lista de nombres de productos que se pueden devolver del pedido.	Lista (cadena)
returnable_product_brand_name	Lista de nombres de marca de los productos devueltos del pedido.	Lista (cadena)
returnable_product_quantity	Lista de cantidades de los productos que se pueden devolver del pedido.	Lista (cadena)

Obtener detalles de un pedido duplicado

El webhook prebuilt_components_retail_services:get_duplicate_order_details lo usa el componente para obtener información detallada y distinguir entre pedidos cuando varios números de pedido tienen los mismos cinco últimos dígitos.

Parámetros de solicitud a la API

El componente proporciona los siguientes parámetros como entradas para la solicitud de la API.

Nombre del parámetro	Descripción	Formato de entrada
$flow.duplicate_order_id	Lista que contiene los cinco últimos dígitos de los números de pedido compartidos entre uno o varios pedidos del usuario.	Lista (cadena)

Parámetros de respuesta de la API

Los siguientes parámetros se extraen de la respuesta de la API para que los use el componente.

Nombre del parámetro	Descripción	Formato de salida
all_order_date	Lista de fechas de pedidos duplicados con los cinco últimos dígitos especificados en formato YYYY-MM-DD. Cada elemento de esta matriz se corresponde con el mismo elemento de la matriz all_order_time.	Lista (cadena)
all_order_time	Lista de horas de los pedidos duplicados con los cinco últimos dígitos especificados en formato HH:MM. Cada elemento de esta matriz se corresponde con el mismo elemento de la matriz all_order_date.	Lista (cadena)

Obtener detalles de la tienda

El webhook prebuilt_components_return_refund:get_store_details se usa para que el componente obtenga la lista de tiendas cercanas al código postal que ha proporcionado el usuario.

Parámetros de solicitud a la API

El componente proporciona los siguientes parámetros como entradas para la solicitud de la API.

Nombre del parámetro	Descripción	Formato de entrada
$flow.zip_code	Código postal para buscar tiendas cercanas.	cadena

Parámetros de respuesta de la API

Los siguientes parámetros se extraen de la respuesta de la API para que los use el componente.

Nombre del parámetro	Descripción	Formato de salida
store_id	Lista de IDs de tienda.	Lista (cadena)
store_address	Lista de direcciones de tiendas correspondientes a cada elemento de store_id.	Lista (cadena)

Publicar los detalles de la devolución

El webhook prebuilt_components_return_refund:post_return_details se usa por el componente para enviar una devolución.

Parámetros de solicitud a la API

El componente proporciona los siguientes parámetros como entradas para la solicitud de la API.

Nombre del parámetro	Descripción	Formato de entrada
$session.params.phone_number	Número de teléfono local del usuario, sin el código de país, que se usa para identificar al usuario.	cadena
$flow.order_id	ID de pedido para enviar una incidencia.	cadena
$flow.return_product_id_list	Lista de IDs de producto que el usuario quiere devolver.	Lista (cadena)
$flow.return_product_quantity_list	Lista de cantidades de productos que el usuario quiere devolver, correspondiente a cada elemento de $flow.return_product_id_list.	Lista (cadena)
$flow.return_reason_list	Lista de motivos de devolución de cada producto devuelto, correspondiente a cada elemento de $flow.return_product_id_list.	Lista (cadena)
$flow.order_return_location	El modo seleccionado para la devolución. Los valores válidos se definen en la entidad prebuilt_components_exchange_order_location.	cadena
$flow.order_return_store_id	El ID de la tienda seleccionada por el usuario para devolver un producto.	cadena
$flow.order_refund_mode	El modo de pago del reembolso. Los valores válidos se definen en la entidad prebuilt_components_return_refund_mode_of_return. Si no se requiere ningún reembolso, este valor es null.	cadena

Parámetros de respuesta de la API

Los siguientes parámetros se extraen de la respuesta de la API para que los use el componente.

Nombre del parámetro	Descripción	Formato de salida
order_return_ticket_id	ID de la incidencia de la devolución enviada.	cadena

Enviar información sobre el reembolso de COD

El webhook prebuilt_components_return_refund:send_COD_refund_information lo usa el componente para enviar información de pago relacionada con devoluciones a un usuario.

Parámetros de solicitud a la API

El componente proporciona los siguientes parámetros como entradas para la solicitud de la API.

Nombre del parámetro	Descripción	Formato de entrada
$session.params.phone_number	Número de teléfono local del usuario, sin el código de país, que se usa para identificar al usuario.	cadena
$flow.order_id	ID de pedido para enviar una incidencia.	cadena
$flow.channel	El canal específico al que se va a enviar la información. Los valores válidos se definen en la entidad prebuilt_components_channel_email_phone. De forma predeterminada, se admiten phone y email.	cadena

Completado

Tu agente y sus webhooks ya deberían estar configurados y listos para probarse.