DoliPhone

DoliPhone para Dolibarr — Softphone WebRTC + Transcripción e Inteligencia Artificial

DoliPhone es el módulo que convierte Dolibarr en una central de comunicaciones completa. Integra un softphone WebRTC directamente en la interfaz del ERP, registra cada llamada de forma automática y, opcionalmente, transcribe y analiza el contenido de la conversación con inteligencia artificial para extraer resúmenes, clasificaciones y acciones de seguimiento sin salir de Dolibarr.

Compatible con cualquier servidor Asterisk, FreeSWITCH, Kamailio, ... que tenga WebSocket habilitado. Funciona desde cualquier navegador moderno, sin instalar ningún programa adicional.

---
🎯 Problema que resuelve

Cada llamada con un cliente genera información valiosa: compromisos adquiridos, incidencias reportadas, oportunidades detectadas. Sin embargo, esa información suele quedar en la memoria del agente o, en el mejor caso, en una nota redactada a mano después de la llamada.

DoliPhone automatiza todo el ciclo: la llamada se realiza desde Dolibarr, queda registrada en el CDR, se graba en estéreo, y la inteligencia artificial transcribe la conversación identificando a cada hablante, genera un resumen ejecutivo, clasifica el tipo de llamada y propone la próxima acción. Todo eso queda vinculado al tercero o contacto de Dolibarr, visible para el equipo en tiempo real.

---
📞 SOFTPHONE WEBRTC INTEGRADO

- El softphone se abre en una ventana independiente; al no tratarse de un popup, permite abrir las ventanas que necesites sin interferir en el funcionamiento del softphone
- Conexión a servidores Asterisk, FreeSWITCH, Kamailio, ... mediante WebSocket seguro (WSS) o no seguro (WS)
- Realización y recepción de llamadas VoIP directamente desde el navegador, sin plugins
- Registro SIP automático al iniciar sesión, con refresco manual bajo demanda
- Detección y apertura automática de la ficha del tercero/contacto en llamadas entrantes
- Notificación visual de llamada entrante con nombre e información del contacto identificado
- Llamada saliente con un clic desde fichas de terceros, contactos y usuarios
- Estado de registro SIP en tiempo real (Registrado / Conectando / Desconectado)

---
🎛 FUNCIONES DEL MARCADOR

- Grabar todas las llamadas: grabación automática en formato WebM estéreo (canal izquierdo = agente, canal derecho = interlocutor) con subida automática al terminar la llamada
- Llamada en espera (Hold): pausa la llamada con silencio automático del micrófono; el interlocutor escucha música de espera del servidor PBX
- No molestar (DND): envía estado DND al servidor; las entrantes se rechazan automáticamente
- Respuesta automática: contesta las llamadas entrantes sin intervención manual, ideal para call centers y soporte técnico
- Refresco de registro SIP: reconecta al servidor con un clic sin necesidad de recargar la página
- Silencio: desactiva el micrófono durante la llamada sin cortarla

---
📋 REGISTRO DE LLAMADAS (CDR)

- Registro completo de todas las llamadas: fecha, duración total, tiempo de conversación efectiva (billsec), número origen, número destino, dirección y estado de terminación
- Vinculación automática con terceros y contactos de Dolibarr por coincidencia de número de teléfono
- Herramienta de auto-asociación masiva que recorre todos los CDR sin tercero asignado y los vincula automáticamente
- Reproductor de audio integrado en la lista de llamadas para escuchar grabaciones sin salir de la pantalla
- Descarga directa de grabaciones en formato WebM
- Pestañas de "Llamadas" integradas en fichas de terceros, contactos e internos (usuarios)
- Filtros avanzados: por fecha, por usuario, solo transcritas, pendientes de transcribir, con grabación
- Dashboard con KPIs: total de llamadas, llamadas transcritas, pendientes, duración media, distribución entrante/saliente

---
🤖 INTELIGENCIA ARTIFICIAL Y TRANSCRIPCIÓN

DoliPhone incluye un pipeline completo de IA en tres pasos: transcripción → diarización → análisis.

Transcripción automática con Whisper
- Detección automática del idioma del audio (no requiere configuración del idioma de la grabación)
- Tres modos de activación: manual (botón por llamada), automático para todos los usuarios, automático solo para usuarios seleccionados
- Compatible con grabaciones en cualquier idioma

Diarización: identificación de hablantes
- DoliPhone identifica quién habla en cada momento y asigna un color distinto a cada interlocutor
- En grabaciones estéreo: separa los canales automáticamente con ffmpeg (canal izquierdo = agente, canal derecho = cliente)
- En grabaciones mono: usa el modelo de IA para identificar los cambios de turno por contexto y pausas
- La transcripción se muestra como un diálogo visual con una barra de color por hablante y leyenda de participantes

Análisis con prompt personalizable
- El administrador configura un prompt global que define el comportamiento del análisis
- El prompt controla el idioma de respuesta: si el prompt indica "responde en inglés", tanto el resumen como la transcripción aparecerán en inglés
- La IA genera automáticamente:
  - Resumen ejecutivo de la conversación (máximo 3 frases)
  - Tipo de llamada: venta, soporte, consulta, queja, seguimiento, spam u otro
  - Próxima acción sugerida: tarea concreta para el agente
- Si la transcripción está en un idioma distinto al del prompt, la IA traduce el diálogo automáticamente y conserva el original accesible con un clic

---
🗂 POLÍTICA DE RETENCIÓN AUTOMÁTICA (RGPD)

DoliPhone incluye un sistema de retención configurable que se ejecuta vía cron de Dolibarr:

- CDR completo: elimina los registros de llamada (con su grabación) pasado un número de días configurable
- Solo grabaciones: borra los ficheros de audio del disco sin tocar el registro CDR
- Solo transcripciones e IA: pone a NULL todos los campos de IA (transcripción, resumen, tipo, acciones) preservando el CDR y la grabación

Cada elemento tiene su propio período de retención independiente. El panel de administración muestra en tiempo real cuántos registros se verían afectados con la configuración actual antes de ejecutar la limpieza.

---
🧩 QUÉ INCLUYE EL MÓDULO

- Descriptor de módulo con permisos granulares (leer propios / leer todos / crear-modificar)
- Panel de administración completo: servidor SIP, modelos de IA, modo de transcripción, prompt personalizable, rutas avanzadas, retención automática
- Dashboard de IA con tarjetas KPI y acceso directo a listas filtradas
- Pestañas "Llamadas" integradas en terceros, contactos e internos
- Pipeline de IA completo: Whisper + diarización estéreo/mono + análisis
- AJAX para transcripción en tiempo real desde la lista de llamadas sin recargar la página
- Retención automática configurable por elemento y período (RGPD)
- Cron de limpieza automática registrado en el sistema de tareas programadas de Dolibarr
- Basado en Innovate Asterisk Softphone y JsSIP (biblioteca de código abierto para SIP sobre WebRTC)

---
⚙ COMPATIBILIDAD Y REQUISITOS

- 📦 Dolibarr 17.0 o superior (compatible con V17+)
- ⚙  PHP 7.4 – 8.3+
- 🗄  MySQL 5.7+ / MariaDB 10.2+
- 🌐 Navegador con soporte WebRTC: Chrome, Firefox, Edge, Safari
- 📡 Servidor SIP con WebSocket habilitado (Asterisk 18+, FreeSWITCH, Kamailio, ...)
- 🔒 HTTPS obligatorio en el servidor Dolibarr (requisito del navegador para acceder al micrófono)
- 🎬 ffmpeg (opcional): necesario para diarización estéreo. Instalación: `apt install ffmpeg` en Debian/Ubuntu, `dnf install ffmpeg` en RHEL/Rocky/AlmaLinux, o descarga desde ffmpeg.org en Windows
- 🤖 API key de OpenAI para funciones de IA (la transcripción y el softphone funcionan sin IA)
- 📄 Licencia GPL v3 — software libre, puedes usarlo, modificarlo y redistribuirlo libremente

---
🖥 DEMO DISPONIBLE

Puedes probar DoliPhone en nuestra instalación de demostración:

🌐 https://dolibarr.igontek.com

Acceso de agente 1: usuario demo.200 / contraseña demo.200
Acceso de agente 2: usuario demo.201 / contraseña demo.201

Para poder probar el sistema de transcripciones, ha de configurar una API de ChatGPT. No olvide eliminar los datos después de las pruebas.

---
✉ SOPORTE

Soporte técnico por email: dolibarr@igontek.com
Desarrollado y mantenido por Igontek — https://igontek.com