DoliPhone

DoliPhone per Dolibarr — Softphone WebRTC + Trascrizione e Intelligenza Artificiale

DoliPhone è il modulo che trasforma Dolibarr in una centrale di comunicazioni completa. Integra un softphone WebRTC direttamente nell'interfaccia dell'ERP, registra automaticamente ogni chiamata e, facoltativamente, trascrive e analizza il contenuto della conversazione con l'intelligenza artificiale per estrarre riassunti, classificazioni e azioni di follow-up senza uscire da Dolibarr.

Compatibile con qualsiasi server Asterisk, FreeSWITCH, Kamailio, ... con WebSocket abilitato. Funziona da qualsiasi browser moderno, senza installare software aggiuntivo.

---
🎯 Problema che risolve

Ogni chiamata con un cliente genera informazioni preziose: impegni presi, problemi segnalati, opportunità identificate. Tuttavia, queste informazioni restano spesso nella memoria dell'operatore o, nel migliore dei casi, in un appunto scritto a mano dopo la chiamata.

DoliPhone automatizza l'intero ciclo: la chiamata viene effettuata da Dolibarr, registrata nel CDR, acquisita in stereo, e l'intelligenza artificiale trascrive la conversazione identificando ogni interlocutore, genera un riassunto esecutivo, classifica il tipo di chiamata e propone la prossima azione. Tutto ciò viene collegato al terzo o al contatto di Dolibarr, visibile al team in tempo reale.

---
📞 SOFTPHONE WEBRTC INTEGRATO

- Il softphone si apre in una finestra indipendente; non essendo un popup, è possibile aprire tutte le finestre necessarie senza interferire con il funzionamento del softphone
- Connessione ai server Asterisk, FreeSWITCH, Kamailio, ... tramite WebSocket sicuro (WSS) o non sicuro (WS)
- Effettuare e ricevere chiamate VoIP direttamente dal browser, senza plugin
- Registrazione SIP automatica all'accesso, con aggiornamento manuale su richiesta
- Rilevamento e apertura automatica della scheda terzo/contatto nelle chiamate in entrata
- Notifica visiva di chiamata in entrata con nome e informazioni del contatto identificato
- Chiamata in uscita con un clic dalle schede terzi, contatti e utenti
- Stato di registrazione SIP in tempo reale (Registrato / Connessione / Disconnesso)

---
🎛 FUNZIONI DEL TASTIERINO

- Registrare tutte le chiamate: registrazione automatica in WebM stereo (canale sinistro = agente, canale destro = interlocutore) con caricamento automatico al termine della chiamata
- Chiamata in attesa (Hold): mette in pausa la chiamata con silenziamento automatico del microfono; l'interlocutore sente la musica di attesa del server PBX
- Non disturbare (DND): invia lo stato DND al server; le chiamate in entrata vengono rifiutate automaticamente
- Risposta automatica: risponde alle chiamate in entrata senza intervento manuale, ideale per call center e supporto tecnico
- Aggiornamento registrazione SIP: si riconnette al server con un clic senza ricaricare la pagina
- Silenzio: disattiva il microfono durante la chiamata senza riagganciare

---
📋 REGISTRO CHIAMATE (CDR)

- Registrazione completa di tutte le chiamate: data, durata totale, tempo di conversazione effettivo (billsec), numero di origine, numero di destinazione, direzione e stato di terminazione
- Collegamento automatico con i terzi e i contatti di Dolibarr per corrispondenza del numero di telefono
- Strumento di auto-associazione massiva che esamina tutti i record CDR senza terzo assegnato e li collega automaticamente
- Lettore audio integrato nell'elenco chiamate per ascoltare le registrazioni senza lasciare la schermata
- Download diretto delle registrazioni in formato WebM
- Schede "Chiamate" integrate nelle schede terzi, contatti e interni (utenti)
- Filtri avanzati: per data, per utente, solo trascritte, in attesa di trascrizione, con registrazione
- Dashboard con KPI: totale chiamate, chiamate trascritte, in attesa, durata media, distribuzione in entrata/uscita

---
🤖 INTELLIGENZA ARTIFICIALE E TRASCRIZIONE

DoliPhone include una pipeline IA completa in tre fasi: trascrizione → diarizzazione → analisi.

Trascrizione automatica con Whisper
- Rilevamento automatico della lingua dall'audio (non è necessaria la configurazione della lingua di registrazione)
- Tre modalità di attivazione: manuale (pulsante per chiamata), automatico per tutti gli utenti, automatico solo per gli utenti selezionati
- Compatibile con registrazioni in qualsiasi lingua

Diarizzazione: identificazione degli interlocutori
- DoliPhone identifica chi parla in ogni momento e assegna un colore diverso a ogni interlocutore
- Per le registrazioni stereo: separa automaticamente i canali con ffmpeg (canale sinistro = agente, canale destro = cliente)
- Per le registrazioni mono: usa il modello IA per identificare i cambi di turno dal contesto e dalle pause
- La trascrizione viene visualizzata come un dialogo visivo con una barra di colore per interlocutore e una legenda dei partecipanti

Analisi con prompt personalizzabile
- L'amministratore configura un prompt globale che definisce il comportamento dell'analisi
- Il prompt controlla la lingua della risposta: se il prompt indica "rispondi in italiano", sia il riassunto che la trascrizione appariranno in italiano
- L'IA genera automaticamente:
  - Riassunto esecutivo della conversazione (massimo 3 frasi)
  - Tipo di chiamata: vendita, supporto, richiesta, reclamo, follow-up, spam o altro
  - Prossima azione suggerita: compito concreto per l'agente
- Se la trascrizione è in una lingua diversa dal prompt, l'IA traduce automaticamente il dialogo e mantiene l'originale accessibile con un clic

---
🗂 POLITICA DI CONSERVAZIONE AUTOMATICA (GDPR)

DoliPhone include un sistema di conservazione configurabile che viene eseguito tramite il cron di Dolibarr:

- CDR completo: elimina i record delle chiamate (con la relativa registrazione) dopo un numero configurabile di giorni
- Solo registrazioni: elimina i file audio dal disco senza toccare il record CDR
- Solo trascrizioni e IA: imposta a NULL tutti i campi IA (trascrizione, riassunto, tipo, azioni) conservando il CDR e la registrazione

Ogni elemento ha il proprio periodo di conservazione indipendente. Il pannello di amministrazione mostra in tempo reale quanti record sarebbero interessati dalla configurazione attuale prima di eseguire la pulizia.

---
🧩 COSA INCLUDE IL MODULO

- Descrittore di modulo con permessi granulari (leggere i propri / leggere tutti / creare-modificare)
- Pannello di amministrazione completo: server SIP, modelli IA, modalità di trascrizione, prompt personalizzabile, percorsi avanzati, conservazione automatica
- Dashboard IA con schede KPI e accesso diretto agli elenchi filtrati
- Schede "Chiamate" integrate in terzi, contatti e interni
- Pipeline IA completa: Whisper + diarizzazione stereo/mono + analisi
- AJAX per la trascrizione in tempo reale dall'elenco chiamate senza ricaricare la pagina
- Conservazione automatica configurabile per elemento e periodo (GDPR)
- Cron di pulizia automatica registrato nel sistema di attività pianificate di Dolibarr
- Basato su Innovate Asterisk Softphone e JsSIP (libreria open source per SIP su WebRTC)

---
⚙ COMPATIBILITÀ E REQUISITI

- 📦 Dolibarr 17.0 o superiore (compatibile con V17+)
- ⚙  PHP 7.4 – 8.3+
- 🗄  MySQL 5.7+ / MariaDB 10.2+
- 🌐 Browser con supporto WebRTC: Chrome, Firefox, Edge, Safari
- 📡 Server SIP con WebSocket abilitato (Asterisk 18+, FreeSWITCH, Kamailio, ...)
- 🔒 HTTPS obbligatorio sul server Dolibarr (requisito del browser per accedere al microfono)
- 🎬 ffmpeg (facoltativo): necessario per la diarizzazione stereo. Installazione: `apt install ffmpeg` su Debian/Ubuntu, `dnf install ffmpeg` su RHEL/Rocky/AlmaLinux, o scarica da ffmpeg.org su Windows
- 🤖 Chiave API OpenAI per le funzioni IA (la trascrizione e il softphone funzionano senza IA)
- 📄 Licenza GPL v3 — software libero, puoi usarlo, modificarlo e ridistribuirlo liberamente

---
🖥 DEMO DISPONIBILE

Puoi provare DoliPhone sulla nostra installazione dimostrativa:

🌐 https://dolibarr.igontek.com

Accesso agente 1: utente demo.200 / password demo.200
Accesso agente 2: utente demo.201 / password demo.201

Per testare il sistema di trascrizione, è necessario configurare una chiave API ChatGPT. Ricordati di eliminare i dati dopo i test.

---
✉ SUPPORTO

Supporto tecnico via email: dolibarr@igontek.com
Sviluppato e mantenuto da Igontek — https://igontek.com