> ## 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 de Salida

> Configura qué datos extrae tu agente de cada llamada

## ¿Qué es la Configuración de Salida?

La Configuración de Salida define qué información debe extraer y capturar tu agente de cada conversación. Estos datos están disponibles vía webhooks o API para uso en tu CRM, analíticas u otros sistemas.

<Info>
  Una configuración de salida bien definida convierte cada llamada en datos estructurados y accionables.
</Info>

## Parámetros de Salida

Los Parámetros de Salida son campos personalizados que tu agente extrae de la conversación.

### Cambios Pendientes del Copilot

Cuando el Copilot de IA analiza tu prompt del sistema, puede sugerir cambios automáticamente en los parámetros de salida.

<Warning>
  Las sugerencias del Copilot aparecen en un banner morado. Revisa cada cambio cuidadosamente antes de aceptarlo.
</Warning>

#### Gestión de Cambios Pendientes

Los cambios pendientes se organizan por tipo de operación:

| Operación     | Descripción                          | Icono Visual |
| ------------- | ------------------------------------ | ------------ |
| **Añadir**    | Parámetros nuevos sugeridos          | `+` verde    |
| **Modificar** | Cambios en parámetros existentes     | `~` amarillo |
| **Eliminar**  | Parámetros marcados para eliminación | `-` rojo     |

<Steps>
  <Step title="Revisar Banner de Cambios">
    Cuando aparezcan sugerencias, verás un banner morado con el número de cambios pendientes.
  </Step>

  <Step title="Evaluar Cada Cambio">
    Revisa el tipo de operación, nombre del parámetro y detalles de cada cambio propuesto.
  </Step>

  <Step title="Aceptar o Rechazar">
    * **Aceptar**: Aplica todos los cambios sugeridos
    * **Rechazar**: Descarta todas las sugerencias
  </Step>
</Steps>

### Plantillas de Parámetros

Las plantillas predefinidas te permiten añadir rápidamente parámetros comunes:

#### Plantillas Disponibles

**Información Personal**

* `firstname`, `lastname` - Datos personales del cliente
* `email`, `phone` - Información de contacto
* `company`, `position` - Datos empresariales

**Datos de Marketing**

* `utm_source`, `utm_medium`, `utm_campaign` - Parámetros UTM
* `lead_score`, `lead_status` - Calificación de leads
* `tags` - Etiquetas asociadas

**Información Comercial**

* `budget` - Presupuesto mencionado
* `timeline` - Plazo de decisión
* `decision_maker` - Si es tomador de decisiones
* `pain_points` - Puntos de dolor identificados

<Steps>
  <Step title="Acceder a Plantillas">
    En modo UX, haz clic en el botón "Templates" junto a "Add Parameter".
  </Step>

  <Step title="Explorar Panel de Plantillas">
    Se abre un panel flotante con todas las plantillas categorizadas.
  </Step>

  <Step title="Añadir Plantillas">
    Haz clic en "Add" junto a cada plantilla que desees incluir.
  </Step>

  <Step title="Gestionar Plantillas Añadidas">
    Los parámetros ya añadidos muestran "Added" y opción para eliminarlos.
  </Step>
</Steps>

### Creando Parámetros Manualmente

<Steps>
  <Step title="Abrir Configuración de Salida">
    Navega a la sección de Configuración de Salida en el panel izquierdo.
  </Step>

  <Step title="Añadir Parámetro">
    Haz clic en "Add Parameter" para crear un nuevo campo.
  </Step>

  <Step title="Configurar Propiedades">
    Establece nombre, tipo y descripción para el parámetro.
  </Step>
</Steps>

### Propiedades del Parámetro

| Propiedad   | Descripción             | Ejemplo                                         |
| ----------- | ----------------------- | ----------------------------------------------- |
| Nombre      | Identificador del campo | `interes_cliente`                               |
| Tipo        | Tipo de dato            | string, number, boolean                         |
| Descripción | Qué extraer             | "Producto en el que el cliente está interesado" |

### Tipos de Datos

| Tipo    | Caso de Uso                  | Valor de Ejemplo |
| ------- | ---------------------------- | ---------------- |
| String  | Nombres, productos, feedback | "Plan Premium"   |
| Number  | Cantidades, calificaciones   | 4.5              |
| Boolean | Decisiones sí/no             | true             |

## Modos de Edición

Puedes configurar parámetros de salida usando dos modos diferentes:

### Modo UX (Visual)

El modo visual proporciona una interfaz intuitiva con funciones avanzadas:

<Steps>
  <Step title="Añadir Parámetro">
    Haz clic en el botón "Add Parameter" para crear un nuevo campo.
  </Step>

  <Step title="Usar Plantillas">
    Accede al botón "Templates" para plantillas predefinidas.
  </Step>

  <Step title="Configurar Detalles">
    Completa nombre, tipo y descripción en el formulario expandible.
  </Step>

  <Step title="Reordenar Parámetros">
    Arrastra y suelta parámetros para cambiar su orden.
  </Step>
</Steps>

**Funcionalidades del Modo UX:**

* Panel de plantillas flotante con scroll
* Indicadores visuales de plantillas añadidas
* Formularios expandibles para cada parámetro
* Drag & drop para reordenamiento
* Validación en tiempo real

### Modo Texto (JSON)

Para usuarios avanzados, el modo texto ofrece edición directa en JSON:

```json theme={null}
[
  {
    "name": "interes_cliente",
    "type": "string",
    "description": "Producto o servicio en el que el cliente está interesado"
  },
  {
    "name": "cita_programada",
    "type": "boolean",
    "description": "Si se programó una cita exitosamente"
  },
  {
    "name": "puntuacion_satisfaccion",
    "type": "number",
    "description": "Calificación de satisfacción del cliente del 1-5"
  }
]
```

**Funcionalidades del Modo Texto:**

* Editor de texto con resaltado de sintaxis
* Sincronización de scroll entre editor y vista previa
* Detección automática de errores JSON
* Soporte para copiar/pegar configuraciones

<Tabs>
  <Tab title="Ventajas Modo UX">
    - Interfaz intuitiva y visual
    - Plantillas predefinidas
    - Validación automática
    - Ideal para principiantes
  </Tab>

  <Tab title="Ventajas Modo Texto">
    * Edición rápida y directa
    * Importar/exportar configuraciones
    * Control total sobre el JSON
    * Ideal para usuarios avanzados
  </Tab>
</Tabs>

<Info>
  Puedes cambiar entre modos en cualquier momento usando el toggle en la esquina superior derecha.
</Info>

## Enriquecimiento de Salida

El enriquecimiento permite incluir campos predefinidos adicionales en tu salida:

### Campos Disponibles

| Campo                    | Descripción                              | Utilidad                       |
| ------------------------ | ---------------------------------------- | ------------------------------ |
| 📝 **Transcripción**     | Texto completo de la conversación        | Análisis detallado, compliance |
| 📋 **Resumen**           | Resumen generado por IA                  | Vista rápida del contenido     |
| ✅ **Estado de Éxito**    | Si la llamada logró su objetivo          | KPIs y métricas de conversión  |
| 🆔 **ID de Llamada**     | Identificador único de llamada           | Referencia y trazabilidad      |
| 🤖 **ID de Agente**      | Identificador del agente/playbook        | Análisis por agente            |
| ⏱️ **Duración**          | Duración en segundos                     | Métricas operativas            |
| 📅 **Creado**            | Timestamp de inicio                      | Análisis temporal              |
| 📊 **Estado de Llamada** | Estado final (completada, fallida, etc.) | Análisis de calidad            |
| ✅ **Evaluaciones**       | Resultados de tests de calidad           | Control de calidad             |
| 📱 **Tipo**              | Inbound/Outbound                         | Segmentación de llamadas       |

### Gestión de Cambios en Enriquecimiento

El sistema ahora maneja cambios pendientes en el enriquecimiento por separado:

<Warning>
  Los cambios en el enriquecimiento aparecen en banners separados de los parámetros de salida.
</Warning>

<Steps>
  <Step title="Cambios Automáticos">
    El Copilot puede sugerir modificaciones basadas en tu prompt.
  </Step>

  <Step title="Revisión Independiente">
    Puedes aceptar o rechazar cambios de enriquecimiento sin afectar los parámetros.
  </Step>

  <Step title="Aplicación Selectiva">
    Cada tipo de cambio se puede gestionar por separado.
  </Step>
</Steps>

## Configuración de Webhook

Envía resultados de llamadas a tus sistemas externos automáticamente.

### Configurando Webhooks

<Steps>
  <Step title="Habilitar Webhook">
    Activa la opción de webhook en Configuración de Salida.
  </Step>

  <Step title="Ingresar URL">
    Proporciona el endpoint que recibirá los datos.
  </Step>

  <Step title="Seleccionar Método">
    Elige método HTTP (típicamente POST).
  </Step>

  <Step title="Añadir Autenticación">
    Configura headers de autenticación si es necesario.
  </Step>
</Steps>

### Opciones de Configuración de Webhook

| Ajuste          | Descripción            | Opciones               |
| --------------- | ---------------------- | ---------------------- |
| **URL**         | Tu endpoint de webhook | HTTPS recomendado      |
| **Método**      | Método HTTP            | GET, POST, PUT, DELETE |
| **Header Auth** | Autenticación          | Bearer token, API key  |

### Ejemplo de Payload de Webhook

```json theme={null}
{
  "call_id": "llamada_abc123",
  "agent_id": "agente_xyz789",
  "created_at": "2024-01-15T10:30:00Z",
  "duration": 245,
  "status": "completed",
  "success": true,
  "output_params": {
    "interes_cliente": "Plan Premium",
    "cita_programada": true,
    "fecha_preferida": "2024-01-20",
    "puntuacion_satisfaccion": 5,
    "firstname": "María",
    "email": "maria@example.com",
    "budget": 1500,
    "decision_maker": true
  },
  "transcription": "Conversación completa aquí...",
  "summary": "El cliente preguntó sobre el Plan Premium y programó una cita para el 20 de enero. Mostró alto interés y tiene presupuesto aprobado."
}
```

## Flujo de Trabajo con Copilot

El Copilot ofrece asistencia inteligente mejorada para configurar parámetros de salida:

<Steps>
  <Step title="Análisis Automático">
    Al escribir o modificar tu prompt del sistema, el Copilot analiza automáticamente el contenido.
  </Step>

  <Step title="Detección de Cambios">
    Identifica qué parámetros necesitan añadirse, modificarse o eliminarse.
  </Step>

  <Step title="Sugerencias Contextuales">
    Propone cambios basados en el contexto y objetivos de tu agente.
  </Step>

  <Step title="Revisión Granular">
    Presenta cada cambio con operación específica y detalles.
  </Step>

  <Step title="Aplicación Selectiva">
    Permite aceptar o rechazar cambios por categoría (parámetros vs enriquecimiento).
  </Step>
</Steps>

### Tipos de Sugerencias del Copilot

**Adición de Parámetros**

* Nuevos campos identificados en el prompt
* Parámetros sugeridos basados en el tipo de conversación
* Campos estándar para el sector específico

**Modificación de Existentes**

* Cambios en tipos de datos más apropiados
* Mejoras en descripciones para mejor extracción
* Ajustes basados en contexto actualizado

**Eliminación de Redundantes**

* Parámetros que ya no son relevantes
* Campos duplicados o similares
* Parámetros incompatibles con el nuevo prompt

## Mejores Prácticas Avanzadas

### Configuración Estratégica

<Warning>
  Una configuración de salida mal diseñada puede resultar en datos incompletos o inconsistentes.
</Warning>

1. **Planificación Previa**
   * Define qué datos necesitas antes de configurar
   * Considera tu flujo de trabajo posterior
   * Alinea con los campos de tu CRM

2. **Uso Inteligente de Plantillas**
   * Comienza con plantillas estándar
   * Personaliza según tu industria
   * Combina plantillas para casos específicos

3. **Aprovechamiento del Copilot**
   * Utiliza las sugerencias como base
   * Refina las propuestas según tu contexto
   * Itera basándote en resultados reales

### Optimización de Descripciones

Las descripciones de parámetros son críticas para la extracción correcta:

**❌ Malo**: `"presupuesto"`
**✅ Bueno**: `"Rango de presupuesto mensual mencionado por el cliente para el servicio, en euros"`

**❌ Malo**: `"interesado"`
**✅ Bueno**: `"Si el cliente mostró interés genuino en proceder con el siguiente paso del proceso de venta"`

### Gestión de Datos Sensibles

<Warning>
  Siempre usa autenticación segura para webhooks que manejan datos sensibles.
</Warning>

* Implementa HTTPS para todos los endpoints
* Usa tokens de autenticación seguros
* Considera el cifrado de datos sensibles
* Implementa logs de auditoría

## Patrones de Configuración por Industria

### E-commerce y Retail

```json theme={null}
{
  "producto_interes": "string",
  "rango_presupuesto": "string", 
  "talla_preferencia": "string",
  "canal_preferido": "string",
  "fecha_compra_estimada": "string",
  "cliente_recurrente": "boolean",
  "promocion_aplicada": "string",
  "metodo_pago_preferido": "string"
}
```

### Servicios Profesionales

```json theme={null}
{
  "tipo_servicio": "string",
  "urgencia_proyecto": "string",
  "presupuesto_aprobado": "number",
  "equipo_tamaño": "number",
  "plazo_inicio": "string",
  "stakeholders": "string",
  "experiencia_previa": "boolean",
  "referencias_requeridas": "boolean"
}
```

### Inmobiliario

```json theme={null}
{
  "tipo_propiedad": "string",
  "zona_preferida": "string",
  "rango_precio": "string",
  "num_habitaciones": "number",
  "financiacion_aprobada": "boolean",
  "plazo_mudanza": "string",
  "primera_vivienda": "boolean",
  "visita_programada": "boolean"
}
```

### Salud y Wellness

```json theme={null}
{
  "tipo_consulta": "string",
  "sintomas_principales": "string",
  "tratamiento_previo": "boolean",
  "seguro_medico": "string",
  "fecha_cita_preferida": "string",
  "medico_preferencia": "string",
  "urgencia_nivel": "number",
  "autorizacion_tratamiento": "boolean"
}
```

## Monitoreo y Optimización

### Análisis de Extracción

<Steps>
  <Step title="Revisar Datos Extraídos">
    Analiza regularmente la calidad de datos extraídos.
  </Step>

  <Step title="Identificar Patrones">
    Busca campos frecuentemente vacíos o inconsistentes.
  </Step>

  <Step title="Refinar Descripciones">
    Mejora las descripciones de parámetros problemáticos.
  </Step>

  <Step title="Iterar y Mejorar">
    Ajusta la configuración basándote en resultados reales.
  </Step>
</Steps>

### KPIs de Calidad de Datos

| Métrica          | Objetivo             | Acción si Bajo        |
| ---------------- | -------------------- | --------------------- |
| **Completitud**  | >85% campos llenos   | Revisar descripciones |
| **Consistencia** | >90% valores válidos | Mejorar validación    |
| **Precisión**    | >95% datos correctos | Refinar prompts       |

## Integración con Sistemas Externos

### CRM Integration

<Tabs>
  <Tab title="Salesforce">
    * Mapea parámetros a campos estándar
    * Usa IDs de Salesforce como referencias
    * Configura webhooks para crear/actualizar leads
  </Tab>

  <Tab title="HubSpot">
    * Aprovecha propiedades personalizadas
    * Sincroniza con líneas de tiempo de contactos
    * Implementa scoring automático
  </Tab>

  <Tab title="Pipedrive">
    * Utiliza campos personalizados
    * Automatiza creación de actividades
    * Actualiza pipeline stages
  </Tab>
</Tabs>

### Herramientas de Marketing

* **Email Marketing**: Segmenta listas basándote en parámetros extraídos
* **Analytics**: Envía eventos a Google Analytics o similares
* **Automatización**: Dispara workflows basados en datos de llamadas

## Troubleshooting Común

### Problemas de Extracción

**Problema**: Parámetros frecuentemente vacíos
**Solución**:

* Verifica que la descripción sea específica y clara
* Asegúrate que la información se mencione en las llamadas
* Considera dividir parámetros complejos en varios simples

**Problema**: Datos inconsistentes
**Solución**:

* Estandariza formatos esperados en las descripciones
* Usa validaciones en tu sistema receptor
* Proporciona ejemplos en las descripciones

**Problema**: Webhooks fallando
**Solución**:

* Verifica la URL del endpoint
* Confirma la autenticación
* Revisa logs del servidor receptor

## Siguientes Pasos

<CardGroup cols={2}>
  <Card title="Saludos" icon="hand-wave" href="/es/advanced-editor/greetings">
    Configura mensajes de bienvenida personalizados
  </Card>

  <Card title="Evaluaciones" icon="check-double" href="/es/advanced-editor/evaluations">
    Implementa tests de calidad automáticos
  </Card>
</CardGroup>