# 🎙️ Auditor de Llamadas y Transcripción de Audios (OpenAI Whisper & Deepgram API)

> **Resumen para No Técnicos**: Permite que tu Inteligencia Artificial "escuche" las grabaciones de llamadas de tu equipo con clientes o los audios largos que te envían por WhatsApp, los convierta a texto con perfecta ortografía en español y te entregue un resumen con los puntos clave, quejas y compromisos acordados.

| Metadato | Detalle |
|---|---|
| **Tipo** | API REST Oficial de Transcripción de Voz a Texto (*Speech-to-Text*) |
| **Área Empresarial** | 04. Servicio al Cliente, Control de Calidad y Postventa |
| **Nivel de Dificultad** | 🟢 Fácil |
| **Modelo de Costo** | Pago por consumo ultra accesible (~$0.006 USD por minuto; transcribir un audio de 5 minutos cuesta 3 centavos de dólar) |
| **Enlace Oficial** | [OpenAI Whisper API](https://platform.openai.com/docs/guides/speech-to-text) / [Deepgram API](https://deepgram.com/) |

---

## 💡 ¿Para qué le sirve a tu empresa? (Valor Real)

En Latinoamérica, los clientes y proveedores prefieren **enviar audios de WhatsApp de 3 o 5 minutos** en lugar de escribir. 

Escuchar 40 audios al día toma horas de trabajo a tus empleados. Con esta API conectada a tu IA:
- El audio se transcribe a texto en 2 segundos.
- La IA extrae un resumen ejecutivo: *"El cliente Juan Pérez necesita 50 cajas del producto A para el viernes y pide descuento por volumen"*.
- Detecta el estado de ánimo del cliente (¿está satisfecho, indeciso o molesto?).

---

## 🎁 ¿Qué valor aporta frente a soluciones tradicionales?

- **Reconocimiento de Acentos en Español**: Entiende modismos y acentos de México, Colombia, Argentina, Chile, Perú, etc., incluso con ruido de fondo.
- **Auditoría de Calidad en Ventas**: Permite analizar si tus vendedores están siguiendo el protocolo de atención y ofreciendo las promociones vigentes.
- **Búsqueda en Historial de Llamadas**: Ahora puedes buscar dentro de las conversaciones pasadas por palabras clave (*"Garantía"*, *"Cancelación"*).

---

## 🔑 ¿Qué necesitas para activarlo?

1. Una cuenta de OpenAI o Deepgram.
2. Tu API Key secreta.
3. El archivo de audio (formato `.mp3`, `.m4a`, `.wav` u `.ogg`).

---

## ⚙️ Configuración Paso a Paso

Variables de entorno para tu flujo de trabajo:

```env
# Variables de entorno (.env)
OPENAI_API_KEY=tu_clave_openai_aqui
DEEPGRAM_API_KEY=tu_api_key_deepgram
IDIOMA_AUDIO_DEFAULT=es # Español
```

---

## 🤖 Consultor Interactivo (Prompt Guiado para tu IA)

Copia y pega este prompt en tu chat con la IA:

```markdown
Actúa como mi Auditor Senior de Experiencia del Cliente y Control de Calidad.
Vamos a analizar la transcripción de un audio o llamada comercial con un cliente.

Por favor, pregúntame:
1. ¿Cuál es el rol de nuestra empresa en la conversación y quiénes participan (ej: Vendedor vs. Cliente)?
2. ¿Cuál es el objetivo principal del análisis (detectar motivos de queja, identificar oportunidades de venta, o evaluar la calidad del asesor)?

Con la transcripción proporcionada, estructuraré:
- Resumen en 3 viñetas de los acuerdos comerciales.
- Sentimiento y nivel de satisfacción del cliente (Positivo, Neutro o Negativo/Frustrado).
- Lista de compromisos pendientes (Tareas a realizar con responsable).
- Recomendación de mejora para el asesor humano.
```

---

## 🌎 Caso de Uso Real en América Latina

**Empresa**: "Distribuidora Automotriz Central" (Venta de refacciones y repuestos en Bogotá, Colombia).
- **Problema**: Los mecánicos enviaban notas de voz de WhatsApp pidiendo repuestos con especificaciones técnicas complicadas mientras conducían, y los recepcionistas cometían errores al transcribir códigos de piezas.
- **Resultado con la API**: La IA transcribe el audio al instante, extrae el número de parte exacto y verifica en el inventario si hay existencias. Los despachos erróneos disminuyeron un 90%.

---

## 🛡️ Consideraciones de Privacidad

- **Consentimiento de Grabación**: Si grabas llamadas telefónicas de clientes, incluye siempre la advertencia legal al inicio: *"Esta llamada puede ser grabada y monitoreada para fines de calidad en el servicio"*.
- **No Almacenar Datos Bancarios**: Asegúrate de que las grabaciones de voz no contengan números de tarjetas de crédito o códigos de seguridad pronunciados por el cliente.