# 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](/guias-practicas/gestion-de-blacklist.md)
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](/guias-practicas/gestion-de-blacklist.md))
* ❌ 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](/guias-practicas/gestion-de-blacklist.md) 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](/guias-practicas/gestion-de-blacklist.md).

## 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](/guias-practicas/gestion-de-blacklist.md) 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](/guias-practicas/agentes-de-voz-ia/tools-agentes-voz.md)
* [Gestión de Lista de No Llamar (Blacklist)](/guias-practicas/gestion-de-blacklist.md)
* [Uso del Bot de Reuniones](/guias-practicas/uso-bot-reuniones.md)
* [Integraciones de Calendarios](/configuraciones-de-la-plataforma/integraciones/conectar-calendarios-y-videollamadas.md)
* [API de Webhooks](/api/webhooks.md)

***

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


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.salescaling.com/guias-practicas/agentes-de-voz-ia.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
