Skip to content

Configurar las herramientas de los asistentes ​

Acceso

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 ​

  1. Accede a ¡Hola! IA → Herramientas. La lista muestra Nombre, Tipo, Descripción, Asistentes vinculados y Listo para usar.
  2. Haz clic en Agregar herramienta. Se abre la ventana Agregar nueva herramienta.
  3. En Tipo de herramienta, elige el tipo.
  4. 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 ​

  1. Abre el asistente, en la pestaña Instrucciones o Flujo de interacciones.
  2. Escribe / y elige la herramienta.
  3. Explica en el texto cuándo y por qué debe usarse.
  4. Publica los cambios. Consulta Configurar un asistente inteligente.
Insertar la herramienta no basta

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.

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.

  1. En ¡Hola! IA → Herramientas, agrega una herramienta del tipo Ejecutar solicitud HTTP.
  2. Completa Nombre, Descripción y Aplicación HTTP (la integración HTTP instalada en ¡Hola! Store). Consulta Integración HTTP.
  3. En la barra de dirección, elige el Método (GET, POST, PUT, PATCH o DELETE) e informa la URL.
  4. 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.
  5. Haz clic en Probar para ver la Respuesta directamente en la pantalla, sin guardar.
  6. 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" }.
  7. 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.

Contenidos relacionados ​