Novità di Hermes v2026.7.7: WhatsApp Semplificato, Auto-Riparazione su Windows e Altro

Ciao a tutti, fan di Hermes! L’ultimo aggiornamento è arrivato, ed è davvero corposo. Ci siamo concentrati sul rendere la configurazione di WhatsApp un gioco da ragazzi, abbiamo aggiunto miglioramenti significativi alla stabilità per gli utenti Windows e rifinito alcune cose sotto il cofano. Vediamo tutto nel dettaglio.

WhatsApp: Ora con Bridge Integrato (Niente Account Meta Richiesto)

Una delle aggiunte più entusiasmanti è la nuova integrazione WhatsApp. Hermes ora si collega a WhatsApp tramite un bridge integrato basato su Baileys. Pensalo come un’emulazione di una sessione WhatsApp Web — niente account sviluppatore Meta, niente verifica Business, nessuno sbattimento.

Avvio rapido: Basta eseguire hermes gateway setup e selezionare WhatsApp per una procedura guidata passo-passo.

Due Modi per Usarlo

Modalità	Come funziona	Ideale per
Numero bot separato (consigliato)	Dedica un numero di telefono al bot. Le persone scrivono direttamente a quel numero.	UX pulita, più utenti, minor rischio di ban
Self-chat personale	Usa il tuo WhatsApp. Ti scrivi da solo per parlare con l’agente.	Configurazione rapida, utente singolo, test

Una Parola di Cautela

WhatsApp non supporta ufficialmente bot di terze parti al di fuori della loro Business API. Usare questo bridge comporta un piccolo rischio di restrizioni sull’account. Per stare al sicuro:

Usa un numero di telefono dedicato per il bot (non il tuo personale)
Non inviare messaggi in massa o spam — mantieni un tono conversazionale
Non automatizzare messaggi in uscita verso persone che non ti hanno scritto per prime

Inoltre, WhatsApp aggiorna periodicamente il loro protocollo Web, il che può temporaneamente rompere la compatibilità. Se il bot smette di funzionare dopo un aggiornamento di WhatsApp, basta scaricare l’ultima versione di Hermes e ri-associare.

Configurazione di WhatsApp: Passo dopo Passo

Passo 1: Esegui la Procedura Guidata

hermes whatsapp

La procedura:

Chiederà quale modalità vuoi (bot o self-chat)
Installerà le dipendenze del bridge se necessario
Mostrerà un codice QR nel tuo terminale
Aspetterà che tu lo scansiona

Per scansionare il codice QR:

Apri WhatsApp sul telefono
Vai su Impostazioni → Dispositivi collegati
Tocca Collega un dispositivo
Punta la fotocamera verso il codice QR nel terminale

Consiglio: Se il codice QR appare distorto, assicurati che il terminale sia largo almeno 60 colonne e supporti Unicode.

Passo 2: Ottenere un Secondo Numero di Telefono (Modalità Bot)

Per la modalità bot, ti serve un numero che non sia già registrato su WhatsApp. Ecco le tue opzioni:

Opzione	Costo	Note
Google Voice	Gratuito	Solo USA. Verifica WhatsApp via SMS tramite l’app Google Voice.
SIM prepagata	5–15 $ una tantum	Attiva, verifica, poi la SIM può stare in un cassetto. Tienila attiva con una chiamata ogni 90 giorni.
Servizi VoIP	Gratuito–5 $/mese	TextNow, TextFree, ecc. Alcuni numeri sono bloccati — provane un paio.

Passo 3: Configura Hermes

Aggiungi questo al tuo file ~/.hermes/.env:

# Obbligatorio
WHATSAPP_ENABLED=true
WHATSAPP_MODE=bot                          # "bot" o "self-chat"

# Controllo accessi — scegline UNO:
WHATSAPP_ALLOWED_USERS=15551234567         # Numeri separati da virgola (prefisso internazionale, senza +)
# WHATSAPP_ALLOWED_USERS=*                 # OPPURE permetti a tutti
# WHATSAPP_ALLOW_ALL_USERS=true            # OPPURE questo flag (equivalente a *)

Impostazioni comportamentali opzionali in ~/.hermes/config.yaml:

unauthorized_dm_behavior: pair

whatsapp:
  unauthorized_dm_behavior: ignore

unauthorized_dm_behavior: pair è il default globale — i mittenti di DM sconosciuti ricevono un codice di associazione.
whatsapp.unauthorized_dm_behavior: ignore mantiene WhatsApp silenzioso per i DM non autorizzati — di solito meglio per un numero privato.

Poi avvia il gateway:

hermes gateway              # In primo piano
hermes gateway install      # Installa come servizio utente
sudo hermes gateway install --system   # Solo Linux: servizio di sistema all'avvio

Persistenza della Sessione

Il bridge salva la sua sessione in ~/.hermes/platforms/whatsapp/session. Questo significa:

Le sessioni sopravvivono ai riavvii — niente più ri-scansione del codice QR ogni volta
I dati della sessione includono chiavi di crittografia e credenziali del dispositivo
Non condividere o committare questa directory di sessione — concede accesso completo all’account

Ri-Associazione

Se la sessione si rompe (reset del telefono, aggiornamento di WhatsApp, scollegamento manuale), vedrai errori di connessione nei log del gateway. Basta eseguire di nuovo hermes whatsapp per generare un nuovo codice QR e ri-associare.

Auto-Riparazione e Stabilità su Windows

Abbiamo anche aggiunto capacità di auto-riparazione per Windows. Il gateway ora rileva e recupera automaticamente dai guasti comuni del servizio, riducendo i tempi di inattività e l’intervento manuale. Questo fa parte del nostro impegno costante per rendere Hermes solidissimo su tutte le piattaforme.

Considerazioni Finali

Questo aggiornamento punta tutto a rendere Hermes più accessibile e affidabile. Che tu stia configurando WhatsApp per la prima volta o gestendo un bot in produzione, abbiamo pensato a te. Come sempre, scarica l’ultima versione e facci sapere come va!

Buona automazione! 🚀