# Gestión de intenciones
## ¿Qué es una intención?
Definición de Intent de Dialogflow
> Una intención categoriza la intención del usuario final para un turno de conversación. Para cada agente, define muchas intenciones, donde sus intenciones combinadas pueden manejar una conversación completa. Cuando un usuario final escribe o dice algo, lo que se denomina *expresión de usuario final* , Dialogflow hace coincidir la expresión del usuario final con la mejor intención de su agente. Hacer coincidir una intención también se conoce como *clasificación de intenciones* .
Una intención básica contiene lo siguiente:
* **Frases de formación** : estas son frases de ejemplo de lo que podrían decir los usuarios finales. Cuando una expresión de usuario final se parece a una de estas frases, Dialogflow coincide con la intención.
* **Acción** : puede definir una acción para cada intento. Cuando una intención coincide, Dialogflow proporciona la acción a su sistema, y puede usar la acción para activar ciertas acciones definidas en su sistema.
* **Parámetros** : cuando una intención coincide en tiempo de ejecución, Dialogflow proporciona los valores extraídos de la expresión del usuario final como *parámetros* . Cada parámetro tiene un tipo, llamado [tipo de entidad](https://cloud.google.com/dialogflow/docs/entities-overview) , que dicta exactamente cómo se extraen los datos.
* **Respuestas** : usted define **respuestas de** texto, de voz o visuales para devolverlas al usuario final. Estos pueden proporcionar respuestas al usuario final, pedirle al usuario final más información o terminar la conversación.
Una intención más compleja también puede contener lo siguiente:
* **Contextos** : los contextos de Dialogflow son similares al contexto del lenguaje natural. Si una persona te dice "son de color naranja", necesitas contexto para entender a qué se refiere la persona. De manera similar, para que Dialogflow maneje una expresión de usuario final como esa, debe contar con contexto para que coincida correctamente con una intención.
* **Eventos** : con los eventos, puede invocar una intención basada en algo que ha sucedido, en lugar de lo que comunica un usuario final.
{% hint style="info" %}
Las intenciones se pueden activar en función del país y el idioma de sus contactos. Si su contacto tiene un valor de país o idioma presente en sus detalles de contacto, los intentos pueden ser activados en base a los diferentes valores de país e idioma.
{% endhint %}
## Intentos de visualización
**Paso 1: Inicie sesión en Dialogflow**\
Navegue a la consola de [Dialogflow](https://dialogflow.cloud.google.com/) e inicie sesión con sus credenciales de usuario.
**Paso 2: Navegue a Intents**\
Seleccione el agente que le gustaría configurar y seleccione Intents en el menú de navegación lateral
{% hint style="success" %}
Todas las intenciones predeterminadas y las creadas se enumerarán en esta vista.
{% endhint %}
## Intenciones predeterminadas
Cuando creas un agente, Dialogflow creará dos intenciones predeterminadas para ti
* **Intención de bienvenida predeterminada** : esta intención coincide cuando el contacto comienza una conversación con la plataforma. Esta intención debe devolver una respuesta que le permita al usuario final saber qué hace su agente o qué puede decir para comenzar una conversación.
* **Intención alternativa predeterminada** : esta intención coincide cuando el agente no puede hacer coincidir la expresión del usuario final con ninguna otra intención.
### Intención de bienvenida predeterminada
Aprenda [más](https://cloud.google.com/dialogflow/es/docs/intents-default#welcome) sobre la definición de Dialogflow de Intención de Bienvenida por defecto!
Como pueden ver, la intención de bienvenida por defecto tiene un pre-requisito de evento de bienvenida y frases de saludo. Cuando un contacto te manda un mensaje por primera vez, esta intención será igualada de acuerdo a lo especificado.
Consulte el siguiente ejemplo:
{% hint style="info" %}
**Sugerencia:** Quisiéramos sugerir que se incluyan respuestas que informen al contacto de que está interactuando con un chatbot. De esta manera, la expectativa de los contactos para la solución se puede gestionar bien.
{% endhint %}
### Intención de retroceso por defecto
{% hint style="info" %}
Aprende [más](https://cloud.google.com/dialogflow/es/docs/intents-default#welcome) sobre la definición de la intención de retirada por defecto de Dialogflow!
{% endhint %}
Cuando el mensaje o evento entrante no coincida con ninguno de los intentos existentes, se hará coincidir con un intento alternativo.
{% hint style="info" %}
Sugerencia: Cuando el agente no pueda responder a cambio, debe ofrecerse a entregar a un agente vivo para ayudar con el asunto del contacto.
{% endhint %}
## Creando una intención
Puede crear nuevas intenciones si desea crear procesos automatizados para casos de uso específicos. Con Parámetros y Eventos, se pueden crear intenciones para adaptarse a múltiples casos de uso.
Para ayudarle a comprender mejor, la siguiente guía se basará en un caso de uso específico como se describe a continuación:
> La compañía XYZ a menudo recibe consultas sobre el estado de los pedidos desde el webchat del sitio web. Al revisar las conversaciones, detectaron un patrón común en el que sus agentes piden el ID del cliente para comprobar más a fondo el problema o resolver la consulta. Una vez que obtuvieron el ID de cliente del cliente, actualizarán el campo personalizado y lo agregarán como una etiqueta. Según el escenario anterior, el chatbot puede realizar el proceso de obtención de la identificación del cliente. Una vez que se obtiene la identificación del cliente, el contacto se entregará a un agente humano para obtener más ayuda.
Vamos a dividirlo en pasos más simples:
1. Cree una intención para solicitar la identificación del cliente
2. Cree una intención para obtener la identificación del cliente
3. Guardar el ID de cliente como un campo personalizado en Bony.chat
4. Agregar una etiqueta
5. Pasar la conversación a un agente humano
6. Notificar al agente humano
7. Deshabilitando el bot
#### Gastos esperados
### Creando una intención básica
**Paso 1: Crear intención**\
Navegue a la consola de [Dialogflow](https://dialogflow.cloud.google.com/) y presione **Intenciones** en el menú de navegación lateral. presione el ➕ o **CREAR INTENCIÓN** desde la parte superior del módulo.
**Paso 2: Ponle un nombre a tu intención**\
Ingresa un nombre para tu intención. El nombre de su intención debe representar las expresiones del usuario final que reconoce. Para este escenario, nombraremos es `order_status_enquiry`
**Paso 3: Incluya frases de capacitación**\
Según el escenario anterior, deberíamos incluir frases de formación que soliciten específicamente el estado del pedido. Comience escribiendo en los marcadores de posición en **la** sección **Frases de capacitación** . Puede incluir varias frases para adaptarse a diferentes tipos de frases.
Por ejemplo,
> *Donde esta mi orden*\
> *podrías ayudarme a revisar mi pedido por favor* \
> *Cuál es el estado de mi orden*
**Paso 4: Crear una respuesta de intención**\
Para esta intención, la respuesta debe solicitar al contacto que su ID de cliente se use para la siguiente intención.
Desplácese hacia abajo hasta la sección **Respuestas** y escriba la respuesta. Puede agregar una **respuesta de texto** o una **carga útil personalizada** . Para este escenario, la **respuesta de texto** cumplirá el propósito.
{% hint style="info" %}
**Consejos** :
* Puede enviar varias respuestas a la vez para una mejor legibilidad.
* Puede agregar algunas variantes de respuesta y se aleatorizará cuando se envíe a un contacto.
{% endhint %}
La respuesta que crearemos para esta intención es:
> Le pido disculpas de antemano si su pedido se está demorando demasiado. ¿Puedo tener su identificación de cliente por favor?
{% hint style="info" %}
Para obtener más información sobre las plantillas de respuesta, haga clic [aquí](https://docs.bony.chat/integraciones/dialogflow/broken-reference) .
{% endhint %}
### Creando una entidad
Antes de que podamos guardar el valor como campo personalizado, necesitaremos crear una entidad para detectar el valor de los mensajes entrantes.
Según el escenario anterior, nombraremos esta entidad como y se utilizará para almacenar la identificación del cliente para un cliente.`customerId`
**Paso 1: Crear una entidad**\
Navegue hasta el módulo Entidades. Presione en el ➕ o **CREAR ENTIDAD.**
**Paso 2: Nombre de la entidad**\
Para este ejemplo, lo llamaremos customer\_id.
**Paso 3: Ingrese los valores posibles**\
La entidad debe aceptar una cadena con 5 enteros de longitud. Se aplicará una expresión regular para validar el valor.
Para este ejemplo, el valor será que acepte cualquier cadena de 5 dígitos.`(\d){5}`
{% hint style="info" %}
Para obtener más información sobre las expresiones regulares, haga clic [aquí.](https://github.com/google/re2/wiki/Syntax)
{% endhint %}
{% hint style="info" %}
¡Lea [aquí](https://cloud.google.com/dialogflow/es/docs/entities-overview) para obtener más información sobre las entidades!
{% endhint %}
### Creando una intención con parámetros
**Paso 1: Crear intención de seguimiento**\
Navegue a la consola de [Dialogflow](https://dialogflow.cloud.google.com/) y presione **Intenciones** en el menú de navegación lateral. Busque la intención anterior creada y presione **Agregar intención de seguimiento.**
{% hint style="warning" %}
En su lugar, se usa una intención de seguimiento porque esta intención deberá activarse después de la intención especificada.
{% endhint %}
De forma predeterminada, el contexto y la acción se completarán de forma predeterminada para que la intención funcione en secuencia.
**Paso 2: Incluya frases de capacitación**\
Lo más probable es que las frases que se incluyan en esta intención sean frases que contengan el ID de cliente. Podemos ingresar una frase y resaltar el texto que probablemente sea la identificación del cliente. Seleccione la entidad creada anteriormente y anote el texto con ella.
De forma predeterminada, se creará un parámetro cuando anotes un texto con una entidad, así que almacena los valores.
{% hint style="info" %}
¡Lea [aquí](https://cloud.google.com/dialogflow/docs/intents-training-phrases#annotation) para obtener más información sobre cómo anotar frases de entrenamiento!
{% endhint %}
**Paso 3: Crear una respuesta de intención**\
Para esta intención, la respuesta debe informar al contacto que se ha recibido la identificación del cliente y un agente humano se hará cargo de la conversación y resolverá el problema.
Desplácese hacia abajo hasta la sección **Respuestas** y escriba la respuesta. Agregue una **respuesta de texto.**
La respuesta que crearemos para esta intención es:
> Gracias por proporcionar su ID de cliente. Su problema está siendo asignado a nuestros agentes humanos.
### Guardando valor como campo personalizado
Cuando el contacto responde con su ID de cliente, el valor se puede guardar como un campo personalizado en la plataforma **BonyChat**
{% hint style="info" %}
Para guardar el valor en un campo personalizado, asegúrese de que el campo personalizado se cree en la plataforma Bonychat
{% endhint %}
Para guardar el valor, añada un parámetro `RB_FIELD_{custom field's name}`. En este caso, el parámetro será `RB_FIELD_customerid` y establecerá la entidad`$customer_id` como valor.
### Agregar una etiqueta
Agregar un parámetro `RB_ADDTAGS` y establecer la entidad `$customer_id` como valor
### Pasando la conversación
Ahora, queremos pasar la conversación a un agente humano. Esto se puede lograr con otro parámetro y establecer el correo electrónico del usuario como valor`RB_USER_ASSIGN`
### Deshabilitando el bot
Los parámetros se ejecutarán en secuencia. Por último, deshabilitaremos la respuesta del bot para este contacto porque no queremos que se active ninguna intención cuando el contacto sea manejado por un agente humano.
Para hacerlo, agregaremos otro parámetro`RB_BOTSTATUS` y lo estableceremos `FALSE` como valor.
{% hint style="warning" %}
Cuando un bot está deshabilitado, los contactos ya no pueden recibir mensajes del bot hasta que el estado del bot esté habilitado. El estado del bot se puede habilitar manualmente a través de la consola de mensajería o mediante la automatización.
{% endhint %}
### Manejo de la ubicación
Cuando se recibe una localización de un contacto, se enviará un evento de tipo LOCATION a Dialogflow. Puede añadir LOCATION a los eventos para activar los respectivos disparadores.
.png?alt=media\&token=48bd764e-42d1-4746-ace9-e3ed309ae9ee)
Consulte los otros parámetros disponibles para usar en Dialogflow:
{% content-ref url="gestion-de-intenciones/parametros" %}
[parametros](https://docs.bony.chat/integraciones/dialogflow/gestion-de-intenciones/parametros)
{% endcontent-ref %}
## Testeando una intención
Si necesita probar la intención, use el panel de prueba ubicado en el lado derecho de la consola de Dialogflow.
## Eliminar una intención
Desde la lista de intenciones, coloque el cursor sobre la intención que desea eliminar. Presione el ícono de la papelera de la intención.
## Solucionar problemas
### Configuración de mensaje ausente
Si el chatbot no funciona como se esperaba, verifique la [Configuración de mensaje ausente](https://docs.bony.chat/integraciones/dialogflow/broken-reference) en la configuración de su Espacio y asegúrese de tenerlo apagado. Habilitar la configuración de mensaje ausente no permitirá respuestas de bot.
{% hint style="warning" %}
¿Tienes problemas con Dialogflow? ¡Contáctanos [aquí!](https://wa.me/5219992446805)
{% endhint %}