# HidaChat
[](README.it.md)
[](README.md)
**Client Desktop Portabile per Windows (.NET 9 / WPF)** con gestione **Multi-Account e Multi-Piattaforma** (**WhatsApp Web**, **Telegram Web**, **OpenClaw** ed **Hermes Agent**), **Pre-caricamento Istantaneo in Background**, **Traduzione Integrata dei Messaggi**, **Notifiche Native Windows Toast & Popup** e **Zero Installazione**.
[](LICENSE.txt)
[](https://dotnet.microsoft.com/)
[](https://github.com/hidaba/HidaChat/releases/latest)
[](https://github.com/hidaba/HidaChat/releases)
[](https://github.com/hidaba/HidaChat/releases)
[](https://github.com/hidaba/HidaChat/commits/master)
[](https://github.com/hidaba/HidaChat/actions)
[](#-multi-account--multi-piattaforma-whatsapp-telegram-openclaw-hermes)
[](#-guida-alla-connessione-degli-account-openclaw-ed-hermes-agent-passo-passo)
[](#-guida-alla-connessione-degli-account-openclaw-ed-hermes-agent-passo-passo)
---
## 📸 Demo Animata & Anteprima
| **Interfaccia Multi-Account (Tema Scuro)** | **Traduzione Istantanea Messaggio** |
|:---:|:---:|
|  |  |
| **Notifiche Native Windows Toast** | **Temi Chiaro e Scuro** |
|  |  |
---
## 📦 Download & Installazione Rapida per Windows
### Opzione 1: Installazione tramite Windows Package Manager (`winget`)
```powershell
winget install hidaba.HidaChat
```
### Opzione 2: Archivio Portatile ZIP (Nessuna installazione)
Scegli tra la **Versione Stabile** (testata, consigliata per l'uso quotidiano) e l'**Ultima Versione Beta** (anteprima delle ultime novità, miglioramenti e correzioni):
| Canale | Versione Corrente | Stato | Link per Scaricare |
|---|---|:---:|:---:|
| 🟢 **Release Stabile** | [](https://github.com/hidaba/HidaChat/releases/latest) | `Consigliata` | ⬇️ **[Scarica ZIP Versione Stabile](https://github.com/hidaba/HidaChat/releases/latest)** |
| 🟠 **Ultima Versione Beta** | [](https://github.com/hidaba/HidaChat/releases) | `Anteprima` | ⬇️ **[Scarica ZIP Ultima Beta](https://github.com/hidaba/HidaChat/releases)** |
- 📂 **Avvio rapido**: Estrai l'archivio ZIP in qualsiasi cartella (locale o chiavetta USB) ed avvia `HidaChat.exe`.
- 🔄 **Aggiornamenti automatici (OTA)**: HidaChat include il controllo e l'aggiornamento automatico integrato. Puoi attivare o disattivare la ricezione delle versioni Beta in qualsiasi momento dalle **Impostazioni** (`Ctrl+,`).
> 🔒 **Portabilità e Lock Multi-PC (`data/.lock`)**: HidaChat è un'applicazione al 100% portabile (tutti i dati, profili e impostazioni risiedono esclusivamente all'interno della cartella dell'app). Per prevenire la corruzione dei database LevelDB di WebView2 e la perdita delle sessioni, HidaChat applica un lock a livello di filesystem (`data/.lock`): l'esecuzione contemporanea da più computer o processi che condividono la stessa cartella viene intercettata e bloccata con segnalazione diagnostica di host, utente e PID.
---
## 🌟 Perché HidaChat? (Confronto)
| Caratteristica | HidaChat | WhatsApp Desktop Ufficiale | Telegram Desktop Ufficiale | Altus (`amanharwara/altus`) |
|---|:---:|:---:|:---:|:---:|
| **Installazione Richiesta** | ❌ **Nessuna (Portabile)** | ✅ Richiesta | ✅ Richiesta | ✅ Richiesta |
| **Dati Spostabili (USB/Rete)** | ✅ **Sì (ZIP / USB)** | ❌ No | ❌ No | ❌ No |
| **Multi-Piattaforma in 1 App** | ✅ **Sì (4 Piattaforme)** | ❌ Solo WhatsApp | ❌ Solo Telegram | ❌ Solo WhatsApp |
| **Gateway Agenti IA (OpenClaw & Hermes)** | ✅ **Sì (via Tailscale Mesh e Locale)** | ❌ No | ❌ No | ❌ No |
| **Schede Multi-Account** | ✅ **Sì (Profili Isolati)** | ❌ No | ⚠️ Solo selettore | ✅ Sì |
| **Invio Massivo (Excel & CSV)** | ✅ **Sì (WhatsApp & Telegram)** | ❌ No | ❌ No | ❌ No |
| **Pre-caricamento Istantaneo** | ✅ **Sì (Zero Ricaricamento)** | ❌ No | ❌ No | ❌ No |
| **Traduttore Messaggi Integrato** | ✅ **Sì (Hover + Pagina)** | ❌ No | ⚠️ Base | ❌ No |
| **Notifiche Native & Popup** | ✅ **Sì** | ✅ Sì | ✅ Sì | ✅ Sì |
| **Motore Render** | **WebView2 (Nativo Win)** | Electron | Nativo C++ / Qt | Electron |
| **Open Source** | ✅ **Sì (Apache-2.0)** | ❌ No | ⚠️ GPL | ✅ Sì |
---
## 🚀 Caratteristiche Principali
### 📊 Invio Massivo Multi-Piattaforma (Automazione Excel & CSV)
- **Importazione da Excel & CSV**: Carica direttamente rubriche ed elenchi contatti da file `.xlsx`, `.xls` o `.csv` con mappatura automatica intelligente delle colonne (*Telefono*, *Nome*, *Cognome*, *Azienda*, *Testo personalizzato*, *Username*).
- **Supporto WhatsApp & Telegram**: Invio sequenziale automatizzato sia per **WhatsApp Web** che per **Telegram Web** (tramite `@username` o numero di telefono).
- **Template Dinamici & Segnaposto**: Componi messaggi personalizzati utilizzando i tag segnaposto (`{Nome}`, `{Cognome}`, `{Azienda}`, `{Telefono}`, `{Username}`, `{Testo}`) con pulsanti di inserimento rapido e anteprima in tempo reale.
- **Ispettore Messaggi Dettagliato**: Visualizza in anteprima il messaggio formattato multilinea completo di emoji e link prima dell'invio con fedeltà 1:1.
- **Protezione Anti-Spam (Jitter Delay)**: Intervallo casuale di sicurezza naturale configurabile con vincolo minimo di **30 secondi** e conto alla rovescia in tempo reale per proteggere gli account dal blocco spam.
- **Controlli Completi di Esecuzione**: Pausa, Riprendi, Interrompi subito e monitoraggio dello stato puntuale di ogni riga (`In attesa`, `Inviando...`, `Inviato ✔`, `Errore ✖`, `Non valido`).
### 👥 Multi-Account & Multi-Piattaforma (WhatsApp, Telegram, OpenClaw, Hermes)
- **4 Ecosistemi Supportati**: Gestisci schede orizzontali simultanee per messaggistica istantanea e agenti IA autonomi:
- 🟢 **WhatsApp Web**: Client web completo con login QR, messaggistica istantanea, anteprima allegati audio/video, traduzione istantanea al passaggio del mouse e integrazione invio massivo.
- 🔷 **Telegram Web**: Pieno supporto per Telegram Web A, K e Z con integrazione nativa della Badging API (`navigator.setAppBadge`), eliminazione dei falsi positivi unread e notifiche istantanee.
- 🟠 **OpenClaw (Autonomous AI Agent Gateway & Web UI)**: Supporto nativo per la console web OpenClaw. Connessione trasparente a gateway locali (`http://127.0.0.1:18789`) o host remoti su reti private Tailscale tramite il demone companion `tsnetd.exe` (Go statico). Utilizza porte proxy locali deterministiche (`18800+`) e token persistente per mantenere stabili le chiavi crittografiche Ed25519 in IndexedDB, eliminando la richiesta continua di riapprovazione del dispositivo (`openclaw devices approve`).
- 🌐 **Hermes Agent (Nous Research)**: Dashboard e console web per istanze Hermes AI Agent. Dotato di iniezione automatica dell'header `Authorization: Bearer ` in WebView2, connettività locale diretta (`http://127.0.0.1:9119`), routing remoto cifrato tramite Tailscale Mesh VPN (`18900+`) e branding grafico a tema elmo alato azzurro ciano (`#00B0FF`).
- **Profili WebView2 Isolati**: Ciascun account opera in una sandbox completamente isolata (cookie, sessioni, cache e storage separati in `data/webview/`).
- **Pre-caricamento Istantaneo**: All'avvio dell'app viene data priorità all'account attivo e avviato in background il caricamento degli altri account, consentendo un passaggio immediato da una scheda all'altra senza tempi di attesa né schermate nere.
- **Selettore Piattaforma Rapido**: Con il pulsante `+` o dalle Impostazioni puoi creare istantaneamente un nuovo account WhatsApp, Telegram, OpenClaw o Hermes con icona e colore distintivo dedicato.
- **Notifiche Sempre Attive in Background**: Anche mentre interagisci con una console agente IA o un'altra scheda, le chat continuano a ricevere messaggi in tempo reale e generano notifiche Toast e Popup su schermo.
### 🌐 Motore di Traduzione Integrato
- **Pulsante al Passaggio del Mouse**: Passa il puntatore su qualsiasi messaggio in entrata o uscita per mostrare il pulsante di traduzione rapida.
- **Traduzione Intera Pagina**: Traduci con un solo click tutte le conversazioni visibili.
- **Compatibilità Totale**: Supporta la struttura DOM dei messaggi sia di WhatsApp Web che di Telegram Web K.
### 🎨 Temi e Gestione Finestra
- **Modalità Scura/Chiara Automatica**: Sincronizzazione automatica con il tema di Windows o selezione manuale, con iniezione CSS e JavaScript personalizzati per WhatsApp e Telegram.
- **Ingrandimento Schermo Intero Ottimizzato**: Finestra senza bordi che rispetta l'Area di Lavoro e la barra delle applicazioni di Windows (Taskbar) su tutti i monitor, con supporto al ripristino per trascinamento e ridimensionamento fluido.
### 🔔 Notifiche e System Tray
- **Toast Windows & Popup Overlay**: Notifiche interattive che aprono direttamente la scheda dell'account e la conversazione di origine al click.
- **Integrazione System Tray**: Riduzione nell'area di notifica con indicatore visivo per i messaggi non letti.
- **Aggiornamenti OTA Sicuri**: Controllo in background e download diretto delle nuove versioni da GitHub Releases con **verifica crittografica dell'integrità SHA-256**.
---
## 💻 Requisiti di Sistema
- **OS**: Windows 10 (build 19041 o successiva) / Windows 11
- **Installazione**: **Zero Installazione** (distribuzione portabile in archivio ZIP: non richiede setup né installatori, non modifica il registro di Windows né scrive in cartelle esterne)
- **Framework**: [.NET 9.0 Desktop Runtime](https://dotnet.microsoft.com/download/dotnet/9.0) (Windows Desktop x64)
- **Web Runtime**: [Microsoft Edge WebView2 Runtime](https://developer.microsoft.com/microsoft-edge/webview2/) (incluso di serie in Windows 11 e nelle versioni recenti di Windows 10)
---
## 🛠️ Compilazione da Sorgente
Per compilare ed eseguire il progetto localmente:
```bash
# Clona il repository
git clone https://github.com/hidaba/HidaChat.git
cd HidaChat
# Ripristina le dipendenze e compila
dotnet restore
dotnet build -c Release
```
In alternativa, puoi aprire la soluzione `HidaChat.sln` con **Visual Studio 2022** (.NET 9 SDK installato) e premere `F5`.
---
## 📖 Guida Rapida all'Uso
1. **Aggiunta Account**: Avvia `HidaChat.exe`. Clicca sul pulsante `+` nella barra delle schede in alto e seleziona **WhatsApp**, **Telegram**, **OpenClaw** o **Hermes Agent**.
2. **Accesso e Connessione**:
- **WhatsApp**: Inquadra il codice QR con l'app WhatsApp dello smartphone (*Dispositivi collegati*).
- **Telegram**: Inquadra il codice QR con l'app Telegram o accedi con numero di telefono e codice SMS.
- **OpenClaw**: Inserisci l'URL del Gateway (default `http://127.0.0.1:18789` o indirizzo/hostname Tailnet) e il Token di Autenticazione. Attiva **Integrazione Rete Mesh Tailscale** per connetterti a un'istanza remota senza installare il client Tailscale sul PC. Clicca **Verifica Connessione**.
- **Hermes Agent**: Inserisci l'URL del server (default `http://127.0.0.1:9119` o indirizzo Tailnet) e il Token / API Key (iniettato automaticamente come Bearer token). Attiva **Integrazione Rete Mesh Tailscale** se necessario, e clicca **Verifica Connessione**.
3. **Rinomina Schede e Impostazioni**: Fai clic con il tasto destro sulla scheda desiderata e seleziona **Rename** per personalizzarne il nome, oppure gestisci gli account dalla finestra Impostazioni (⚙️).
4. **Traduzione**: Passa il mouse su qualsiasi messaggio WhatsApp o Telegram per visualizzare l'icona di traduzione istantanea 🌐.
### 🕹️ Controlli della Barra del Titolo
| Icona | Azione |
| :---: | :--- |
| 📊 | Apre l'Invio Massivo da Excel / CSV (messaggistica personalizzata automatizzata) |
| ⚙️ | Apre la finestra Impostazioni (tema, lingua, gestione account, canale beta) |
| 🔄 | Ricarica la scheda dell'account attivo |
| ⓘ | Informazioni su HidaChat (versione, licenza, percorso portabile) |
| ✕ / — | Minimizza o riduci nella barra delle applicazioni / tray |
---
## 🤖 Guida alla Connessione degli Account OpenClaw ed Hermes Agent (Passo-passo)
HidaChat consente di affiancare ai tradizionali sistemi di messaggistica istantanea i gateway e le console web per agenti IA autonomi. Ciascuna scheda opera in una sandbox WebView2 isolata con memoria persistente, zero latenza di commutazione e pre-caricamento immediato in background.
### 🟠 1. OpenClaw (Autonomous AI Agent Gateway & Web UI)
OpenClaw connette HidaChat alle tue istanze di agenti IA autonomi in esecuzione in locale o su server privati.
1. **Aggiunta dell'Account**: Clicca sul pulsante `+` nella barra delle schede in alto e seleziona **OpenClaw** (oppure vai in **Impostazioni (⚙️) ➔ Account ➔ Aggiungi account** e imposta **OpenClaw** nel menu a tendina della piattaforma).
2. **URL Gateway / Tailscale**:
- **Istanza locale**: Mantieni l'indirizzo predefinito `http://127.0.0.1:18789`.
- **Istanza remota o su nodo Tailnet**: Inserisci l'indirizzo IP privato Tailscale o l'hostname del server (es. `http://100.x.y.z:18789` o `http://mio-nodo-openclaw:18789`).
3. **Token di Autenticazione Gateway**:
- Inserisci il token segreto impostato nella configurazione del gateway OpenClaw (da `openclaw.json` o parametro da riga di comando `--token`).
4. **Integrazione Rete Mesh Tailscale (tsnet portatile)**:
- **Connessione locale o LAN diretta**: Lascia deselezionata la casella **"Usa nodo Tailscale integrato (tsnet portatile)"**. HidaChat comunicherà direttamente via HTTP standard.
- **Rete privata mesh Tailscale**: Se il tuo server OpenClaw si trova su una Tailnet remota privata e non disponi (o non desideri installare) del client Tailscale sul PC Windows host, spunta la casella **"Usa nodo Tailscale integrato (tsnet portatile)"**.
- **Proxy Deterministico & Conservazione Identità Dispositivo**: HidaChat avvia in background il companion daemon integrato (`tsnetd.exe`) aprendo una porta proxy locale fissa (`18800+`). Questo fa sì che la coppia di chiavi crittografiche Ed25519 memorizzata in IndexedDB rimanga permanente, azzerando del tutto le continue richieste di riapprovazione del dispositivo (`openclaw devices approve`).
5. **Verifica & Salvataggio**:
- Clicca su **Test Connessione**: un messaggio verde confermerà la corretta raggiungibilità dell'endpoint e la validità del token.
- Seleziona la scheda OpenClaw nella finestra principale per iniziare a interagire con il tuo agente.
---
### 🌐 2. Hermes Agent (Nous Research)
Hermes Agent mette a disposizione una dashboard web e console reattiva per i modelli e workflow di agenti Nous Research Hermes.
1. **Aggiunta dell'Account**: Clicca su `+` nella barra delle schede e seleziona **Hermes Agent** (oppure dalle **Impostazioni ➔ Account** seleziona **Hermes Agent**).
2. **URL Server**:
- **Istanza locale**: Predefinito `http://127.0.0.1:9119`.
- **Server remoto o Tailnet**: Inserisci l'indirizzo IP o l'hostname di rete (es. `http://100.x.y.z:9119`).
3. **Token di Autenticazione / API Key**:
- Inserisci la tua API Key o Bearer Token dell'istanza Hermes.
- **Iniezione Automatica Bearer Token**: Il motore WebView2 di HidaChat inietta in modo trasparente l'header HTTP `Authorization: Bearer ` in tutte le richieste verso il server, effettuando il login automatico senza richiedere ulteriori credenziali nella console web.
4. **Modalità Rete Mesh Tailscale**:
- Per server remoti accessibili tramite Tailscale, spunta **"Usa nodo Tailscale integrato"** (assegna la porta deterministica `18900+`).
5. **Test Connessione**:
- Clicca su **Test Connessione** per validare l'accesso, quindi passa alla scheda Hermes per inviare prompt ed eseguire comandi.
---
## 🗺️ Roadmap e Changelog
Consulta il file [CHANGELOG.md](CHANGELOG.md) per lo storico delle versioni e le ultime novità.
---
## 🤝 Contributi e Sicurezza
- **Contribuire**: Leggi le linee guida in [CONTRIBUTING.md](CONTRIBUTING.md) prima di inviare nuove Pull Request.
- **Sicurezza**: Per segnalare vulnerabilità di sicurezza, consulta [SECURITY.md](SECURITY.md).
- **Codice di Condotta**: Il progetto adotta il [Contributor Covenant Code of Conduct](CODE_OF_CONDUCT.md).
---
## 📄 Licenza
Distribuito sotto licenza **Apache 2.0**. Consulta il file [LICENSE.txt](LICENSE.txt) per i dettagli.
---
## 🏷️ Tag di Ricerca e Parole Chiave
`openclaw` · `openclaw-gateway` · `hermes` · `hermes-agent` · `nous-research` · `ai-agents` · `ai-gateway` · `tailscale` · `tsnet` · `mesh-vpn` · `whatsapp-web` · `telegram-web` · `multi-account` · `portable-app` · `dotnet9` · `wpf` · `webview2` · `desktop-client` · `bulk-sender` · `translation` · `windows-desktop`