Crear un agente virtual

Para crear un chat bot en Dialogflow, ve a https://dialogflow.cloud.google.com/ e inicia sesión con una cuenta de Google. Una vez dentro, verás la siguiente pantalla. Desde aquí, haz clic en Crear Agente (Create Agent). Realiza las configuraciones pertinentes para tu agente virtual.

Una vez creado el chat bot, debes crear los Intents que irán controlando el flujo de la conversación.

Cada Intent tiene:

• User expressions: lo que el usuario tiene que escribir para que el chat bot sepa qué contestar (dialogflow se encarga de que detecte si se escriben frases parecidas, con mayúsculas, minúsculas, etc.)
• Text responses: las posibles respuestas del chat bot a las User Expressions definidas.
• Action and parameters: en este apartado, se escribirán las diferentes acciones que se realizarán en Athento. Las acciones disponibles son:
  
  • Seleccionar espacio: esta acción se encargará de elegir el espacio en el cual se creará el documento requerido (esquema: select-serie, select-serie{<name de la serie>})
  • Subir/actualizar binario principal: esta acción se encargará de actualizar el binario de un documento (esquema: update-principal-binary).
  • Rellenar campo: esta acción se encargará de rellenar un campo específico (esquema: set-metadata-type-value{<slug del metadata type>})

Además, tiene dos booleanos importantes: 

• Fulfillment: en este apartado del Intent, hay dos opciones. Se deberá marcar "Enable webhook call for this Intent" para todos los intents, tal y como se muestra en la siguiente foto:
• Set this intent as end of conversation: esta opción se deberá marcar cuando el Intent en el que se esté sea el final de un flujo de conversación (cuando se llegue a este punto final, se ejecutarán las acciones decididas de los anteriores intents en Athento).

Conectar DialogFlow con Athento

Desde la Administración avanzada, en API Key Permissions >>  API keys, debes crear la clave  que permitirá la conexión con Dialogflow.

Basta con darle un nombre. Una vez que guardes, aparacerá en pantalla la API key. Cópiala y ve a DialogFlow.

Desde Dialogflow, desde la sección "Fulfillment" , activa la opción "WEBHOOK" y rellena los siguientes campos:

• URL: escribe https://SUBDOMAIN.athento.com/dialogflow/api/fulfillment/execute/ donde SUBDOMAIN  es el nombre de tu instalación de Athento. 
• Añade un HEADER que tenga como clave  "authorization" y como valor "Api-Key <api key>" donde <api key> debe ser reemplazado por el valor de la clave que copiaste desde Athento.

Caso de uso de ejemplo

En este caso de uso, se define un chat bot el cual permite dos opciones: poner una queja o una reclamación. Este flujo creará un documento en el espacio correspondiente (espacio queja o espacio reclamación en función de lo que se elija).

Ejemplo de conversación:

Esto está configurado en Dialogflow de la siguiente manera:

Intent de bienvenida: no tiene acciones.

Intent selección espacio: en user expression, se utiliza una entity definida como Espacios guardando el name interno de los espacios a elegir (en este caso, queja y reclamación). Más información sobre las entitys en https://cloud.google.com/dialogflow/es/docs/entities-overview. También podría haberse pasado el name interno en la action directamente (en caso de solo referirse a un posible espacio) colocando entre llaves el name (ejemplo: select-serie{<name>}) 

Intent binario: se utiliza la acción de actualizar binario principal.

Intents metadata types: se utilizan acciones para rellenar los metadatos de descripción e email, siendo este último el final de la conversación. Si se utilizan entidades que no sean de tipo any (en este caso, sys.email) se deberá cambiar su "PARAMETER NAME" a la palabra "entities". Las que son any se pueden dejar tal y como están.