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

# Herramienta de DialVox

> Aprende a usar los triggers y acciones de DialVox en tus flujos de llamadas con IA

# Herramienta DialVox

La herramienta DialVox es el componente central que conecta tu sistema de llamadas con IA con flujos de automatización. Permite el intercambio de datos en tiempo real entre tus asistentes de IA y sistemas empresariales, facilitando conversaciones personalizadas y seguimientos automatizados.

<Note>
  Puedes encontrar la herramienta DialVox destacada en la parte superior de la
  barra lateral de búsqueda cuando busques triggers o acciones.
</Note>

## Triggers (Disparadores)

### Llamada Finalizada

<img src="https://mintlify.s3.us-west-1.amazonaws.com/opengroup-ce25560f/resources/dialvox-trigger.jpg" alt="Trigger de Llamada Finalizada en DialVox" />

El trigger Llamada Finalizada se activa inmediatamente después de que termina una llamada con IA, proporcionando datos completos sobre la interacción:

* Transcripción completa de la conversación con marcas de tiempo
* Respuestas y decisiones del asistente de IA
* Duración de la llamada y metadatos técnicos
* Información del cliente y número telefónico
* Resultado de la llamada y análisis de sentimiento
* Variables establecidas durante la conversación

#### Configuración

1. Selecciona "Llamada Finalizada" como tu trigger
2. Elige un asistente de IA específico para monitorear
3. Configura el mapeo de variables

### Inyección de Variables en Llamadas Entrantes

Este potente trigger se activa antes de que tu asistente de IA atienda una llamada entrante, permitiéndote:

* Obtener e inyectar datos del cliente en tiempo real
* Personalizar el comportamiento de la IA basado en contexto
* Establecer parámetros de conversación
* Definir rasgos de personalidad de la IA
* Proporcionar variables de lógica empresarial

#### Configuración

1. Selecciona "Llamada Entrante" como tu trigger
2. Define las variables requeridas para el contexto de IA

## Acciones

### Añadir Lead a Campaña

<img src="https://mintlify.s3.us-west-1.amazonaws.com/opengroup-ce25560f/resources/dialvox-action.jpg" alt="Acción de DialVox" />

Esta acción ayuda a gestionar tus campañas de llamadas con IA mediante:

* Creación de nuevos leads desde herramientas externas como Sheets, Hubspot, Facebook leads
* Asignación de leads a campañas específicas de IA
* Adición de contexto para futuras llamadas

#### Configuración

1. Selecciona la campaña de IA objetivo
2. Mapea los detalles de contacto desde los datos del trigger
3. Añade atributos personalizados para el contexto de IA

### Retornar Variables

Esta acción es crucial para llamadas entrantes, devolviendo contexto que se inyecta en el prompt de la IA:

* Perfil y preferencias del cliente
* Resumen del historial de conversaciones
* Reglas de negocio y restricciones
* Banderas de comportamiento personalizado de IA
* Plantillas de respuesta dinámicas

#### Configuración

1. Estructura el JSON de respuesta
2. Mapea datos del cliente a variables
3. Establece parámetros de conversación para la IA
4. Configura el manejo de timeouts

## Ejemplo de Uso

### Gestión de Leads Post-Llamada

```javascript theme={null}
Trigger: Llamada de IA Finalizada
↓
Extraer insights de la conversación
↓
Actualizar registro en Hubspot
↓
Añadir a campaña de seguimiento si califica
```

### Enrutamiento Inteligente de Llamadas Entrantes

```javascript theme={null}
Trigger: Llamada Entrante a IA
↓
Obtener perfil del cliente desde CRM
↓
Obtener historial de interacciones
↓
Retornar contexto enriquecido para el prompt de IA
```

## Mejores Prácticas

1. **Rendimiento en Inyección de Variables**

   * Mantén el procesamiento bajo 2 segundos
   * Establece valores por defecto sensatos

2. **Estructura de Datos**

   * Sigue los requisitos del prompt de IA
   * Valida todas las variables
   * Estructura objetos anidados con claridad
   * Documenta los campos personalizados

3. **Manejo de Errores**
   * Proporciona valores de respaldo
   * Registra fallos en la inyección
   * Monitorea los tiempos de respuesta
   * Maneja datos faltantes de forma segura