Introducción

En el diseño de experiencias modernas de cliente, la capacidad de entender el lenguaje natural es fundamental. El componente DialogFlow permite conectar tus flujos de wolkvox con la potente plataforma de Google (ahora parte de Google Cloud Contact Center AI). Esta herramienta procesa lo que el usuario dice o escribe, identifica su intención y devuelve una respuesta inteligente.

Este componente actúa como un puente: envía el mensaje del usuario a Google y recibe la respuesta procesada para continuar el flujo. Se encuentra ubicado en la pestaña de componentes "Cognitivos" y está disponible para todos los tipos de routing points (Voz, Chat, etc.).

Configuración

La configuración dependerá de la versión de la API que estés utilizando en la consola de Google (V1 o V2).

Configuración para API V1 (Legacy)

Si tu agente utiliza la versión clásica, verás la siguiente estructura de campos:

• Token: En este campo debes pegar el token de acceso de cliente proporcionado por la consola de DialogFlow.
• Mensaje a enviar: Aquí debes ingresar la variable que contiene el texto que dijo o escribió el usuario (por ejemplo, la variable que capturó el ASR o el chat de entrada).
• Variables de Retorno:
  • Variable mensaje recibido: Por defecto verás $dialogflow_speech. Esta variable almacenará la respuesta textual que el bot de Google le contesta al cliente.
  • Variable para almacenar intención: Por defecto verás $dialogflow_intentName. Esta variable guarda el nombre de la "intención" detectada, útil para tomar decisiones lógicas en el flujo.
• Una vez completados los datos de autenticación y las variables, haz clic en el botón "Guardar Dialog Flow" en la parte inferior del panel para aplicar la integración.
• Después de este componente, tu flujo debería tener un componente de reproducción de audio (TTS) o envío de texto que utilice la variable $dialogflow_speech para que el usuario escuche o lea la respuesta que Google generó.

Configuración para API V2 (Estándar/Enterprise)

Esta es la versión más robusta y recomendada. Los campos requeridos son:

• Project-id: Ingresa el identificador único de tu proyecto de Google Cloud (Project ID) donde está alojado el agente.
• Campo de Autenticación (JSON key file): Debajo del ID del proyecto, verás un campo (enmascarado como contraseña) donde debes colocar el contenido de la llave JSON (Service Account Key) generada en Google Cloud.
• Mensaje a enviar: Ingresa aquí la variable con el input del usuario que deseas analizar.
• Variables de Retorno (Predefinidas):
  • Variable mensaje recibido: Se mantiene como $dialogflow_speech. No se puede cambiar.
  • Variable para almacenar intención: Se mantiene como $dialogflow_intentName. No se puede cambiar.
• Una vez completados los datos de autenticación y las variables, haz clic en el botón "Guardar Dialog Flow" en la parte inferior del panel para aplicar la integración.
• Después de este componente, tu flujo debería tener un componente de reproducción de audio (TTS) o envío de texto que utilice la variable $dialogflow_speech para que el usuario escuche o lea la respuesta que Google generó.