# Agentes de Voz de IA

> ⚠️ **Funcionalidad en Fase Beta**
>
> Los Agentes de Voz de IA están actualmente en fase beta y no están disponibles para todos los clientes. Si estás interesado en probar esta funcionalidad, contacta con nuestro equipo de soporte.

## Introducción

Los **Agentes de Voz de IA** son asistentes virtuales inteligentes que pueden realizar llamadas telefónicas de forma automática, mantener conversaciones naturales con tus contactos y tomar decisiones inteligentes sobre seguimientos y reintentos.

### Beneficios Principales

* 🤖 **Automatización completa**: El agente realiza llamadas sin intervención humana
* 🧠 **Inteligencia artificial**: Detecta automáticamente cuándo programar seguimientos
* ⏰ **Ahorro de tiempo**: Libera a tu equipo de tareas repetitivas
* 📊 **Seguimiento inteligente**: El sistema aprende de cada conversación
* 🎯 **Personalización**: Cada llamada incluye contexto de conversaciones anteriores

## Cómo Funciona

### Proceso de Llamadas

Cuando creas una llamada con un agente de voz, el sistema sigue este flujo:

1. **Validación inicial**: Verifica que el número no esté en la [lista de no llamar](https://docs.salescaling.com/guias-practicas/gestion-de-blacklist)
2. **Verificación de horario**: Comprueba que sea un momento apropiado para llamar
3. **Inicio de llamada**: El agente marca el número automáticamente
4. **Conversación**: El agente mantiene una conversación natural siguiendo su prompt configurado
5. **Análisis post-llamada**: La IA analiza la conversación para detectar seguimientos necesarios

### Estados de las Llamadas

Durante su ciclo de vida, una llamada puede pasar por diferentes estados:

| Estado              | Descripción                     | Qué significa                                     |
| ------------------- | ------------------------------- | ------------------------------------------------- |
| 🆕 **Creada**       | Llamada creada pero no iniciada | La llamada está registrada en el sistema          |
| 📅 **Programada**   | Programada para fecha futura    | Se ejecutará automáticamente en la fecha indicada |
| ⏳ **En Cola**       | En cola de procesamiento        | Esperando turno para ser ejecutada                |
| 📞 **Llamando**     | Marcando el número              | El sistema está intentando conectar               |
| 🔄 **En Progreso**  | Llamada activa                  | El agente está conversando con el contacto        |
| ✅ **Completada**    | Finalizada exitosamente         | La conversación terminó correctamente             |
| ❌ **Fallida**       | Error en la llamada             | Hubo un problema técnico                          |
| 🚫 **Cancelada**    | Cancelada manualmente           | Usuario canceló la llamada programada             |
| 📧 **Buzón de Voz** | Llegó a contestador             | El sistema detectó un buzón de voz                |

### Resultados de las Llamadas

Después de cada conversación, el sistema clasifica automáticamente el resultado:

* ✅ **Reunión Programada**: El contacto aceptó agendar una reunión
* 📵 **Ocupado/Buzón**: No se pudo contactar con la persona
* 🚫 **No Interesado**: El contacto rechazó la oferta

## Detección Inteligente de Seguimientos

Una de las características más potentes de los agentes de voz es su capacidad para detectar automáticamente cuándo es necesario programar una llamada de seguimiento.

### ¿Cómo Funciona?

Después de cada llamada, la **inteligencia artificial analiza la transcripción completa** de la conversación para identificar señales que indiquen la necesidad de un seguimiento.

### ✅ Cuándo se Programa un Seguimiento Automático

El sistema programa automáticamente una nueva llamada cuando detecta:

1. **Solicitud explícita del cliente**

   ```
   Cliente: "Llámame mañana a las 3 de la tarde"
   → Sistema programa llamada para mañana a las 15:00
   ```
2. **Cliente muestra interés pero está ocupado**

   ```
   Cliente: "Me interesa pero estoy en una reunión, contacta conmigo la próxima semana"
   → Sistema programa llamada para dentro de 7 días
   ```
3. **Cliente proporciona número alternativo**

   ```
   Cliente: "No soy yo quien decide, habla con María al 675 412 661"
   → Sistema programa llamada al número de María con contexto de la conversación
   ```
4. **Fecha/hora específica mencionada**

   ```
   Cliente: "Llama el lunes por la mañana"
   → Sistema calcula la fecha del próximo lunes y programa la llamada
   ```

### ❌ Cuándo NO se Programa Seguimiento

El sistema es inteligente y **NO programa seguimientos** cuando:

* ❌ El cliente rechaza claramente la oferta
* ❌ El cliente dice que no está interesado
* ❌ El cliente pide explícitamente no ser contactado (se añade a [blacklist](https://docs.salescaling.com/guias-practicas/gestion-de-blacklist))
* ❌ Ya se agendó una reunión formal en el calendario
* ❌ La llamada fue directamente a buzón de voz sin respuesta
* ❌ El cliente colgó inmediatamente

### Niveles de Confianza

Cada detección de seguimiento incluye un **nivel de confianza**:

* 🟢 **Alto**: Solicitud explícita con fecha/hora específica
* 🟡 **Medio**: Interés claro pero sin fecha específica
* 🟠 **Bajo**: Señales indirectas o ambiguas

## Reintentos Automáticos

El sistema gestiona automáticamente los reintentos cuando una llamada no tiene éxito.

### Cuándo se Programa un Reintento

* 📧 **Buzón de voz**: Nadie contestó la llamada
* 📵 **Línea ocupada**: El número estaba ocupado
* ⏰ **Mal momento**: El cliente pidió ser llamado en otro momento

### Cálculo Inteligente de la Fecha de Reintento

El sistema calcula automáticamente cuándo volver a llamar:

| Situación                          | Tiempo de Espera | Ejemplo                                         |
| ---------------------------------- | ---------------- | ----------------------------------------------- |
| Cliente mencionó fecha específica  | Usar esa fecha   | "Llámame el viernes" → Programa para el viernes |
| Dijo "más tarde" sin especificar   | 24 horas         | Reintenta al día siguiente                      |
| Dijo "próxima semana"              | 7 días           | Reintenta en una semana                         |
| Estaba ocupado pero mostró interés | 2-3 días         | Reintenta en 2-3 días                           |
| Buzón de voz sin contexto          | 48 horas         | Reintenta en 2 días                             |

### Contexto de Llamadas Anteriores

Cuando el sistema programa un reintento, **incluye automáticamente un resumen de la conversación anterior**. Esto permite que el agente:

* 📝 Haga referencia a la conversación previa
* 🎯 Continúe desde donde se quedó
* 💡 Personalice el mensaje según el contexto

**Ejemplo:**

```
Primera llamada:
Cliente: "Suena interesante pero ahora no puedo hablar"

Segunda llamada (reintento):
Agente: "Hola, te llamo como habíamos quedado. La última vez 
        mencionaste que te interesaba nuestra solución..."
```

### Números Alternativos

Si durante una conversación el cliente proporciona el número de otra persona (por ejemplo, el decisor real), el sistema:

1. 🔍 **Detecta el número alternativo** automáticamente
2. 👤 **Identifica el nombre y rol** de la persona si se mencionó
3. 📞 **Programa la llamada** al nuevo número
4. 📋 **Incluye el contexto** de por qué se debe contactar a esa persona

**Ejemplo:**

```
Cliente: "No soy yo quien decide esto, tienes que hablar con 
         Jonay, es el director comercial. Su número es 675 412 661"

→ Sistema detecta:
  - Número alternativo: 675 412 661
  - Nombre: Jonay
  - Rol: Director comercial
  - Contexto: Es el decisor, referido por [nombre del cliente inicial]

→ Programa llamada a Jonay con toda esta información
```

## Horarios de Llamadas

### Números de Teléfono

Para que tu agente de voz pueda realizar llamadas, necesitas tener un **número de teléfono activo** asignado al agente.

> 📞 **Compra de Números**
>
> Para adquirir números de teléfono nacionales o internacionales, contacta con nuestro equipo de soporte:
>
> * 📧 Email: <support@salescaling.com>
> * 💬 Chat en vivo en la plataforma
>
> Disponemos de números en múltiples países y podemos ayudarte a elegir el más adecuado para tu caso de uso.

### Configuración de Horarios

Los agentes de voz pueden tener **horarios configurados** para respetar:

* 🕐 **Horas laborales**: Solo llamar en horario de oficina
* 📅 **Días de la semana**: Evitar fines de semana
* 🌍 **Zonas horarias**: Respetar la zona horaria del contacto
* 🚫 **Excepciones**: Días festivos o periodos de vacaciones

### Validación Automática

Antes de cada llamada, el sistema:

1. ✅ Verifica si es un momento apropiado según el horario configurado
2. ⏰ Si no puede llamar ahora, calcula el **próximo slot disponible**
3. 📅 Programa automáticamente la llamada para ese momento

**Ejemplo:**

```
Intento de llamada: Sábado 10:00 AM
Horario configurado: Lunes a Viernes, 9:00 AM - 6:00 PM

→ Sistema detecta que es fin de semana
→ Calcula próximo slot: Lunes 9:00 AM
→ Programa la llamada automáticamente para el lunes
```

## Protección con Lista de No Llamar

El sistema integra automáticamente la [gestión de blacklist](https://docs.salescaling.com/guias-practicas/gestion-de-blacklist) para proteger tu organización.

### Validación Automática

Antes de **cada llamada**, el sistema:

1. 🔍 Verifica si el número está en la lista de no llamar
2. 🚫 Si está blacklisted, **bloquea la llamada automáticamente**
3. 📝 Registra el intento en los logs
4. ➡️ Continúa con el siguiente contacto en la cola

### Detección Automática Durante Llamadas

Si durante una conversación el cliente solicita no ser contactado:

1. 🤖 La IA detecta la solicitud automáticamente
2. 📋 Clasifica el nivel de riesgo (alto, medio, bajo)
3. 🚫 Añade el número a la blacklist
4. ⛔ Cancela cualquier llamada futura programada a ese número

Para más información, consulta la [guía completa de gestión de blacklist](https://docs.salescaling.com/guias-practicas/gestion-de-blacklist).

## Gestión de Llamadas Programadas

### Ver Llamadas Programadas

Puedes ver todas las llamadas programadas en la **lista de conversaciones** de cada agente:

1. Navega a **Agentes de Voz** > **\[Nombre del agente]**
2. En la pestaña **Conversaciones**, verás:
   * 📅 Estado: "Programada"
   * ⏰ Fecha y hora de la próxima llamada
   * 📝 Razón del seguimiento (si aplica)

### Cancelar una Llamada Programada

Si necesitas cancelar una llamada antes de que se ejecute:

1. Encuentra la llamada en la lista de conversaciones
2. Haz clic en el menú de acciones (⋮)
3. Selecciona **"Cancelar llamada programada"**
4. Confirma la acción

⚠️ **Nota**: Una vez cancelada, la llamada no se ejecutará automáticamente. Si cambias de opinión, tendrás que programarla manualmente de nuevo.

### Información Mostrada

Para cada llamada programada, el sistema muestra:

* 📅 **Fecha y hora exacta** de ejecución
* 📝 **Razón del seguimiento**: Por qué se programó
* 🎯 **Nivel de confianza**: Qué tan seguro está el sistema
* 🔗 **Llamada original**: Link a la conversación que generó el seguimiento
* 👤 **Contacto**: Información del contacto a llamar

## Casos de Uso Prácticos

### Ejemplo 1: Cliente Ocupado con Fecha Específica

**Conversación:**

```
Agente: "Buenos días, te llamo para presentarte nuestra solución..."
Cliente: "Estoy en una reunión ahora, ¿puedes llamarme mañana a las 3 de la tarde?"
Agente: "Por supuesto, te llamaré mañana a las 3. ¡Que tengas buen día!"
```

**Resultado:**

* ✅ Sistema programa automáticamente llamada para mañana 15:00
* 🟢 Nivel de confianza: **Alto** (fecha y hora específicas)
* 📝 Razón: "Cliente solicitó ser contactado mañana a las 3pm"
* 📋 Contexto incluido para la próxima llamada

***

### Ejemplo 2: Contacto Alternativo (Decisor)

**Conversación:**

```
Agente: "¿Estarías interesado en una demo de nuestra plataforma?"
Cliente: "No soy yo quien decide esto, tienes que hablar con María, 
         la directora comercial. Su número es 675 412 661"
Agente: "Perfecto, contactaré con María. ¿Sabes cuál sería un buen momento?"
Cliente: "Por las mañanas suele estar más disponible"
```

**Resultado:**

* ✅ Sistema detecta número alternativo: **675 412 661**
* 👤 Nombre: **María**
* 💼 Rol: **Directora comercial**
* ⏰ Programa llamada para mañana por la mañana (9-12h)
* 📋 Contexto: "Referido por \[nombre del cliente], quien indicó que María es la decisora"
* 🟢 Nivel de confianza: **Alto**

***

### Ejemplo 3: Interés pero Sin Fecha Específica

**Conversación:**

```
Agente: "¿Te gustaría conocer más sobre cómo podemos ayudarte?"
Cliente: "Suena interesante pero ahora no puedo hablar, llámame la próxima semana"
Agente: "Perfecto, te contactaré la próxima semana. ¡Hasta pronto!"
```

**Resultado:**

* ✅ Sistema programa llamada para **dentro de 7 días**
* 🟡 Nivel de confianza: **Medio** (sin fecha exacta)
* 📝 Razón: "Cliente mostró interés y pidió ser contactado la próxima semana"
* 📋 Resumen de la conversación incluido para continuidad

***

### Ejemplo 4: Buzón de Voz

**Situación:**

```
Agente marca el número → Suena 5 veces → Salta buzón de voz
Sistema detecta: "Mensaje de buzón de voz"
```

**Resultado:**

* 📧 Estado: **Buzón de voz**
* ⏰ Sistema programa reintento automático para **48 horas después**
* 🟠 Nivel de confianza: **Bajo** (no hubo conversación)
* 📝 Razón: "No contestó, llegó a buzón de voz"

***

### Ejemplo 5: No Programar Seguimiento

**Conversación:**

```
Agente: "Te llamo para ofrecerte nuestra solución de..."
Cliente: "No me interesa, por favor no me llamen más"
Agente: "Entendido, disculpa las molestias. Que tengas buen día"
```

**Resultado:**

* ❌ **NO se programa seguimiento**
* 🚫 Número añadido a [blacklist](https://docs.salescaling.com/guias-practicas/gestion-de-blacklist) automáticamente
* 🔴 Nivel de riesgo: **Alto**
* 📝 Razón: "Cliente solicitó explícitamente no ser contactado"
* ⛔ Cualquier llamada futura a este número será bloqueada

## Mejores Prácticas

### ✅ Hacer

* **Revisar regularmente las llamadas programadas**: Asegúrate de que los seguimientos tienen sentido
* **Configurar horarios apropiados**: Respeta las horas laborales de tus contactos
* **Mantener actualizada la blacklist**: Revisa periódicamente la lista de no llamar
* **Revisar transcripciones**: Analiza las conversaciones para mejorar el prompt del agente
* **Monitorear resultados**: Observa qué tipo de llamadas tienen mejor tasa de éxito
* **Personalizar el prompt**: Ajusta el comportamiento del agente según tu caso de uso
* **Probar antes de escalar**: Realiza pruebas con un grupo pequeño antes de importar miles de contactos

### ❌ Evitar

* **No cancelar seguimientos sin revisar**: Los seguimientos automáticos suelen estar bien fundamentados
* **No ignorar llamadas fallidas repetidamente**: Si un número falla constantemente, investiga por qué
* **No configurar horarios**: Sin horarios configurados, el agente puede llamar en momentos inapropiados
* **No revisar la blacklist**: Números blacklisted deben ser respetados siempre
* **No sobrecargar con llamadas**: Demasiadas llamadas en poco tiempo puede ser contraproducente
* **No usar prompts genéricos**: Personaliza el mensaje para tu audiencia específica

## Limitaciones de la Beta

Como esta funcionalidad está en **fase beta**, ten en cuenta:

* ⚠️ **Disponibilidad limitada**: No todos los clientes tienen acceso aún
* 🔧 **Mejoras continuas**: La detección de IA se está perfeccionando constantemente
* 🐛 **Posibles errores**: Pueden ocurrir falsos positivos/negativos en la detección
* 📊 **Métricas en desarrollo**: Algunas estadísticas aún se están implementando
* 🌍 **Idiomas**: Actualmente optimizado para español, otros idiomas en desarrollo
* 💬 **Feedback bienvenido**: Tus comentarios nos ayudan a mejorar el sistema

### Reportar Problemas

Si encuentras algún problema o tienes sugerencias:

1. 📧 Envía un email a <support@salescaling.com>
2. 💬 Usa el chat en vivo en la plataforma
3. 📝 Describe el problema con el máximo detalle posible
4. 🔗 Incluye el ID de la llamada si es relevante

## Preguntas Frecuentes

<details>

<summary>¿Cómo sé si una llamada está programada?</summary>

En la lista de conversaciones del agente, verás el estado **"Programada"** junto con la fecha y hora de ejecución. También puedes filtrar la lista para ver solo llamadas programadas.

</details>

<details>

<summary>¿Puedo cancelar una llamada programada automáticamente?</summary>

Sí, puedes cancelar cualquier llamada programada desde el menú de acciones (⋮) en la lista de conversaciones. La llamada no se ejecutará y quedará marcada como "Cancelada".

</details>

<details>

<summary>¿Qué pasa si el cliente da un número incorrecto?</summary>

Si el número alternativo proporcionado por el cliente es inválido, el sistema intentará llamar pero fallará. La llamada quedará marcada como "Fallida" y no se programarán más reintentos automáticos a ese número.

</details>

<details>

<summary>¿El sistema respeta los horarios de no llamar?</summary>

Sí, absolutamente. Si configuras un horario de llamadas para tu agente, el sistema **siempre** verificará que sea un momento apropiado antes de ejecutar cualquier llamada. Si no lo es, la llamada se reprograma automáticamente para el próximo slot disponible.

</details>

<details>

<summary>¿Cómo se manejan los números internacionales?</summary>

El sistema normaliza automáticamente los números telefónicos para manejar diferentes formatos (con/sin prefijo internacional, con/sin espacios, etc.). Esto evita duplicados y asegura que la blacklist funcione correctamente.

</details>

<details>

<summary>¿Puedo ver la transcripción de las llamadas?</summary>

Sí, cada llamada completada incluye una transcripción completa de la conversación. Puedes acceder a ella haciendo clic en la llamada desde la lista de conversaciones.

</details>

<details>

<summary>¿Qué pasa si quiero cambiar la fecha de una llamada programada?</summary>

Actualmente, para cambiar la fecha debes cancelar la llamada programada y crear una nueva manualmente con la fecha deseada. Estamos trabajando en una función de reprogramación directa.

</details>

<details>

<summary>¿El agente puede agendar reuniones en mi calendario?</summary>

Sí, si configuras la integración con tu calendario y proporcionas al agente acceso a tu disponibilidad, puede agendar reuniones directamente durante la conversación.

</details>

<details>

<summary>¿Cuántos reintentos automáticos hace el sistema?</summary>

Por defecto, el sistema programa un reintento automático por llamada fallida o buzón de voz. Si el segundo intento también falla, no se programan más reintentos automáticos, pero puedes programar llamadas manualmente si lo deseas.

</details>

<details>

<summary>¿Puedo desactivar los seguimientos automáticos?</summary>

Actualmente los seguimientos automáticos están habilitados por defecto para todos los agentes de voz. Si prefieres gestionar los seguimientos manualmente, puedes cancelar las llamadas programadas automáticamente y crear las tuyas propias.

</details>

<details>

<summary>¿Cómo puedo comprar un número de teléfono para mi agente?</summary>

Para adquirir números de teléfono nacionales o internacionales, debes contactar con nuestro equipo de soporte:

* 📧 Email: <support@salescaling.com>
* 💬 Chat en vivo en la plataforma

Nuestro equipo te ayudará a elegir el número más adecuado según tu ubicación y necesidades. Disponemos de números en múltiples países.

</details>

<details>

<summary>¿Puedo usar mi propio número de teléfono?</summary>

Actualmente, los agentes de voz funcionan con números proporcionados por Salescaling. Si necesitas un número específico o quieres portar tu número existente, contacta con soporte para evaluar las opciones disponibles.

</details>

## Soporte

Si necesitas ayuda con los Agentes de Voz de IA:

* 📧 **Email**: <support@salescaling.com>
* 💬 **Chat en vivo**: Disponible en la plataforma (esquina inferior derecha)
* 📚 **Documentación**: [docs.salescaling.com](https://docs.salescaling.com)
* 🎥 **Tutoriales en video**: Próximamente
* 📞 **Soporte telefónico**: Disponible para clientes enterprise

### Recursos Relacionados

* [Tools (Herramientas) para Agentes de Voz](https://docs.salescaling.com/guias-practicas/agentes-de-voz-ia/tools-agentes-voz)
* [Gestión de Lista de No Llamar (Blacklist)](https://docs.salescaling.com/guias-practicas/gestion-de-blacklist)
* [Uso del Bot de Reuniones](https://docs.salescaling.com/guias-practicas/uso-bot-reuniones)
* [Integraciones de Calendarios](https://docs.salescaling.com/configuraciones-de-la-plataforma/integraciones/conectar-calendarios-y-videollamadas)
* [API de Webhooks](https://docs.salescaling.com/api/webhooks)

***

**Última actualización**: Diciembre 2024\
**Versión**: Beta 1.0
