Componente precompilado de comentarios

El componente prediseñado de comentarios recopila comentarios cuantitativos y cualitativos del usuario final.

Primero, el componente realiza una búsqueda con el webhook de verificación de comentarios recientes configurado para comprobar si ese usuario final en particular proporcionó comentarios recientemente. Si no hay comentarios recientes, el componente le pide al usuario que proporcione una puntuación cuantitativa entre uno y cinco. Si los comentarios son negativos, el componente puede recopilar, de forma opcional, comentarios cualitativos de formato libre del usuario.

Limitaciones

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

• El componente supone que los números de teléfono de los clientes se mantienen en un sistema de CRM (administración de relaciones con clientes) o en otro servicio.
• Los clientes existentes que usen un número de teléfono alternativo para comunicarse no se autenticarán con este componente.

Diálogos de muestra

En los siguientes diálogos de ejemplo, se muestran situaciones comunes que maneja este componente prediseñado. Los diálogos de muestra demuestran el comportamiento cuando se llama al componente a través de la telefonía, lo que activa el intent de bienvenida predeterminado y la primera respuesta del agente al inicio de la conversación.

Comentarios positivos

La respuesta del webhook de Check last feedback indica que el usuario final no proporcionó comentarios recientemente. El agente solicita la puntuación de comentarios del usuario, y este proporciona una puntuación que indica una experiencia positiva.

Entrada del usuario	Respuesta del agente
	Gracias por llamar. Tus comentarios son importantes para nosotros. Tómate un momento para compartir tu opinión sobre el servicio que recibiste hoy respondiendo algunas preguntas breves. En una escala del 1 al 5, donde 1 es el nivel más bajo de satisfacción y 5 es el más alto, ¿qué tan conforme estás con el servicio que recibiste hoy?
5
	Excelente. Gracias por tus comentarios positivos.

Comentarios negativos

La respuesta del webhook de Check last feedback indica que el usuario final no proporcionó comentarios recientemente. El agente solicita la puntuación de comentarios del usuario, y este proporciona una puntuación que indica una experiencia negativa. Luego, el agente solicita comentarios cualitativos al usuario.

Entrada del usuario	Respuesta del agente
	Gracias por llamar. Tus comentarios son importantes para nosotros. Tómate un momento para compartir tu opinión sobre el servicio que recibiste hoy respondiendo algunas preguntas breves. En una escala del 1 al 5, donde 1 es el nivel más bajo de satisfacción y 5 es el más alto, ¿qué tan conforme estás con el servicio que recibiste hoy?
2
	Cuéntanos cómo podemos mejorar esta experiencia para ti.
Algunas de mis preguntas no se respondieron por completo.
	Gracias por tus comentarios. Lamentamos los inconvenientes que te ocasionamos y nos esforzaremos para brindarte una mejor experiencia la próxima vez.

Comentarios recientes

La respuesta del webhook de Check last feedback indica que el usuario final proporcionó comentarios recientemente, por lo que el agente no le pide más información.

Entrada del usuario	Respuesta del agente
	Gracias por comunicarse con nosotros.

Entrada no válida

La respuesta del webhook de Check last feedback indica que el usuario final no proporcionó comentarios recientemente. El agente solicita la puntuación de comentarios del usuario, y este proporciona entradas no válidas varias veces. El componente finaliza el flujo con un error.

Entrada del usuario	Respuesta del agente
	Gracias por llamar. Tus comentarios son importantes para nosotros. Tómate un momento para compartir tu opinión sobre el servicio que recibiste hoy respondiendo algunas preguntas breves. En una escala del 1 al 5, donde 1 es el nivel más bajo de satisfacción y 5 es el más alto, ¿qué tan conforme estás con el servicio que recibiste hoy?
-1
	Lo sentimos, no entendimos. Indícanos una puntuación de comentarios que sea 1, 2, 3, 4 o 5.
100
	Lo sentimos, no entendimos. Indícanos una puntuación de comentarios que sea 1, 2, 3, 4 o 5.
Agradable
	Lo sentimos, pero se superó la cantidad máxima de reintentos. Inténtalo de nuevo más tarde.

Convenciones de nombres

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

Función	Formato	Ejemplo
Flujo	[Nombre del componente]	Comentarios
Parámetro	[param_name]	feedback_score
Webhook	prebuilt_components_[component_name]:[webhook_action]	prebuilt_components_feedback:last_feedback_check

Parámetros de entrada

Los parámetros de entrada son los que se usan para configurar ciertos comportamientos del componente. Los parámetros se usarán en una o más condiciones dentro del flujo para determinar cómo debe comportarse el componente. Los parámetros con alcance de flujo se deben establecer en la página de inicio del componente, como se describe a continuación. Los parámetros con alcance de sesión se pueden establecer a través de un flujo de llamada o en la página de inicio de este componente.

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

Nombre del parámetro	Descripción	Formato de entrada
$session.params.phone_number	Es el número de teléfono local del usuario, que se usa para identificarlo en las solicitudes de la API. El número de teléfono no debe incluir el código de país.	cadena
$flow.minimum_feedback_score	Este parámetro indica el umbral para lo que se considera una puntuación de comentarios negativa o positiva. Una puntuación baja (igual o inferior al valor de este parámetro) indica una experiencia negativa, y una puntuación alta (superior al valor de este parámetro) indica una experiencia positiva. Si el usuario final proporciona una puntuación baja, se le solicitarán comentarios cualitativos para preguntarle cómo se puede mejorar la experiencia. El valor predeterminado para este parámetro es 3.	integer
$flow.feedback_max_retry_count	Este es un parámetro configurable que captura la cantidad máxima de reintentos que se proporcionan a un usuario. El valor asignado a este parámetro debe ser uno menos que la cantidad de intentos disponibles. El valor predeterminado es 2, lo que significa que el llamador tiene tres intentos para proporcionar la información solicitada.	integer

Para configurar los parámetros de entrada de este componente, expande las instrucciones.

1. Abre la consola de Dialogflow CX.
2. Elige tu proyecto de Google Cloud.
3. Selecciona el agente.
4. Selecciona la pestaña Build.
5. Haz clic en el componente importado en la sección Flujos.
6. Haz clic en la página de inicio en la sección Pages.
7. Haz clic en la ruta true en la página de inicio.
8. En la ventana Route, edita los valores de Parameter Presets según sea necesario.
9. Haz clic en Guardar.

Los parámetros de resultado

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

Nombre del parámetro	Descripción	Formato de salida
feedback_score	Este parámetro captura la puntuación de comentarios proporcionada por el usuario final. Los valores válidos son números enteros entre uno y cinco, inclusive.	integer
feedback_comment	Este parámetro captura los comentarios cualitativos proporcionados por el usuario final, si los hay.	cadena
transfer_reason	Este parámetro indica el motivo por el que se salió del flujo, si no se completó correctamente. El valor devuelto es uno de los siguientes: agent: El usuario final solicitó un agente humano en algún momento de la conversación. denial_of_information: El usuario final se negó a compartir la información que solicitó el componente. max_no_input: La conversación alcanzó la cantidad máxima de reintentos para los eventos sin entrada. Consulta los eventos integrados sin entrada. max_no_match: La conversación alcanzó la cantidad máxima de reintentos para los eventos de sin coincidencia. Consulta los eventos integrados de sin coincidencia. webhook_error: Se produjo un error de webhook. Consulta el evento integrado webhook.error. webhook_not_found: No se pudo acceder a una URL de webhook. Consulta el evento integrado webhook.error.not-found.	cadena

Configuración básica

Para configurar este componente prediseñado, haz lo siguiente:

1. Importa el componente compilado previamente.
2. Configura los webhooks flexibles proporcionados con tus servicios externos. Consulta la configuración de webhooks a continuación.

Configuración de webhook

Para usar este componente, deberás configurar los webhooks flexibles incluidos para recuperar la información necesaria de tus servicios externos.

Revisar los comentarios anteriores

El webhook de prebuilt_components_feedback:last_feedback_check se usa para que el componente verifique si un usuario proporcionó comentarios recientemente. El período durante el cual se considera reciente la opinión proporcionada anteriormente lo define el servicio externo integrado en este webhook, que puede configurar el propietario del servicio.

Parámetros de la solicitud a la API

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

Nombre del parámetro	Descripción	Formato de entrada
phone_number	Número de teléfono local del usuario, sin el código de país, que se usa para identificar al usuario.	integer

Parámetros de respuesta de la API

El componente usa los siguientes parámetros extraídos de la respuesta de la API.

Nombre del parámetro	Descripción	Formato de salida
last_feedback_time_elapsed	Indica si el usuario proporcionó comentarios recientemente. true indica que transcurrió un período desde que el usuario envió comentarios por última vez y que no se encontraron comentarios recientes. false indica que se proporcionaron comentarios recientemente y que no transcurrió el tiempo suficiente desde que el usuario proporcionó comentarios por última vez.	booleano

Para configurar el webhook Check last feedback para este componente, expándelo y sigue las instrucciones.

1. Abre la consola de Dialogflow CX.
2. Elige tu proyecto de Google Cloud.
3. Selecciona el agente.
4. Selecciona la pestaña Administrar.
5. Haz clic en Webhooks.
6. Selecciona el webhook prebuilt_components_feedback:last_feedback_check.
7. 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.
8. Revisa y actualiza el cuerpo de la solicitud para formar el formato de solicitud adecuado para tu webhook.
9. Revisa y actualiza la configuración de respuesta para extraer campos específicos de la respuesta de tu webhook. No modifiques los nombres de los parámetros, ya que el componente los necesita para acceder a los valores de los campos devueltos.
10. Revisa y actualiza la configuración de Authentication según sea necesario.
11. Haz clic en Guardar.

Actualizar comentarios

El webhook prebuilt_components_feedback:update_feedback se usa en el componente para enviar los comentarios recopilados a un servicio externo.

Parámetros de la solicitud a la API

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

Nombre del parámetro	Descripción	Formato de entrada
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
feedback_score	Este parámetro almacena la puntuación de comentarios proporcionada por el usuario final. Los valores esperados son números enteros entre uno y cinco, inclusive.	integer
feedback_comment	Este parámetro almacena el comentario de comentarios cualitativos proporcionado por el usuario final.	cadena

Para configurar el webhook de comentarios sobre actualizaciones para este componente, expande las instrucciones.

1. Abre la consola de Dialogflow CX.
2. Elige tu proyecto de Google Cloud.
3. Selecciona el agente.
4. Selecciona la pestaña Administrar.
5. Haz clic en Webhooks.
6. Selecciona el webhook prebuilt_components_feedback:update_feedback.
7. 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.
8. Revisa y actualiza el cuerpo de la solicitud para formar el formato de solicitud adecuado para tu webhook.
9. Revisa y actualiza la configuración de respuesta para extraer campos específicos de la respuesta de tu webhook. No modifiques los nombres de los parámetros, ya que el componente los necesita para acceder a los valores de los campos devueltos.
10. Revisa y actualiza la configuración de Authentication según sea necesario.
11. Haz clic en Guardar.

Completado

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