Tu primer agente

Este tutorial te acompaña en la creación, configuración y prueba de tu primer agente de voz de IA. Al terminar, tendrás un agente funcional capaz de responder preguntas sobre tu negocio.

Lo que construiremos

Un agente de voz que:

• Saluda a los llamantes de forma profesional
• Responde preguntas usando la información de tu negocio
• Proporciona el horario de atención y los datos de contacto
• Sabe cuándo transferir a un humano

Tiempo estimado: 15-20 minutos

---

Requisitos previos

Antes de empezar, asegúrate de tener:

• Creada tu cuenta de Hanc.AI (Configuración de la cuenta)
• Iniciada sesión en la plataforma
• Información básica sobre tu negocio a mano

---

Paso 1: Crea 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 ofrecen configuraciones preconstruidas que te permiten empezar rápido. Hanc.AI ofrece 24 plantillas de rol listas para usar en dos categorías.

1.1 Ve a Agentes de voz

1. Haz clic en "Agentes de voz" en la barra lateral izquierda
2. Si es tu primera vez, un recorrido de bienvenida 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". Aparece una ventana modal con dos opciones:

• Empezar desde cero — crea un agente en blanco que configuras manualmente (ver el Camino B más abajo)
• Roles de plantilla — 24 plantillas de rol organizadas en dos categorías

¿Prefieres describirlo en palabras sencillas?

También puedes construir un agente con Hanc Studio — describe lo que necesitas y ensambla un agente listo (rol, flujo de trabajo, base de conocimiento e integraciones) por ti.

1.3 Explora los Roles de plantilla

Los Roles de plantilla se organizan en dos categorías:

Orientados al cliente (14 roles):

Plantilla	Ideal para
Agente de ventas	Llamadas de ventas, presentación, cierre de acuerdos
Recepcionista	Saludar a los llamantes, enrutar, consultas generales
Consultor	Llamadas de descubrimiento, evaluación de necesidades, asesoramiento
Agente de soporte	Soporte al cliente, resolución de incidencias
Agente de pedidos	Realización de pedidos, seguimiento, modificaciones
Enrutador de llamadas	Dirigir a los llamantes al departamento o persona correctos
Agente de recordatorios	Recordatorios de citas, seguimientos, notificaciones
Agente de opiniones	Recopilar opiniones y encuestas de clientes
Agente de cobros	Recordatorios de pago, seguimiento de facturas
Cualificador de leads	Cualificar leads entrantes, recopilar información del cliente potencial
Guía	Instrucciones paso a paso, incorporación, recorridos
Promotor	Difusión de productos, campañas, captación de la parte alta del embudo
Contestador automático	Atención automática de llamadas, entrega de información básica
Presentador	Presentaciones de productos o servicios, demos

Orientados al empleado (10 roles):

Plantilla	Ideal para
Secretario	Gestión de llamadas internas, programación, toma de mensajes
Reclutador	Cribado de candidatos, programación de entrevistas
Incorporador	Incorporación y orientación de nuevos empleados
Coordinador	Coordinación de equipos, programación de reuniones
Controlador	Supervisión de procesos, actualizaciones de estado, comprobaciones de cumplimiento
Helpdesk interno	Soporte de TI, preguntas frecuentes internas, asistencia a empleados
Recopilador de datos	Recogida de datos estructurados de los miembros del equipo
Agente de aprobaciones	Enrutamiento de aprobaciones, recogida de autorizaciones
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 se ajuste a tu caso de uso.

¿Por qué usar un Rol de plantilla?

Los Roles de plantilla incluyen prompts preescritos, mensajes de saludo y protocolos de conversación optimizados para roles específicos. Puedes personalizarlo todo después de la creación.

1.4 Consulta 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
• Ventajas de usar esta plantilla
• Capacidades que tendrá el agente
• Selector de idioma — primero eliges un idioma (p. ej. English, Deutsch), luego una variante regional (p. ej. Estados Unidos, Austria, Suiza) y la voz correspondiente
• Descargar como documento de Word — exporta las preguntas del Asistente de configuración como un archivo .docx en el idioma que elegiste, para que tu equipo pueda rellenarlo sin conexión. Una vez rellenado, el mismo asistente de Configuración guiada puede volver a leer el documento y autocompletar cada campo coincidente — ver Rellenar mediante documento de Word más abajo

Cobertura de idiomas

Cada plantilla se ofrece en 25 idiomas admitidos con prompts de calidad nativa y opciones de voz para cada uno. El rol de Recepcionista en alemán usa una base real en alemán, no una traducción de una plantilla en inglés.

Rellenar mediante documento de Word

Si prefieres recopilar la información del negocio sin conexión (o repartir el trabajo entre compañeros), usa el camino del documento de Word:

1. Haz clic en Descargar como documento de Word en la ventana de detalle del rol — obtienes un .docx que coincide con el rol y el idioma que elegiste.
2. Rellena tantas secciones como tengas respuestas. Omite lo que no sepas.
3. Haz clic en Configuración guiada para abrir el asistente del mismo rol.
4. 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."
5. Revisa y ajusta los campos precompletados, 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 crearlo

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 usando el Asistente de configuración. Es la forma más rápida de empezar.
• Configuración guiada — Abre un asistente paso a paso donde rellenas los datos de tu negocio (nombre de la empresa, servicios, información de contacto, etc.) antes de crear el agente.

¿Qué botón debería elegir?

Desplegar agente es ideal si quieres explorar el agente primero y configurarlo más tarde. Configuración guiada es mejor si tienes la información de tu negocio a mano y quieres un agente más completo desde el principio.

1.6 Configuración guiada (si la eliges)

Si has hecho clic en Configuración guiada, un asistente te acompaña a rellenar los detalles específicos de tu negocio:

• Nombre de la empresa, servicios, datos de contacto
• Horario de atención, ubicación, precios
• Instrucciones y políticas específicas

Importante: Puedes omitir campos o secciones enteras que no apliquen a tu negocio. Sin embargo, al menos una sección debe estar completamente rellenada antes de que puedas continuar.

Tras completar el asistente, tu agente se crea con todos los detalles que has proporcionado.

Camino B: Desde cero

Para tener control total desde el principio:

1. Haz clic en "Crear agente de voz"
2. Selecciona "Empezar desde cero"
3. Se crea un agente en blanco con un prompt por defecto
4. Lo configurarás todo manualmente en el siguiente paso

---

Paso 2: Después de la creación

Una vez creado tu agente, verás un banner de éxito con los siguientes pasos sugeridos. Un recorrido de bienvenida te guiará por las pestañas de configuración del agente, resaltando 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 recopilar la información de contacto de los llamantes desde el primer momento. Puedes personalizarlas o eliminarlas en la pestaña Acciones.

El Asistente de configuración

Busca el icono de varita brillante junto al nombre de tu agente — 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 registra 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 la empresa, Servicios, Especialistas, Ubicaciones y más
• Puedes omitir campos o secciones enteras que no necesites (mínimo 1 campo por sección)
• Avanza por las secciones en el orden que quieras y a tu propio ritmo

información

Si usaste Desplegar agente, el Asistente de configuración es tu forma principal de añadir los datos del negocio tras la creación. Si usaste Configuración guiada, algunas secciones ya estarán rellenadas.

Importante

Editar manualmente el prompt o los archivos de la base de conocimiento deshabilita el Asistente de configuración. Si esto ocurre, aparece un botón "Restablecer a 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
Dashboard	Vista general de la actividad y estadísticas del agente
Modelo	Ajustes de prompt, voz, idioma y modelo de IA
Base de conocimiento	Archivos e información que el agente usa para responder preguntas
Ajustes	Ajustes de llamada, primer mensaje, límites de duración de llamada
Acciones	Acciones posteriores a la llamada (correo, SMS, webhooks)
Widgets	Configuración del widget web para incrustar en tu sitio web

---

Paso 3: Configura 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 viene precompletado. 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, horario 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 frases cuando sea posible)
- Haz una pregunta cada vez

## Reglas importantes
1. Proporciona solo información que sepas con certeza
2. Si no sabes algo, di "No dispongo de esa información, pero puedo ponerte en contacto con nuestro equipo"
3. Nunca inventes precios, disponibilidad u otros detalles concretos
4. Transfiere a un humano si el cliente está molesto o tiene un problema complejo

Regla crítica

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 datos que necesita para responder preguntas.

1. Ve a la pestaña Base de conocimiento en los ajustes del agente
2. Crea una nueva base de conocimiento o selecciona una existente
3. 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 de atención y ubicación
• Preguntas frecuentes
• Políticas (cancelación, pago, etc.)
• Información del equipo

Importante

El agente conoce ÚNICAMENTE lo que hay en la base de conocimiento. Si falta información, el agente no puede responder a esas preguntas. Añade todos los detalles importantes.

3.3 Voz

Elige una voz que se ajuste a tu marca:

• Selecciona el idioma
• Explora las voces disponibles (masculina/femenina, distintos estilos)
• Escucha una vista previa de 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 la llamada

3.5 Herramientas

Añade herramientas que el agente puede usar durante las llamadas:

• Google Calendar para la programación de citas
• Integraciones de API personalizadas

3.6 Acciones

Configura acciones posteriores a la llamada que se disparan cuando termina una conversación:

• Enviar resúmenes por correo
• Enviar notificaciones por SMS
• Disparar webhooks
• Realizar llamadas a la API

3.7 Widget

Configura el widget web para incrustarlo en tu sitio web:

• Apariencia y colores
• Posición y comportamiento
• Personalización de marca

3.8 Guardar los ajustes

Haz clic en "Guardar" o "Actualizar" para guardar tu configuración.

---

Paso 4: Prueba tu agente

¡Ahora veamos tu agente en acción!

4.1 Prueba mediante el widget web

1. Busca tu agente en la lista de Agentes de voz
2. Haz clic en "Hablar con el agente" o en el botón de prueba/llamada
3. Permite el acceso al micrófono en tu navegador
4. Empieza a hablar

4.2 Prueba mediante número de teléfono

Si tienes un número de teléfono conectado:

1. Asigna tu agente al número (en los ajustes de Números de teléfono)
2. Llama al número desde cualquier teléfono

4.3 Escenarios de prueba

Prueba 1: Saludo básico

• Espera el saludo del agente
• Di: "Hola"
• El agente debería responder con naturalidad

Prueba 2: Horario de atención

• Di: "¿Cuál es su horario de apertura?"
• El agente debería proporcionar tu horario desde la base de conocimiento

Prueba 3: Pregunta sobre servicios

• Di: "¿Qué servicios ofrecen?"
• El agente debería enumerar tus servicios

Prueba 4: Pregunta sobre precios

• Di: "¿Cuánto cuesta [tu servicio]?"
• El agente debería 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 debería decir educadamente que no dispone de esa información

4.4 Finaliza la prueba

Haz clic en "Finalizar llamada" o cierra la ventana de prueba cuando termines.

---

Paso 5: Refina tu agente

Según las pruebas, quizás quieras mejorar:

Problemas comunes y soluciones

Problema	Solución
El agente habla demasiado	Añade al prompt: "Mantén las respuestas en 1-2 frases"
El agente es demasiado formal	Ajusta el tono del prompt: "Sé amable y cercano"
El agente no conoce la información	Comprueba que la base de conocimiento tiene la información
El agente inventa cosas	Enfatiza en el prompt: "NUNCA inventes información"
Idioma incorrecto	Comprueba que el ajuste de Idioma coincide con tus necesidades
Voz demasiado rápida/lenta	Ajusta los ajustes de velocidad de la voz

Itera y mejora

1. Prueba → Identifica problemas → Ajusta el prompt/ajustes → Prueba de nuevo
2. Añade más preguntas frecuentes a la base de conocimiento según las llamadas de prueba
3. Refina el prompt según las conversaciones reales

---

Paso 6: Despliega tu agente (opcional)

Cuando estés satisfecho con las pruebas, puedes desplegar tu agente:

Opción A: Conectar un número de teléfono

1. Ve a Números de teléfono
2. Compra un número o importa uno existente
3. Asigna tu agente al número
4. Las llamadas a ese número ahora las gestiona tu agente

Opción B: Añadir el widget al sitio web

1. Ve a los ajustes de tu agente
2. Busca la pestaña Widgets
3. Copia el código de incrustación
4. Añádelo a tu sitio web

---

Checklist: ¿está listo tu agente?

Antes de ponerlo en marcha, verifica:

• El primer mensaje es claro y acogedor
• El prompt define el comportamiento correctamente
• La base de conocimiento tiene información precisa
• El agente maneja bien las preguntas comunes
• El agente admite cuando no sabe algo
• La voz suena adecuada para tu marca
• El idioma está bien configurado
• Las llamadas de prueba producen buenos resultados

---

¿Qué sigue?

¡Enhorabuena! Has creado tu primer agente de voz.

Sigue aprendiendo:

1. Agentes de voz en profundidad — Configuración avanzada del agente
2. Buenas prácticas de la base de conocimiento — Crea mejores bases de conocimiento
3. Números de teléfono — Conecta números de teléfono reales
4. Roles de plantilla — Prompts y configuraciones listos para usar
5. Campañas — Configura campañas de llamadas salientes

---

Solución de problemas

El agente no inicia la llamada de prueba

• Comprueba los permisos de micrófono del 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 con claridad 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 la voz es mala

• Comprueba tu conexión a internet
• Prueba con otra voz
• Reduce el ruido de fondo

---

¿Necesitas ayuda?

• Revisa la Guía de solución de problemas
• Contacta con support@hanc.ai