Tu primer agente
Este tutorial te lleva paso a paso por la creación, configuración y prueba de tu primer agente de voz IA. Al terminar, tendrás un agente en funcionamiento capaz de responder preguntas sobre tu negocio.
Lo que vamos a construir
Un agente de voz IA que:
- Saluda a quienes llaman de forma profesional
- Responde preguntas usando la información de tu negocio
- Proporciona horario comercial y datos de contacto
- Sabe cuándo transferir a una persona
Tiempo estimado: 15-20 minutos
Requisitos previos
Antes de empezar, asegúrate de tener:
- Tu cuenta de Hanc.AI creada (Configuración de la cuenta)
- Sesión iniciada en la plataforma
- Información básica de tu negocio lista
Paso 1: Crear un nuevo agente
Hay dos caminos para crear un agente: Basado en plantilla (recomendado para principiantes) o Desde cero.
Camino A: Basado en plantilla (recomendado)
Los Roles de plantilla proporcionan configuraciones predefinidas para empezar rápido. Hanc.AI ofrece 24 plantillas de rol listas para usar en dos categorías.
1.1 Ve a Agentes de voz IA
- Haz clic en "Agentes de voz IA" en la barra lateral izquierda
- Si es tu primera vez, un tour de incorporación te guiará por la interfaz paso a paso
1.2 Inicia la creación del agente
Haz clic en el botón "Crear agente de voz IA". Aparecerá un modal con dos opciones:
- Empezar desde cero — crea un agente en blanco que configuras manualmente (consulta el Camino B más abajo)
- Roles de plantilla — 24 plantillas de rol organizadas en dos categorías
1.3 Explora los Roles de plantilla
Los Roles de plantilla están organizados en dos categorías:
De cara al cliente (14 roles):
| Plantilla | Mejor para |
|---|---|
| Agente de ventas | Llamadas de ventas, presentación, cierre de tratos |
| Recepcionista | Saludo, derivación, consultas generales |
| Consultor | Llamadas de descubrimiento, evaluación de necesidades, asesoramiento |
| Agente de soporte | Atención al cliente, resolución de incidencias |
| Agente de pedidos | Toma de pedidos, seguimiento, modificaciones |
| Enrutador de llamadas | Dirigir a quienes llaman al departamento o persona correctos |
| Agente de recordatorios | Recordatorios de citas, seguimientos, notificaciones |
| Agente de feedback | Recogida de comentarios de clientes y encuestas |
| Agente de cobros | Recordatorios de pago, seguimientos de facturas |
| Calificador de leads | Calificación de leads entrantes, recogida de información de prospectos |
| Guía | Instrucciones paso a paso, incorporación, tutoriales |
| Promotor | Conciencia de producto, campañas, captación de interés inicial |
| Auto-respondedor | Respuesta automática de llamadas, entrega de información básica |
| Presentador | Presentaciones de productos o servicios, demos |
De cara al empleado (10 roles):
| Plantilla | Mejor para |
|---|---|
| Secretaría | Gestión de llamadas internas, agenda, toma de mensajes |
| Reclutador | Cribado de candidatos, agenda de entrevistas |
| Onboarder | Incorporación de nuevos empleados, orientación |
| Coordinador | Coordinación de equipos, agenda de reuniones |
| Controlador | Seguimiento de procesos, actualizaciones de estado, comprobaciones de cumplimiento |
| Helpdesk interno | Soporte TI, FAQ interno, asistencia a empleados |
| Recolector de datos | Recogida de datos estructurados de miembros del equipo |
| Agente de aprobaciones | Enrutar aprobaciones, recoger firmas |
| Agente de compras | Solicitudes de compra, consultas a proveedores |
| Despachador | Asignación de tareas, asignación de recursos, despacho |
Para este tutorial: Selecciona cualquier plantilla que coincida con tu caso de uso.
Los Roles de plantilla incluyen prompts predefinidos, mensajes de saludo y protocolos de conversación optimizados para roles específicos. Puedes personalizar todo tras la creación.
1.4 Ver los detalles de la plantilla
Haz clic en cualquier tarjeta de plantilla para abrir una vista de detalle que muestra:
- Descripción del rol y de lo que hace el agente
- Beneficios de usar esta plantilla
- Capacidades que tendrá el agente
- Selector de idioma — primero eliges un idioma (p. ej. inglés, alemán), luego una variante regional (p. ej. Estados Unidos, Austria, Suiza) y la voz correspondiente
- Descargar como documento Word — exporta las preguntas del Asistente de configuración como un archivo
.docxen el idioma elegido, para que tu equipo pueda rellenarlo sin conexión. Una vez rellenado, el mismo Asistente guiado puede leer el documento y autorellenar cada campo coincidente — consulta Rellenar mediante documento Word más abajo
Cada plantilla se entrega en 20 idiomas admitidos con prompts de calidad nativa y opciones de voz para cada uno. El rol Recepcionista en alemán usa una base real en alemán, no una traducción de una plantilla en inglés.
Rellenar mediante documento Word
Si prefieres recoger la información del negocio sin conexión (o repartir el trabajo entre compañeros), usa la vía del documento Word:
- Haz clic en Descargar como documento Word en el modal de detalle del rol — obtienes un
.docxque coincide con el rol e idioma elegidos. - Rellena tantas secciones como puedas. Salta lo que no sepas.
- Haz clic en Asistente guiado para abrir el asistente del mismo rol.
- Dentro del asistente, haz clic en Subir documento rellenado y selecciona el archivo. El asistente analiza tus respuestas y muestra una confirmación como "12 de 18 campos rellenados desde el documento."
- Revisa y ajusta los campos rellenados previamente, luego continúa por el asistente con normalidad.
Puedes volver a subir el documento en cualquier momento — cada subida actualiza los campos coincidentes con los últimos valores de tu archivo.
1.5 Elige cómo crear
Desde la vista de detalle de la plantilla, tienes dos botones:
- Desplegar agente — Crea el agente al instante con los valores por defecto de la plantilla. Puedes rellenar los datos de tu negocio más tarde con el Asistente de configuración. Es la forma más rápida de empezar.
- Asistente guiado — Abre un asistente paso a paso donde rellenas los datos de tu negocio (nombre de empresa, servicios, datos de contacto, etc.) antes de que se cree el agente.
Desplegar agente es genial si quieres explorar el agente primero y configurarlo después. Asistente guiado es mejor si tienes la información de tu negocio lista y quieres un agente más completo desde el inicio.
1.6 Asistente guiado (si lo eliges)
Si haces clic en Asistente guiado, un asistente te lleva paso a paso para rellenar los detalles específicos de tu negocio:
- Nombre de empresa, servicios, datos de contacto
- Horario comercial, ubicación, precios
- Instrucciones y políticas específicas
Importante: Puedes saltar campos o secciones enteras que no se apliquen a tu negocio. Sin embargo, al menos una sección debe estar completamente rellenada antes de continuar.
Tras completar el asistente, tu agente se crea con todos los detalles proporcionados.
Camino B: Desde cero
Para tener control total desde el inicio:
- Haz clic en "Crear agente de voz IA"
- Selecciona "Empezar desde cero"
- Se crea un agente en blanco con un prompt por defecto
- Configurarás todo manualmente en el siguiente paso
Paso 2: Tras la creación
Una vez creado tu agente, verás un banner de éxito con los siguientes pasos sugeridos. Un tour de incorporación te llevará por las pestañas de configuración del agente, destacando los ajustes y funciones clave.
Tu agente viene con dos variables de extracción por defecto — Correo electrónico y Teléfono — para que pueda recoger información de contacto de quienes llaman desde el primer momento. Puedes personalizar o eliminar estas en la pestaña Acciones.
El Asistente de configuración
Busca el icono de varita brillante junto al nombre de tu agente — este es el Asistente de configuración. Te ayuda a rellenar los detalles restantes sección por sección.
Cómo funciona el Asistente de configuración:
- El progreso se rastrea como "X/Y secciones completadas" para que siempre sepas qué queda
- Cada sección cubre un área distinta de la configuración: Configuración del agente, Perfil de empresa, Servicios, Especialistas, Ubicaciones y más
- Puedes saltar campos o secciones enteras que no necesites (mínimo 1 campo por sección)
- Avanza por las secciones en cualquier orden a tu propio ritmo
Si usaste Desplegar agente, el Asistente de configuración es tu principal forma de añadir detalles del negocio tras la creación. Si usaste Asistente guiado, algunas secciones ya estarán rellenadas.
Editar manualmente el prompt o los archivos de la Base de conocimiento desactiva el Asistente de configuración. Si esto ocurre, aparece un botón "Restablecer plantilla" que te permite recuperar la funcionalidad del asistente.
Pestañas del agente
La página de configuración de tu agente tiene estas pestañas:
| Pestaña | Qué contiene |
|---|---|
| Panel | Resumen de actividad del agente y estadísticas |
| Modelo | Prompt, voz, idioma y ajustes del modelo de IA |
| Base de conocimiento | Archivos e información que el agente usa para responder preguntas |
| Configuración | Ajustes de llamada, primer mensaje, límites de duración |
| Acciones | Acciones posteriores a la llamada (correo, SMS, webhooks) |
| Widgets | Configuración del widget web para integrar en tu sitio |
Paso 3: Configurar los ajustes del agente
3.1 Prompt
El prompt define la personalidad, el comportamiento y el flujo de conversación de tu agente.
Si usaste una plantilla, el prompt está rellenado previamente. Revísalo y personalízalo para tu negocio.
Si empezaste desde cero, escribe tu prompt:
## Rol
Eres un asistente virtual amable para [Nombre de tu negocio].
Ayudas a los clientes con preguntas sobre nuestros servicios, horarios y reserva de citas.
## Estilo de comunicación
- Habla con claridad y concisión
- Sé educado y profesional
- Mantén las respuestas cortas (1-3 oraciones cuando sea posible)
- Haz una pregunta a la vez
## Reglas importantes
1. Solo proporciona información que sepas con certeza
2. Si no sabes algo, di "No tengo esa información, pero puedo ponerte en contacto con nuestro equipo"
3. Nunca inventes precios, disponibilidad u otros detalles específicos
4. Transfiere a una persona si el cliente está molesto o tiene un problema complejo
Incluye siempre la instrucción: "Nunca inventes información." Esto evita que la IA invente detalles falsos sobre tu negocio.
3.2 Base de conocimiento
La base de conocimiento le da a tu agente los hechos que necesita para responder preguntas.
- Ve a la pestaña Base de conocimiento en los ajustes del agente
- Crea una nueva base de conocimiento o selecciona una existente
- Sube archivos con la información de tu negocio
Formatos de archivo aceptados: .txt, .md, .docx, .pdf, .html, .csv
Qué incluir:
- Servicios y precios
- Horario comercial y ubicación
- Preguntas frecuentes
- Políticas (cancelación, pago, etc.)
- Información del equipo
El agente sabe SOLO lo que está en la base de conocimiento. Si falta información, el agente no podrá responder esas preguntas. Añade todos los detalles importantes.
3.3 Voz
Elige una voz que coincida con tu marca:
- Selecciona el idioma
- Explora las voces disponibles (masculinas/femeninas, distintos estilos)
- Previsualiza las voces antes de seleccionar
3.4 Ajustes de llamada
Configura el comportamiento de la llamada:
- Primer mensaje (saludo cuando el agente atiende)
- Ajustes de idioma
- Límites de duración de llamada
3.5 Herramientas
Añade herramientas que el agente puede usar durante las llamadas:
- Google Calendar para agendar citas
- Integraciones API personalizadas
3.6 Acciones
Configura acciones posteriores a la llamada que se disparan tras finalizar la conversación:
- Enviar resúmenes por correo
- Enviar notificaciones SMS
- Disparar webhooks
- Hacer llamadas API
3.7 Widget
Configura el widget web para integrar en tu sitio:
- Apariencia y colores
- Posición y comportamiento
- Marca personalizada
3.8 Guardar la configuración
Haz clic en "Guardar" o "Actualizar" para guardar tu configuración.
Paso 4: Prueba tu agente
¡Ahora vamos a ver tu agente en acción!
4.1 Probar mediante el widget web
- Encuentra tu agente en la lista de Agentes de voz IA
- Haz clic en "Hablar con el agente" o en el botón de prueba/llamada
- Permite el acceso al micrófono en tu navegador
- Empieza a hablar
4.2 Probar mediante un número de teléfono
Si tienes un número de teléfono conectado:
- Asigna tu agente al número (en los ajustes de Números de teléfono)
- Llama al número desde cualquier teléfono
4.3 Escenarios de prueba
Prueba 1: Saludo básico
- Espera al saludo del agente
- Di: "Hola"
- El agente debe responder con naturalidad
Prueba 2: Horario comercial
- Di: "¿Cuál es vuestro horario?"
- El agente debe proporcionar tu horario desde la base de conocimiento
Prueba 3: Pregunta sobre servicios
- Di: "¿Qué servicios ofrecéis?"
- El agente debe enumerar tus servicios
Prueba 4: Pregunta sobre precios
- Di: "¿Cuánto cuesta [tu servicio]?"
- El agente debe dar el precio si está en la base de conocimiento
Prueba 5: Pregunta desconocida
- Di: "¿Cuál es el sentido de la vida?"
- El agente debe decir con cortesía que no tiene esa información
4.4 Termina la prueba
Haz clic en "Finalizar llamada" o cierra la ventana de prueba cuando termines.
Paso 5: Refina tu agente
A partir de las pruebas, puedes querer mejorar:
Problemas comunes y soluciones
| Problema | Solución |
|---|---|
| El agente habla demasiado | Añade al prompt: "Mantén las respuestas en 1-2 oraciones" |
| El agente es demasiado formal | Ajusta el tono del prompt: "Sé amable y conversacional" |
| El agente no sabe información | Comprueba que la base de conocimiento tiene la información |
| El agente inventa cosas | Refuerza en el prompt: "NUNCA inventes información" |
| Idioma incorrecto | Comprueba que el ajuste de idioma coincide con lo que necesitas |
| Voz demasiado rápida/lenta | Ajusta los ajustes de velocidad de voz |
Itera y mejora
- Probar → Identificar problemas → Ajustar prompt/ajustes → Probar de nuevo
- Añadir más FAQs a la base de conocimiento a partir de las llamadas de prueba
- Refinar el prompt en base a conversaciones reales
Paso 6: Despliega tu agente (opcional)
Una vez satisfecho con las pruebas, puedes desplegar tu agente:
Opción A: Conectar un número de teléfono
- Ve a Números de teléfono
- Compra un número o importa uno existente
- Asigna tu agente al número
- Las llamadas a ese número ahora las gestiona tu agente
Opción B: Añadir el widget al sitio web
- Ve a los ajustes de tu agente
- Encuentra la pestaña Widgets
- Copia el código de inserción
- Añádelo a tu sitio web
Lista de comprobación: ¿Está tu agente listo?
Antes de pasar a producción, verifica:
- El primer mensaje es claro y acogedor
- El prompt define el comportamiento correctamente
- La base de conocimiento tiene información precisa
- El agente gestiona bien las preguntas comunes
- El agente admite cuando no sabe algo
- La voz suena apropiada para tu marca
- El idioma está configurado correctamente
- Las llamadas de prueba dan buenos resultados
¿Qué sigue?
¡Felicidades! Has creado tu primer agente de voz IA.
Continúa aprendiendo:
- Agentes de voz IA en profundidad — Configuración avanzada de agentes
- Buenas prácticas de base de conocimiento — Crea mejores bases de conocimiento
- Números de teléfono — Conecta números de teléfono reales
- Roles de plantilla — Prompts y configuraciones listos para usar
- Campañas — Configura campañas de llamadas salientes
Solución de problemas
El agente no inicia la llamada de prueba
- Comprueba los permisos del micrófono en el navegador
- Prueba con otro navegador
- Asegúrate de tener una conexión a internet estable
El agente no responde
- Espera unos segundos — puede haber un retraso de procesamiento
- Habla claro y no demasiado rápido
- Comprueba que el agente no está pausado/inactivo
El agente da información incorrecta
- Verifica que el contenido de la base de conocimiento es correcto
- Comprueba que la base de conocimiento está conectada al agente
- Revisa el prompt en busca de instrucciones contradictorias
La calidad de voz es mala
- Comprueba tu conexión a internet
- Prueba con otra voz
- Reduce el ruido de fondo
¿Necesitas ayuda?
- Consulta la Guía de solución de problemas
- Contacta con support@hanc.ai