Configurar las herramientas de los asistentes
Ruta: Menú lateral → ¡Hola! IA → Herramientas
Visión general
Las herramientas son las acciones que un asistente inteligente puede ejecutar durante la conversación, como transferir la atención, cerrarla, aplicar una etiqueta o consultar un sistema externo. Registras cada herramienta una vez, con una descripción de cuándo usarla, y después la incluyes en las instrucciones o en el flujo de interacciones de cualquier asistente. Así, el asistente actúa sin depender de una persona para cada tarea.
Requisitos previos
- ¡Hola! IA contratado y permiso Entorno de IA en el grupo de permisos. Consulta Crear y configurar un grupo de permisos.
- Los ítems que usa la herramienta ya registrados: etiquetas, departamentos, usuarios, flujos de comunicación, agendas con preagendamientos o la aplicación HTTP.
Paso a paso
Registrar una herramienta
- Accede a ¡Hola! IA → Herramientas. La lista muestra Nombre, Tipo, Descripción, Asistentes vinculados y Listo para usar.
- Haz clic en Agregar herramienta. Se abre la ventana Agregar nueva herramienta.
- En Tipo de herramienta, elige el tipo.
- Completa la Configuración del tipo (consulta la sección siguiente) y guarda.
La columna Listo para usar muestra Listo o Necesita revisión. Una herramienta que necesita revisión tiene la configuración incompleta, y los asistentes que la usan pueden fallar.
Usar la herramienta en un asistente
- Abre el asistente, en la pestaña Instrucciones o Flujo de interacciones.
- Escribe / y elige la herramienta.
- Explica en el texto cuándo y por qué debe usarse.
- Publica los cambios. Consulta Configurar un asistente inteligente.
El asistente solo usa la herramienta cuando entiende el contexto. Escribe, por ejemplo: "Si el cliente pide la segunda copia de la factura, transfiere la atención al departamento Finanzas." También completa bien la Descripción de la herramienta, porque ayuda a la IA a decidir cuándo usarla.
Tipos de herramienta
Agregar etiqueta
Aplica una etiqueta a la atención, para clasificar el asunto (por ejemplo, "Soporte" o "Finanzas").
- Etiqueta: elige una etiqueta de la empresa o crea una nueva. No se pueden usar etiquetas personales.
- Descripción: cuándo aplicar la etiqueta.
Transferir chat
Pasa la atención a otro destino cuando el asistente no puede resolverla.
- Transferir a: elige Sector, Agente o Asistente.
- Elige el departamento, el agente o el asistente de destino.
- Enviar mensaje al transferir: lo que el asistente le dice al cliente al transferir.
- Descripción: cuándo transferir.
Finalizar chat
Permite que el asistente cierre la atención cuando la demanda se resolvió, sin intervención humana.
- Nombre y Descripción: identifican la herramienta e indican cuándo usarla.
- Enviar mensaje para finalizar chat: lo que el asistente le dice al cliente al cerrar.
Ejecutar flujo de comunicación
Entrega la conversación a un flujo de comunicación ya armado, que sigue las etapas y reglas configuradas.
- Flujo de comunicación: el flujo que se ejecutará.
- Descripción: cuándo ejecutarlo. Consulta Qué es el flujo de comunicación.
Enviar archivo
Envía al cliente un archivo que registraste, como una guía, un catálogo, un contrato o un código QR.
- Nombre y Descripción: identifican el archivo e indican cuándo enviarlo.
- Seleccionar archivo: elige o arrastra los archivos. Acepta .pdf, .png, .jpg, .jpeg y .gif, con hasta 10 MB por archivo.
Agendar horario
Permite que el cliente reserve un horario en ¡Hola! Agenda conversando con el asistente.
- Agenda del usuario: la agenda donde se registrará la cita.
- Pre-agendamientos disponibles: los servicios que el cliente puede elegir. Solo aparecen los preagendamientos de la agenda elegida.
- Mensaje para solicitar el motivo del agendamiento: el texto que le pide al cliente el servicio. El valor predeterminado es "Por favor, selecione o serviço desejado".
Antes, registra los preagendamientos. Consulta Configurar el agendamiento automático por WhatsApp.
Ejecutar solicitud HTTP
Conecta el asistente con un sistema externo por API, para consultar o enviar datos, como validar una dirección, buscar coordenadas o generar un token.
- En ¡Hola! IA → Herramientas, agrega una herramienta del tipo Ejecutar solicitud HTTP.
- Completa Nombre, Descripción y Aplicación HTTP (la integración HTTP instalada en ¡Hola! Store). Consulta Integración HTTP.
- En la barra de dirección, elige el Método (GET, POST, PUT, PATCH o DELETE) e informa la URL.
- Completa, si es necesario, Encabezados y Parámetros (pares de Nombre y Valor) y el Cuerpo, en formato JSON. En esos campos, usa variables en el formato
para los datos que cambian en cada atención. - Haz clic en Probar para ver la Respuesta directamente en la pantalla, sin guardar.
- En Mapeo de la respuesta, elige qué partes de la respuesta debe guardar el asistente. Informa el Origen (la ruta del dato en la respuesta) y Guardar como (el nombre de la variable). Usa Mapear todos para guardar todo. Ejemplo de mapeo:
{ "nomeUsuario": "data.user.name" }. - Haz clic en Guardar cambios.
Los valores sensibles, como las claves de API, quedan ocultos en los campos de valor.
Resultado esperado
La herramienta aparece en la lista con Listo en Listo para usar y puede insertarse en cualquier asistente con la barra /. Al abrir una herramienta, la sección Asistentes vinculados muestra qué asistentes la usan.
Reglas y comportamientos
- Asistentes vinculados: consulta esta sección antes de modificar o eliminar una herramienta, para saber qué asistentes se verán afectados. Una herramienta sin vínculo aparece como no utilizada.
- Eliminar: usa el menú Acciones de la herramienta. Una herramienta eliminada deja de ser usada por los asistentes.
- Auditoría: el botón Auditar de la pantalla de herramientas muestra los cambios realizados.
- Importación de asistentes: al importar un asistente en otra instalación, las herramientas no vienen con él. Regístralas de nuevo.
Problemas comunes
- Aparece "Necesita revisión": abre la herramienta y completa los campos obligatorios.
- El asistente no usa la herramienta: comprueba que esté citada en la instrucción o en el flujo, con el contexto de cuándo usarla, y que el asistente se haya publicado.
- La solicitud HTTP no funciona: revisa la Aplicación HTTP, la URL y las variables, y usa Probar para ver la respuesta.
Buenas prácticas
- Dale un nombre y una descripción claros a cada herramienta.
- Usa una herramienta por acción. Evita herramientas que hacen varias cosas.
- Antes de eliminar, revisa los Asistentes vinculados.
- Prueba la herramienta en la Previsualización del asistente antes de publicar.