WebChat per Microsoft Teams — la guida completa
Questa guida vi accompagna in WebChat dall'inizio alla fine: dall'installazione in Microsoft Teams all'apertura e al test nel backend e alla configurazione dei canali in entrata — widget del sito web, WhatsApp, Instagram — fino alla vostra IA con Azure AI Foundry e Power Automate. Ogni canale arriva in tempo reale nel canale Microsoft Teams giusto. Pay per Channel, configurato in pochi minuti.
▶Trovate tutto su WebChat in questo video (12 min)Come funziona WebChat: una richiesta tramite il widget del sito web viene instradata nel canale Microsoft Teams giusto — entrambi i lati mostrano la stessa conversazione, il team risponde con «@WebChat …» direttamente da Microsoft Teams.
Tre componenti, una piattaforma
WebChat porta tutti i canali in Microsoft Teams. Facoltativamente, aggiungete la vostra IA — orchestrata da Power Automate, gestita da un agente Foundry.
Tre fasi verso un WebChat produttivo
1WebChat & Microsoft Teams
- Aggiungere WebChat in Microsoft Teams
- Aprire e testare il backend
- Configurare WebChat
- Abilitare altri amministratori
- Risoluzione dei problemi
2Configurare i canali in entrata
WebChat & Microsoft Teams
Installare, testare nel backend, configurare e abilitare gli amministratori.
Aggiungere WebChat in Microsoft Teams
Potete cercare WebChat direttamente in Microsoft Teams sotto “App” — oppure tramite il Microsoft Marketplace. L'app viene poi assegnata al canale desiderato.
Cercare “WebChat” nel Microsoft Marketplace
Oppure aprite direttamente la voce webch.at/webchat direttamente. Fatturazione Pay per Channel anziché per utente.
Installare l'app in Microsoft Teams
Nella pagina dei dettagli dell'app in Microsoft Teams, selezionate “Aggiungi”.
La pagina dei dettagli dell'app WebChat in Microsoft Teams.
Selezionare un canale
Scegliete il canale Microsoft Teams in cui devono arrivare le richieste dei clienti.
Scegliere il canale di destinazione per le richieste in entrata.
WebChat si presenta nel canale Microsoft Teams
Dopo l'installazione, WebChat pubblica automaticamente il suo primo messaggio nel canale scelto — con una scheda di configurazione e un pulsante “Configura”.
Dopo l'installazione, WebChat si presenta per la prima volta nel canale Microsoft Teams (ricostruzione).
Aprire e testare il backend
Gestite canali e impostazioni nel backend di WebChat — connessi tramite Microsoft Entra (SSO). Testate il percorso completo fino a Microsoft Teams e ritorno.
Aprire il backend tramite SSO
webchat.inwebco.com — accesso tramite Microsoft Entra, senza credenziali separate.
Selezionare un canale — arrivate direttamente nella scheda LiveTest
Aprite nell'elenco dei canali quello appena creato in Microsoft Teams. Arrivate direttamente nella scheda “LiveTest” — in basso a destra trovate il vostro widget, da cui potete inviare in qualsiasi momento un messaggio cliente di prova. Compilate il modulo, fate clic su “Avvia chat” e scrivete il primo messaggio.
Dopo aver selezionato il canale si apre subito la scheda “LiveTest” (backend, vista desktop).
Passare a Microsoft Teams
Inviate un messaggio di prova in LiveTest e passate a Microsoft Teams: la richiesta appare in tempo reale come thread nel canale, con una scheda contatto. Con «@WebChat message …» rispondete al cliente; senza menzione resta comunicazione interna.
In Microsoft Teams: la richiesta come thread — risposta con «@WebChat message …».
Di nuovo in LiveTest: la risposta è arrivata
La risposta da Microsoft Teams appare nella scheda “LiveTest” — il percorso completo (cliente → Microsoft Teams → risposta) funziona.
La risposta da Microsoft Teams è arrivata nella chat LiveTest.
Configurare WebChat
Nella scheda “Configurazione” regolate aspetto e comportamento del widget. Il canale è già attivo — ogni impostazione è subito visibile in LiveTest.
La scheda “Configurazione” nel backend — tutte le impostazioni del canale in un unico posto.
Estratto delle impostazioni in dettaglio
Modalità e colori determinano l'aspetto del widget, Quick-Replies offrono risposte rapide al primo messaggio, Indicatore di digitazione e inattività mantengono viva la conversazione, e il modulo iniziale raccoglie i dati di contatto già prima del primo contatto.
Modalità e colori
Quick-Reply-Buttons
Visibilità dell'indicatore di digitazione
Campo del modulo iniziale
Testi e mittente
Carattere
Abilitare altri amministratori
Per impostazione predefinita, solo chi ha configurato WebChat può modificare le configurazioni. Aggiungete altri amministratori nella scheda “Admin”.
La scheda “Admin” nel backend con l'elenco degli amministratori e “Aggiungi admin”.
Tramite “Aggiungi admin” inserite un indirizzo e-mail e salvate — la persona deve essere membro del canale Microsoft Teams (accesso tramite Entra) e potrà poi modificare le impostazioni di questo canale.
Risoluzione dei problemi
Gli ostacoli più comuni — e come risolverli.
Solo “Richiedi approvazione” invece di “Aggiungi”?
🔒
WebChat
L'approvazione dell'amministratore nell'Interfaccia di amministrazione di Microsoft Teams sblocca WebChat in tutta l'azienda.
L'accesso tramite SSO non riesce?
Accesso al backend tramite Microsoft Entra (Single Sign-On).
Altre domande
Il widget non compare sul sito web
Verificate che lo script sia prima del tag body di chiusura e che il canale sia impostato su “Attivo” nel backend. Se integrato tramite Google Tag Manager, pubblicate il contenitore.
WhatsApp o Instagram non si collega
WhatsApp richiede un account WhatsApp Business (Meta); Instagram un account professionale/business collegato a una pagina Facebook. Completate del tutto l'accesso guidato nella relativa scheda.
Il flusso non si salva
Senza una licenza Power Automate Premium, i connettori premium non funzionano. Assegnate la licenza, quindi salvate e pubblicate di nuovo.
L'agente non risponde
Verificate che il nome dell'agente e il numero di versione fisso nella config del flusso siano corretti e che l'abbonamento Azure pay-as-you-go sia attivo.
Altro aiuto e link
Configurare i canali in entrata
Collegare widget del sito web, WhatsApp e Instagram — ricevere messaggi e rispondere direttamente da Microsoft Teams.
Inserire il widget nel sito web
Un singolo script integra il widget — direttamente nel codice sorgente o, senza accesso al codice, tramite Google Tag Manager.
Copiare il codice di incorporamento
Nella scheda “Incorpora”, copiate il codice dello script negli appunti.
La scheda “Incorpora” nel backend con “Copia negli appunti”.
Inserire prima della fine del body
Posizionate lo script subito prima del tag body di chiusura del vostro sito web.
Pubblicare e caricare
Salvate/pubblicate la pagina — il widget compare in basso a destra.
Il widget WebChat posizionato in basso a destra nel sito web.
Alternativa: integrazione tramite Google Tag Manager
Senza accesso al codice sorgente, integrate lo script come tag HTML personalizzato in Google Tag Manager.
Aprire Google Tag Manager
Andate su tagmanager.google.com e selezionate il contenitore del vostro sito web (il contenitore GTM deve essere integrato una volta nel sito).
Creare un nuovo tag “HTML personalizzato”
In Google Tag Manager: “Tag” → “Nuovo” → scegliete il tipo di tag “HTML personalizzato” e incollate esattamente il codice di incorporamento WebChat — inclusi i tag <script>. Lasciate disattivata l'opzione “Supporta document.write”.
Creare un trigger “Visualizzazione pagina” e assegnarlo al tag
In Tag Manager, sotto “Trigger”, create un trigger di tipo “Visualizzazione pagina” e assegnatelo al tag HTML personalizzato. “Tutte le pagine” carica il widget su tutto il sito; in alternativa indirizzatelo con una condizione — ad es. “L'URL della pagina contiene /contatto”: così tutte le sottopagine di quel percorso ricevono esattamente questo widget.
Anteprima, test e pubblicazione
Usate “Anteprima” per verificare che il widget si carichi nella pagina. Poi “Invia” → “Pubblica” — il widget è live, senza modifiche al codice sorgente del sito.
Collegare e configurare WhatsApp
Nella scheda “WhatsApp Business” collegate il vostro account WhatsApp Business (Meta) tramite un accesso guidato.
Aprire la scheda “WhatsApp Business”
Nel backend del canale desiderato, aprite la scheda “WhatsApp Business”.
La scheda “WhatsApp Business” nel backend (vista desktop).
Accedere con Facebook
Connessione tramite il WhatsApp Business Manager (Meta). È richiesto un account WhatsApp Business. Il pop-up che compare è un processo definito da Meta — seguite semplicemente i passaggi nella finestra.
Verificare e registrare il numero
Flusso guidato: accesso → verifica → registrazione → connesso. Per la verifica ricevete una chiamata con un codice. Dopodiché numero, link di condivisione e codice QR sono pronti (vedi la scheda sopra).
Configurare
Regolate il nome, il numero e il pulsante “Chat on WhatsApp” nell'area di configurazione.
Scrivere un messaggio WhatsApp, rispondere da Microsoft Teams
Una volta connessi: scansionate il codice QR generato, WhatsApp si apre e potete scrivere subito un messaggio — arriva in tempo reale nel canale Microsoft Teams giusto.
Una richiesta via WhatsApp viene instradata automaticamente nel canale Microsoft Teams giusto — il team risponde al cliente con «@WebChat …».
Collegare Instagram
Nella scheda “Instagram” collegate un account Instagram professionale/business.
Aprire Instagram nel browser e accedere
Accedete nel browser con il profilo desiderato.
Aprire la scheda “Instagram Business” e fare clic su “Collega”
Nel backend del canale desiderato, aprite la scheda “Instagram Business” e fate clic su “Collega” — si avvia l'accesso Meta.
La scheda “Instagram Business” nel backend (vista desktop).
Collegare e confermare l'account
Confermate l'accesso nella finestra di Meta — WebChat riceve un token di accesso e mostra l'account collegato.
Il token resta valido
Il token viene rinnovato automaticamente finché l'account resta collegato.
Ricevere un DM Instagram, rispondere da Microsoft Teams
Un DM Instagram (ad es. reazione a un'inserzione) arriva nel canale Marketing — risposto direttamente da Microsoft Teams.
Configurare la vostra IA
Creare un agente Foundry, controllarlo tramite Power Automate e testarlo da tutti i canali.
Creare un agente IA
L'IA gira come agente proprio nel vostro tenant (ai.azure.com): creare un progetto, creare un agente prompt con un modello, aggiungere la ricerca web come grounding, pubblicare.
Creare un progetto
Nel menu progetti di Foundry, create un nuovo progetto (o aprite uno esistente).
Creare un agente
Create un agente prompt e scegliete un modello. Consigliamo un agente dedicato per canale.
Microsoft Foundry — la panoramica degli agenti.
Impostare il prompt di sistema
Definite ruolo, tono e regole di escalation — ad es. “Sei l'agente di supporto dell'azienda X, rispondi con cortesia; in caso di intenzione d'acquisto o reclamo, esegui l'escalation al team.”
Grounding: attivare la ricerca web
Aggiungete la ricerca web come grounding e inserite domini/URL consentiti (ad es. webchat.cloud) affinché l'agente risponda solo dalle vostre fonti — non dalla conoscenza generale del modello.
La finestra “Aggiungi strumento di ricerca web”: collegare la ricerca Bing personalizzata ai vostri domini (nomi di esempio neutri).
Collegare file di conoscenza
Aggiungete i vostri documenti (PDF, FAQ, listini) come archivio vettoriale. Più mirato è il grounding, più precise e verificabili sono le risposte — l'agente cita le fonti.
Testare nel playground
Prima di pubblicare: provate l'agente direttamente nel playground di Foundry e verificate come risponde — mettete a punto prompt, grounding e tono.
L'agente nel playground di Foundry: inviate richieste di prova, verificate risposte e fonti.
Pubblicare e annotare nome/versione
Salvate e pubblicate l'agente. Annotate il nome dell'agente e la versione pubblicata — vi servono entrambi nella parte 10 per il flusso Power Automate. Usate sempre un numero di versione fisso, non “latest”.
Configurare il flusso di controllo
make.powerautomate.com — create le connessioni, impostate il trigger per parola chiave, incollate il codice del flusso come scope e inserite la config dell'agente.
Creare le connessioni
Create Microsoft Teams, Content Conversion e Azure AI Agent Service. L'endpoint dell'Azure AI Agent Service lo trovate in Foundry tramite il menu progetto → “Dettagli progetto”.
Le tre connessioni in Power Automate: Microsoft Teams ([email protected] — WebChat pubblica con questo utente in Microsoft Teams), WebChat-Foundry-Agents (Azure AI Foundry Agent Service — endpoint dai dettagli del progetto Foundry) e Content Conversion.
In Foundry, sotto “Dettagli progetto”, trovate l'endpoint del progetto e la regione — inseriteli nella connessione Azure AI Agent Service.
Configurare il trigger per parola chiave
“Quando vengono menzionate parole chiave” sul canale di destinazione. Per impostazione predefinita, WebChat invia la parola chiave pp — non rimuovetela. Per personalizzarla, impostate un valore proprio nella scheda backend “Power Platform” e inserite esattamente quello qui come parola chiave. La parola chiave viene inviata anche quando ne disattivate la visualizzazione — così non compare in ogni messaggio. All'inizio la visualizzazione è attiva di proposito per rendere visibile il meccanismo.
Trigger “When keywords are mentioned”: Message type = Channel, scegliete la voce Team e Channels item e impostate la parola chiave (predefinito “pp”).
La parola chiave del trigger (predefinito “pp”) può essere modificata nella scheda backend “Power Platform”.
Inserire il codice del flusso
Copiate il codice di flusso preparato da webch.at/json. Nel designer, sotto il trigger, fate clic destro sul “+” per inserire una nuova azione e usate “Appunti personali” per incollare lo scope copiato — l'intero flusso (condizione → agente IA → Adaptive Card) viene inserito con esso. Poi assegnate a ogni azione la connessione corretta.
Prima scaricate/copiate il JSON da webch.at/json. Poi, sotto il trigger, fate clic su “+” (o clic destro) → “Incolla” per inserire lo scope completo.
Inserire la config dell'agente
Nell'azione Inizializza variabile, inserite Config_agent_name e Config_agent_version dalla parte 9 (numero di versione fisso, non “latest”). Aggiungete altri nodi tramite “+” o clic destro → “Aggiungi azione” (ad es. promemoria, escalation, menzione hot-lead). Infine, salvate e pubblicate.
Testare: avviare una conversazione in LiveTest
Avviate una conversazione di prova nella scheda “LiveTest” — l'agente IA risponde automaticamente. La stessa conversazione appare nel canale Microsoft Teams, dove il team può subentrare in qualsiasi momento.
LiveTest: il visitatore chiede — l'agente IA (Foundry) risponde in tempo reale.
La stessa conversazione si svolge nel canale Microsoft Teams “Support” — l'agente IA risponde via @WebChat, il team può subentrare in qualsiasi momento.
Facoltativo: dati in tempo reale come Adaptive Card
Facoltativamente potete creare altre Adaptive Card in Power Automate e inserirle nella conversazione — per offrire all'operatore informazioni interne, dati in tempo reale da CRM/ERP o altri workflow direttamente nel canale Microsoft Teams.
Testare l'agente da tutte le fonti
Un agente, tutti i canali: avviate richieste tramite widget, WhatsApp e Instagram e verificate il comportamento in Microsoft Teams uno per uno.
Esempi: escalation, hot-lead e controllo del bot
Questi comportamenti si configurano tramite le variabili di config del workflow in Power Automate (parte 10) — ad es. intervallo promemoria, menzione di escalation e rilevamento hot-lead.
WebChatEscalationWebChatHot-leadWebChatPromemoriaControllo del chatbotCommutabile per conversazione (human-in-the-loop)Lista di controllo
- ✓Risposta: inviate un messaggio cliente di prova → l'agente risponde nel canale.
- ✓Escalation: il passaggio viene segnalato al team, il bot disattivato, scheda di attivazione + promemoria pubblicati.
- ✓Riattivare: riaccendete il bot tramite la scheda di attivazione.
- ✓Hot-lead: testate l'intenzione d'acquisto → menzione al team + avviso lead, il bot resta attivo.
- ✓Test di concorrenza: più messaggi in rapida successione → arriva una risposta, niente risposte multiple.
Un chatbot di supporto IA per Microsoft Teams — senza una seconda casella di posta
WebChat porta in tempo reale le richieste da WhatsApp, Instagram, TikTok e dal widget del sito web nel canale Microsoft Teams giusto. L'instradamento intelligente assegna automaticamente ogni richiesta al reparto competente — prodotto al supporto, carriere alle HR, campagne al marketing. Senza cambiare strumento, senza secondo login, senza seconda casella di posta.
L'IA gira come agente Azure AI Foundry proprio nel vostro tenant: nessun vincolo al fornitore, piena tracciabilità tramite i log di audit Microsoft e human-in-the-loop. Power Automate orchestra risposte, escalation e promemoria; le Adaptive Card mostrano dati in tempo reale da CRM ed ERP direttamente nella chat. Autorizzazioni e identità provengono interamente da Microsoft Entra.
WebChat si installa come qualsiasi app Microsoft Teams direttamente da Microsoft Teams o dal Microsoft Marketplace, e si fattura Pay per Channel anziché per utente — con utenti illimitati per canale. La configurazione di base è pronta in meno di dieci minuti; il chatbot IA lo aggiungete poi tramite Foundry e Power Automate. Tutti i prezzi su webch.at/prezzi.
