> ## Documentation Index
> Fetch the complete documentation index at: https://docs.meetzy.es/llms.txt
> Use this file to discover all available pages before exploring further.

# Configuración Básica

> Gestiona cuentas Twilio, números de teléfono, caller IDs y configura componentes fundamentales como agentes de voz especializados y modelos de IA

## Resumen

La Configuración Básica establece los **Componentes Fundacionales** de tu agente conversacional de IA, incluyendo la configuración de infraestructura telefónica con cuentas Twilio, gestión de números de teléfono y caller IDs, así como la personalización con agentes de voz especializados por industria y capacidades conversacionales avanzadas.

## Componentes Base de Meetzy

<Info>
  Los Componentes Base están habilitados por defecto en nuevos agentes para asegurar conversaciones de alta calidad desde el primer momento.
</Info>

Los Componentes Base de Meetzy proporcionan la fundación para agentes conversacionales profesionales y consistentes. Esta funcionalidad permite un control granular sobre qué elementos base del sistema Meetzy se incluyen en el prompt del asistente.

### 🛡️ Guardrails Fundacionales

**Protección y Límites Profesionales:**

* Restricciones éticas y de comportamiento
* Mantenimiento del contexto profesional
* Prevención de temas inapropiados
* Límites de conversación seguros
* Protocolos de escalación automática

### 🎭 Aspectos Conversacionales

**Habilidades de Comunicación Natural:**

* Manejo inteligente de interrupciones
* Gestión profesional de silencios
* Transiciones conversacionales fluidas
* Técnicas de clarificación activa
* Adaptación al ritmo del interlocutor

### 💼 Background Laboral de Agentes

**Experiencia Profesional Integrada:**

* Conocimiento de protocolos telefónicos empresariales
* Mejores prácticas del sector de atención
* Experiencia en comunicación corporativa
* Estándares de servicio al cliente
* Competencias profesionales transversales

<Warning>
  **Importante**: Deshabilitar los Componentes Base puede resultar en conversaciones menos naturales o comportamientos impredecibles. Solo desactívalos si tienes un sistema de prompts personalizado completamente desarrollado y probado.
</Warning>

## Habilidades del Agente (Skills)

### Sistema de Agentes de Voz Especializados

En lugar de configurar voces individuales, selecciona un **Agente de Voz Especializado** que combina voz optimizada, personalidad profesional y conocimiento específico del sector.

<Steps>
  <Step title="Abrir selector modal">
    Haz clic en "Seleccionar Agente de Voz" para acceder a la biblioteca completa
  </Step>

  <Step title="Filtrar por especialidad">
    Usa los filtros de industria para encontrar agentes con expertise específico
  </Step>

  <Step title="Buscar características específicas">
    Utiliza la barra de búsqueda para encontrar voces y habilidades particulares
  </Step>

  <Step title="Previsualizar agente">
    Escucha muestras de audio y revisa las competencias profesionales
  </Step>

  <Step title="Confirmar selección">
    El agente seleccionado aplicará automáticamente su configuración optimizada
  </Step>
</Steps>

### Especialidades Disponibles

<Tabs>
  <Tab title="Ventas 💼">
    **Agentes optimizados para procesos comerciales:**

    * Técnicas avanzadas de persuasión
    * Manejo profesional de objeciones
    * Estrategias de cierre de ventas
    * Prospección telefónica efectiva
    * Follow-up y nurturing de leads

    **Ejemplos de Agentes:**

    * Sales Representative - Energético y persuasivo
    * Business Development - Consultor estratégico
    * Real Estate Sales - Especialista inmobiliario
  </Tab>

  <Tab title="Soporte al Cliente 🎧">
    **Especialistas en atención y servicio:**

    * Resolución empática de incidencias
    * Soporte técnico especializado
    * Atención post-venta premium
    * Gestión de escalaciones
    * Satisfacción del cliente

    **Ejemplos de Agentes:**

    * Customer Success - Orientado a soluciones
    * Technical Support - Experto en troubleshooting
    * Billing Support - Especialista en facturación
  </Tab>

  <Tab title="Inmobiliaria 🏠">
    **Expertos en transacciones inmobiliarias:**

    * Valoraciones de propiedades
    * Procesos de compra-venta
    * Asesoramiento hipotecario
    * Análisis de mercado
    * Gestión de visitas

    **Ejemplos de Agentes:**

    * Property Advisor - Consultor inmobiliario
    * Mortgage Specialist - Experto en financiación
    * Investment Consultant - Asesor de inversiones
  </Tab>

  <Tab title="Salud 🏥">
    **Agentes especializados en sector salud:**

    * Programación de citas médicas
    * Información médica básica
    * Seguimiento de pacientes
    * Coordinación de tratamientos
    * Soporte administrativo sanitario

    **Ejemplos de Agentes:**

    * Medical Receptionist - Coordinador de citas
    * Patient Care - Seguimiento personalizado
    * Health Information - Asesor médico
  </Tab>

  <Tab title="Educación 🎓">
    **Especialistas en consultas educativas:**

    * Información de cursos y programas
    * Procesos de admisión
    * Soporte académico
    * Orientación educativa
    * Gestión de matrículas

    **Ejemplos de Agentes:**

    * Academic Advisor - Consejero académico
    * Admissions Specialist - Experto en admisiones
    * Student Support - Asistente estudiantil
  </Tab>

  <Tab title="General 🌐">
    **Agentes versátiles para múltiples propósitos:**

    * Adaptabilidad a diversos contextos
    * Comunicación profesional general
    * Flexibilidad conversacional
    * Skills transversales
    * Personalización avanzada

    **Ejemplos de Agentes:**

    * Professional Assistant - Asistente ejecutivo
    * General Support - Soporte multipropósito
    * Business Coordinator - Coordinador empresarial
  </Tab>
</Tabs>

### Características de los Agentes Especializados

<Info>
  Cada Agente de Voz incluye configuración optimizada de voz, personalidad profesional específica y conocimiento del sector que mejora significativamente la calidad y naturalidad de las conversaciones.
</Info>

#### Componentes de Especialización

**🎭 Personalidad Profesional**

* Tono y estilo de comunicación específico del sector
* Vocabulario técnico y terminología especializada
* Protocolos de interacción apropiados

**🧠 Conocimiento del Sector**

* Procesos y procedimientos estándar de la industria
* Mejores prácticas profesionales
* Comprensión de necesidades específicas del cliente

**🎵 Voz Optimizada**

* Características vocales ideales para el contexto
* Velocidad y entonación apropiadas
* Claridad y profesionalismo adaptados

## Voz e Idioma

### Configuración de Idioma

<Info>
  **Idioma por defecto**: El español está configurado como idioma principal para asegurar una experiencia conversacional natural en español latinoamericano.
</Info>

Selecciona el idioma principal que utilizará tu agente especializado para todas las interacciones:

<Tabs>
  <Tab title="Idiomas Principales">
    **Idiomas más utilizados:**

    * **Español** ⭐ (por defecto) - Español latinoamericano neutro
    * **English** - Inglés estadounidense
    * **Français** - Francés
    * **Português** - Portugués
    * **Deutsch** - Alemán
    * **Italiano** - Italiano
    * **Nederlands** - Holandés
  </Tab>

  <Tab title="Idiomas Asiáticos">
    **Soporte para mercados asiáticos:**

    * **中文** - Chino mandarín
    * **日本語** - Japonés
    * **한국어** - Coreano
    * **हिन्दी** - Hindi
    * **العربية** - Árabe
    * **ไทย** - Tailandés
    * **Tiếng Việt** - Vietnamita
    * **தமிழ்** - Tamil
  </Tab>

  <Tab title="Idiomas Europeos">
    **Idiomas adicionales europeos:**

    * **Русский** - Ruso
    * **Polski** - Polaco
    * **Svenska** - Sueco
    * **Ελληνικά** - Griego
    * **Čeština** - Checo
    * **Dansk** - Danés
    * **Suomi** - Finlandés
    * **Български** - Búlgaro
    * **Hrvatski** - Croata
    * **Slovenčina** - Eslovaco
    * **Română** - Rumano
    * **Українська** - Ucraniano
    * **Magyar** - Húngaro
    * **Norsk** - Noruego
  </Tab>
</Tabs>

### Configuración Avanzada de Voz

<Tabs>
  <Tab title="Velocidad">
    **Control de ritmo conversacional:**

    * **Rango**: 0.70x - 1.20x (por defecto: 1.06x)
    * **Lenta** (0.70-0.85): Para explicaciones complejas o públicos senior
    * **Normal** (0.90-1.10): Conversación empresarial estándar
    * **Rápida** (1.15-1.20): Dinámicas comerciales o soporte técnico

    <Info>
      La velocidad ligeramente acelerada (1.06x) mejora la percepción de profesionalismo y eficiencia sin comprometer la claridad.
    </Info>
  </Tab>

  <Tab title="Estabilidad">
    **Consistencia vocal:**

    * **Rango**: 0.00 - 1.00 (por defecto: 0.15)
    * **Baja** (0.00-0.30): Voz más expresiva y variable
    * **Media** (0.31-0.70): Balance entre expresividad y consistencia
    * **Alta** (0.71-1.00): Voz muy consistente y predecible

    <Warning>
      Valores muy altos de estabilidad pueden resultar en voces monótonas y poco naturales.
    </Warning>
  </Tab>

  <Tab title="Similitud">
    **Fidelidad al modelo vocal:**

    * **Rango**: 0.00 - 1.00 (por defecto: 0.65)
    * **Baja** (0.00-0.40): Mayor creatividad vocal
    * **Media** (0.41-0.80): Balance óptimo recomendado
    * **Alta** (0.81-1.00): Máxima fidelidad al modelo original

    <Info>
      El valor por defecto de 0.65 proporciona el mejor balance entre naturalidad y fidelidad vocal para contextos empresariales.
    </Info>
  </Tab>
</Tabs>

## Gestión de Infraestructura Telefónica

### Cuentas Twilio

<Info>
  **Solo usuarios administradores**: La selección de cuentas Twilio está disponible únicamente para usuarios con permisos administrativos.
</Info>

Los administradores pueden seleccionar diferentes cuentas Twilio para organizar y distribuir recursos telefónicos:

<Steps>
  <Step title="Seleccionar cuenta Twilio">
    Elige la cuenta Twilio que proporcionará los recursos para este agente
  </Step>

  <Step title="Cargar números disponibles">
    Los números de teléfono se actualizarán automáticamente según la cuenta seleccionada
  </Step>

  <Step title="Verificar compatibilidad">
    Asegúrate de que la cuenta tenga números disponibles para asignación
  </Step>
</Steps>

### Gestión de Números de Teléfono

<Tabs>
  <Tab title="Agentes Nuevos">
    <Steps>
      <Step title="Seleccionar número disponible">
        Elige de la lista de números no asignados del menú desplegable
      </Step>

      <Step title="Verificar disponibilidad">
        Solo se muestran números que no están en uso por otros agentes
      </Step>

      <Step title="Solicitar números adicionales">
        Usa "Request more numbers" si necesitas más opciones disponibles
      </Step>
    </Steps>
  </Tab>

  <Tab title="Agentes Existentes">
    El número asignado se muestra como solo lectura y no puede modificarse después de la creación del agente.

    <Warning>
      Cambiar números en agentes existentes requiere crear un nuevo agente o contactar soporte técnico.
    </Warning>
  </Tab>
</Tabs>

### Gestión de Caller IDs (Números de Salida)

Los Caller IDs permiten configurar números específicos para llamadas salientes, mejorando la confianza del destinatario:

#### Añadir Nuevo Caller ID

<Steps>
  <Step title="Abrir modal de adición">
    Haz clic en "Add Caller ID" para iniciar el proceso
  </Step>

  <Step title="Introducir información">
    * **Nombre**: Identificación descriptiva del número
    * **Teléfono**: Número en formato E.164 (+1234567890)
  </Step>

  <Step title="Iniciar validación">
    Twilio enviará una llamada automática con código de verificación
  </Step>

  <Step title="Introducir código">
    Responde la llamada e introduce el código de 6 dígitos recibido
  </Step>

  <Step title="Completar verificación">
    El número queda disponible para llamadas salientes una vez verificado
  </Step>
</Steps>

#### Estados de Caller ID

<Tabs>
  <Tab title="Verificado">
    * **Estado**: ✅ Verified
    * **Disponibilidad**: Listo para usar en llamadas salientes
    * **Acciones**: Eliminar (con confirmación)
  </Tab>

  <Tab title="Pendiente">
    * **Estado**: ⏳ Pending
    * **Disponibilidad**: En proceso de verificación
    * **Acciones**: Reenviar código, Eliminar
  </Tab>

  <Tab title="Fallido">
    * **Estado**: ❌ Failed
    * **Disponibilidad**: Requiere nueva verificación
    * **Acciones**: Reintentar verificación, Eliminar
  </Tab>
</Tabs>

<Warning>
  Los Caller IDs no verificados no pueden utilizarse para llamadas salientes. Completa siempre el proceso de verificación.
</Warning>

## Configuración de Modelo de IA (LLM)

Selecciona el Modelo de Lenguaje Grande que impulsa la inteligencia conversacional de tu agente especializado.

### Modelos Disponibles

<Tabs>
  <Tab title="Google Gemini ⭐">
    | Modelo                            | Rendimiento  | Velocidad  | Ideal Para                                                  |
    | --------------------------------- | ------------ | ---------- | ----------------------------------------------------------- |
    | **Gemini 3.1 Flash Lite Preview** | Ultra Alto ⭐ | Muy Rápida | **Recomendado por defecto** - Máximo rendimiento optimizado |
    | Gemini 2.5 Flash                  | Alto         | Rápida     | Balance perfecto calidad-velocidad                          |
    | Gemini 2.0 Flash                  | Equilibrado  | Muy Rápida | Respuestas rápidas económicas                               |
    | Gemini 1.5 Pro                    | Máximo       | Moderada   | Razonamiento complejo y análisis profundo                   |
    | Gemini 1.5 Flash                  | Confiable    | Rápida     | Estabilidad probada en producción                           |
  </Tab>

  <Tab title="OpenAI">
    | Modelo       | Rendimiento | Velocidad    | Ideal Para                                |
    | ------------ | ----------- | ------------ | ----------------------------------------- |
    | GPT-4o       | Alto        | Rápida       | Balance inteligencia-velocidad versátil   |
    | GPT-4.1      | Máximo      | Moderada     | Últimas capacidades y tecnología avanzada |
    | GPT-4.1 Mini | Eficiente   | Muy Rápida   | Económico manteniendo calidad             |
    | GPT-4.1 Nano | Básico      | Ultra Rápida | Respuestas instantáneas ultra rápidas     |
  </Tab>

  <Tab title="Anthropic">
    | Modelo           | Rendimiento | Velocidad    | Ideal Para                  |
    | ---------------- | ----------- | ------------ | --------------------------- |
    | Claude Haiku 4.5 | Eficiente   | Ultra Rápida | Máxima economía y velocidad |
  </Tab>
</Tabs>

### Guía de Selección Estratégica

<Tabs>
  <Tab title="🚀 Maximizar Velocidad">
    **Modelos Ultra-Rápidos:**

    * **GPT-4.1 Nano** (respuestas instantáneas)
    * **Claude Haiku 4.5** (económico y veloz)
    * **Gemini 2.0 Flash** (equilibrio óptimo)

    **Casos de Uso:**

    * Consultas simples y directas
    * Alta frecuencia de llamadas
    * Respuestas inmediatas críticas
    * Call centers de alto volumen
  </Tab>

  <Tab title="⚖️ Balance Óptimo">
    **Modelos Recomendados:**

    * **Gemini 3.1 Flash Lite Preview** ⭐ (opción por defecto)
    * **GPT-4o** (confiable y versátil)
    * **Gemini 2.5 Flash** (rendimiento superior)

    **Casos de Uso:**

    * Mayoría de operaciones empresariales
    * Conversaciones complejas pero fluidas
    * Balance costo-beneficio ideal
    * Agentes especializados por industria
  </Tab>

  <Tab title="🧠 Máxima Inteligencia">
    **Modelos Premium:**

    * **Gemini 1.5 Pro** (razonamiento profundo)
    * **GPT-4.1** (capacidades más avanzadas)

    **Casos de Uso:**

    * Análisis complejo de información
    * Resolución de problemas sofisticados
    * Toma de decisiones críticas avanzadas
    * Consultoría especializada
  </Tab>

  <Tab title="💰 Optimizar Costos">
    **Modelos Económicos:**

    * **Claude Haiku 4.5** (más rentable)
    * **Gemini 2.0 Flash** (relación calidad-precio)
    * **GPT-4.1 Mini** (económico OpenAI)

    **Casos de Uso:**

    * Alto volumen de llamadas
    * Presupuestos optimizados
    * Operaciones escalables
    * Pruebas y desarrollo
  </Tab>
</Tabs>

<Info>
  **Recomendación por defecto**: **Gemini 3.1 Flash Lite Preview** ofrece el mejor balance entre capacidades avanzadas, velocidad de respuesta y costo-efectividad para la mayoría de agentes especializados empresariales.
</Info>

## Configuración Avanzada del Agente

### Nombre Interno del Agente

Proporciona un nombre descriptivo que facilite la identificación y gestión en tu panel administrativo.

<Info>
  **Mejores Prácticas de Nomenclatura:**

  * Incluye especialidad: "Ventas Inmobiliaria - Premium"
  * Especifica función: "Soporte Técnico - Nivel 1"
  * Indica idioma: "Atención Cliente - Español"
  * Añade ubicación: "Recepción Madrid - Principal"
</Info>

### Configuración de Grabación

<Info>
  **Habilitado por defecto**: La grabación de llamadas está activada para cumplir con mejores prácticas de calidad, auditoría y cumplimiento legal.
</Info>

#### Beneficios de la Grabación

<Steps>
  <Step title="Control de Calidad Continuo">
    Monitoreo en tiempo real de la calidad conversacional y detección proactiva de áreas de mejora
  </Step>

  <Step title="Análisis de Rendimiento Detallado">
    Métricas avanzadas de éxito, comportamiento del agente y satisfacción del cliente
  </Step>

  <Step title="Cumplimiento Regulatorio">
    Adherencia a requisitos legales y normativos específicos de tu industria y región
  </Step>

  <Step title="Mejora Continua del Sistema">
    Insights para optimización de configuraciones, prompts y agentes especializados
  </Step>

  <Step title="Formación y Entrenamiento">
    Casos reales para mejorar el rendimiento y entrenar nuevos agentes
  </Step>
</Steps>

## Mejores Prácticas de Configuración

<Steps>
  <Step title="Configuración Base Recomendada">
    * Usar **Gemini 3.1 Flash Lite Preview** como modelo por defecto
    * Mantener todos los Componentes Base activados
    * Habilitar grabación de llamadas
  </Step>

  <Step title="Configuración de Infraestructura">
    * Seleccionar cuenta Twilio apropiada (administradores)
    * Asignar número telefónico específico y único
    * Verificar todos los Caller IDs necesarios
  </Step>

  <Step title="Selección de Agente Especializado">
    * Elegir agente de voz que coincida específicamente con tu industria
    * Considerar el perfil de tus clientes objetivo
    * Validar skills profesionales incluidos
  </Step>

  <Step title="Validación Exhaustiva">
    * Probar completamente en Playground antes de producción
    * Verificar comportamientos específicos del sector
    * Validar integración con sistemas existentes
  </Step>

  <Step title="Monitoreo Continuo">
    * Revisar regularmente velocidad de respuesta
    * Analizar métricas de calidad conversacional
    * Optimizar basado en feedback real
  </Step>
</Steps>

## Casos de Uso por Industria

<Tabs>
  <Tab title="Sector Inmobiliario">
    **Configuración Recomendada:**

    * **Agente**: Real Estate Sales Specialist
    * **Modelo**: Gemini 3.1 Flash Lite Preview
    * **Skills**: Valoraciones, hipotecas, mercado

    **Beneficios Específicos:**

    * Conocimiento de terminología inmobiliaria
    * Procesos de compra-venta optimizados
    * Gestión de leads cualificada
  </Tab>

  <Tab title="E-commerce">
    **Configuración Recomendada:**

    * **Agente**: Customer Success Specialist
    * **Modelo**: GPT-4o para versatilidad
    * **Skills**: Pedidos, devoluciones, soporte

    **Beneficios Específicos:**

    * Gestión de pedidos automatizada
    * Soporte post-venta profesional
    * Escalación inteligente de incidencias
  </Tab>

  <Tab title="Servicios Médicos">
    **Configuración Recomendada:**

    * **Agente**: Medical Receptionist
    * **Modelo**: Gemini 1.5 Pro para precisión
    * **Skills**: Citas, información, coordinación

    **Beneficios Específicos:**

    * Programación de citas eficiente
    * Información médica básica segura
    * Cumplimiento de protocolos sanitarios
  </Tab>
</Tabs>

## Troubleshooting Avanzado

<Tabs>
  <Tab title="Problemas con Caller IDs">
    **Síntomas Comunes:**

    * Verificación fallida repetidamente
    * Número no recibe códigos de verificación
    * Estados de validación inconsistentes

    **Soluciones Detalladas:**

    * Verificar formato exacto E.164 (+país + número)
    * Confirmar que el número puede recibir llamadas
    * Revisar configuración de operador telefónico
    * Intentar desde diferentes ubicaciones/dispositivos
    * Contactar soporte para números problemáticos
  </Tab>

  <Tab title="Números de Teléfono">
    **Síntomas Comunes:**

    * Lista de números completamente vacía
    * Números deseados no aparecen disponibles
    * Errores de carga de números

    **Soluciones Sistemáticas:**

    * Verificar selección de cuenta Twilio correcta
    * Solicitar más números usando "Request more numbers"
    * Contactar administrador para liberación de números asignados
    * Verificar permisos de cuenta Twilio
    * Revisar límites de números por cuenta
  </Tab>

  <Tab title="Rendimiento de Agentes">
    **Síntomas Comunes:**

    * Respuestas lentas o inconsistentes
    * Calidad conversacional baja
    * Comportamientos inesperados del agente

    **Optimización Avanzada:**

    * Cambiar a modelo más rápido para mejorar velocidad
    * Usar modelo más potente para conversaciones complejas
    * Ajustar prompts de sistema específicos
    * Revisar configuración de agente especializado
    * Analizar logs de conversaciones para patrones
  </Tab>

  <Tab title="Problemas de Integración">
    **Síntomas Comunes:**

    * Fallas en conexión con sistemas externos
    * Sincronización de datos incorrecta
    * Errores de API recurrentes

    **Diagnóstico y Solución:**

    * Verificar credenciales y tokens de API
    * Revisar configuración de webhooks
    * Comprobar conectividad de red y firewalls
    * Validar formatos de datos enviados/recibidos
    * Contactar soporte técnico con logs específicos
  </Tab>
</Tabs>

<Warning>
  **Crítico**: Cambios en configuraciones fundamentales (modelo de IA, número de teléfono, agente de voz especializado) pueden afectar significativamente el comportamiento y rendimiento del agente. Siempre realiza pruebas exhaustivas en el Playground después de cualquier modificación importante antes de implementar en producción.
</Warning>

## Siguientes Pasos

Después de configurar los aspectos fundamentales de tu agente especializado, continúa personalizando su comportamiento y capacidades:

* **Saludos Personalizados**: Configura mensajes de bienvenida específicos para llamadas entrantes y salientes adaptados a tu agente especializado
* **Prompt del Sistema**: Define la personalidad específica, comportamiento y objetivos del agente especializado
* **Acciones del Agente**: Configura transferencias inteligentes de llamadas, envío de emails y SMS automatizados
* **Playground de Pruebas**: Prueba y valida exhaustivamente tu agente especializado antes del despliegue en producción