WeCom — Assistente AI Aziendale

Immagina di avere un collega super intelligente che vive dentro la WeChat della tua azienda, pronto a rispondere a domande, inviare file e gestire attività 24 ore su 24, 7 giorni su 7. È esattamente ciò che Hermes Agent ti permette di costruire con WeCom (WeChat Enterprise).

Perché WeCom + Hermes?

WeCom è l’app di messaggistica business di Tencent, pensala come una WhatsApp per le aziende. Hermes collega direttamente il tuo assistente AI a WeCom, così il tuo team può chattare con il bot come farebbe con un collega. Niente webhook complicati, niente server pubblico, niente mal di testa IT. La connessione rimane aperta in background, come una linea telefonica che non cade mai.

Passo 1: Crea il tuo Bot AI (La Via Facile)

Il percorso più veloce è scansionare un codice QR. Esegui questo comando nel tuo terminale:

hermes gateway setup

Seleziona WeCom e Hermes mostrerà un codice QR. Scansionalo con l’app mobile WeCom e la procedura guidata creerà automaticamente il bot con i permessi corretti. Salva anche le credenziali per te.

Niente codice QR? Nessun problema. La procedura guidata ripiega sull’inserimento manuale:

1. Accedi alla Console Admin di WeCom
2. Vai su Applicazioni → Crea Applicazione → Bot AI
3. Copia l’ID del Bot e il Segreto
4. Esegui di nuovo hermes gateway setup e incollali quando richiesto

⚠️ Mantieni privato il Segreto. Chiunque lo possieda può impersonare il tuo bot.

Passo 2: Comunica a Hermes del Tuo Bot

Hai due opzioni. Il modo interattivo (consigliato):

hermes gateway setup

Segui le istruzioni per credenziali, controllo accessi e notifiche.

Oppure modifica direttamente il file di configurazione. Apri ~/.hermes/.env e aggiungi:

WECOM_BOT_ID=il-tuo-bot-id
WECOM_SECRET=il-tuo-segreto
# Opzionale: consenti solo questi utenti
WECOM_ALLOWED_USERS=utente1,utente2
# Opzionale: dove inviare le notifiche
WECOM_HOME_CHANNEL=chat_id

Passo 3: Avvia il Gateway

Un comando e sei operativo:

hermes gateway

Tutto qui. Il tuo bot è ora online.

Cosa Può Fare?

• Messaggi diretti e chat di gruppo — decidi tu chi può parlargli
• Permessi per gruppo — lista consentita di utenti specifici per gruppo
• Supporto multimediale — invia e ricevi immagini, file, voce, video
• Thread di risposta — risponde nello stesso thread di conversazione, così il contesto rimane chiaro
• Riconnessione automatica — se la connessione cade, riprova silenziosamente in background

Una Cosa da Sapere

L’adattatore WeCom invia ogni risposta come un messaggio completo, non scrive carattere per carattere come ChatGPT. Pensalo come inviare un’email ben scritta invece di una chat dal vivo. Va bene per la maggior parte delle attività aziendali.

Considerazioni Finali

Configurare un assistente AI aziendale sembra spaventoso, ma Hermes lo rende facile come scansionare un codice QR in un bar. Inizia con un piccolo gruppo, testalo con domande reali, poi espandi l’accesso.

Consiglio pratico: Prima di aprirlo a tutti, usa WECOM_ALLOWED_USERS per testarlo con solo due o tre colleghi. Una volta che lo adorano, allarga la cerchia. Il tuo bot si guadagnerà il suo posto nella chat di squadra in men che non si dica.

---