Guide > Collegare i canali > Integrare la WebChat

Integrare la WebChat nel tuo sito web

Il widget WebChat è una bolla di chat con il tuo marchio, in basso a destra sul tuo sito. I visitatori ti scrivono direttamente; i messaggi arrivano nella stessa inbox di email, WhatsApp e così via. L'integrazione richiede 2 minuti e funziona con ogni piano. La ricezione non ha mai limiti; nel piano Free le tue risposte contano per i 1.000 messaggi in uscita al mese (tutti i canali insieme).

⏱ circa 2–5 min · Permesso “Manage settings” (amministratore) · Free, Cloud Pro e Paid · nessun account esterno necessario · Aggiornato al 12 nov 2026 (versione 1.1.65)

Settings → Channels → scheda WebChat con Try it now, link alla chat e codice QR e “Visitors become contacts”
La finestra “Share & test”: provala tu stesso, copia il link, link alla chat e codice QR, aggiungila con una guida e “Visitors become contacts”.

Passo per passo

  1. Apri la web chat. Settings → Channels → nell'elenco “Connected”, la riga “Web chat” → “Share & test”. Funziona subito, senza configurazione (stato “Running”, interruttore “Active” acceso). Con più marchi scegli prima il marchio giusto in alto nella scheda “Connected”.
  2. Provala tu stesso. “Try it now – message yourself” apre la chat; il tuo messaggio arriva nell'Inbox in pochi secondi e la tua risposta compare subito nella finestra della chat. La finestra della chat controlla se ci sono nuove risposte ogni 3 secondi, ogni 15 secondi dopo 1 minuto di inattività; un messaggio può avere fino a 4.000 caratteri.
  3. Copia il codice di integrazione. Espandi “Add it to your website – with guides for WordPress, Wix & co.”. Lì trovi il codice di integrazione, uno script di una sola riga:
    <script src="https://crm.the-y.at/webchat/<your-company>/widget.js" async></script>
    Clicca “Copy”. <your-company> è l'indirizzo del tuo account ed è già inserito; con più marchi il codice vale per il marchio scelto in alto.
  4. Inseriscilo nel tuo sito. Aggiungi lo script in ogni pagina in cui deve comparire la chat, subito prima del tag di chiusura </body>. Per WordPress, Wix, Jimdo, Shopify e Squarespace la finestra mostra tre brevi passaggi ciascuno (vedi sotto). WordPress funziona anche senza codice: usa il nostro plugin gratuito “The-Y CRM – Web Chat & Contact Buttons” dalla directory ufficiale di WordPress (incolla l'ID della tua azienda, fatto; con modalità privacy, pulsante WhatsApp e pulsante di prenotazione).
  5. Prova. Ricarica il tuo sito: la bolla della chat compare in basso a destra. Cliccala e invia un messaggio di prova: compare subito nell'inbox e puoi rispondere immediatamente.
Nessuna build, nessun riavvio: l'interruttore “Active” nella riga “Web chat” ha effetto subito. Se lo spegni, la bolla scompare (lo script non restituisce più nulla); la pagina della chat dice allora “Chat not available”, senza nome dell'azienda o del marchio.

Porta la web chat sul tuo sito, anche senza codice

La finestra “Share & test” ti aiuta a portare la chat dove sono i tuoi clienti:

Personalizzare l'aspetto (branding)

La bolla adotta automaticamente il design del tuo marchio. In Settings → Logo & colours (prima “Design”) imposti per ogni marchio il colore principale, il nome dell'app/del marchio e le iniziali: valgono per la bolla, la finestra della chat, la pagina di accesso e le pagine pubbliche (portale di assistenza, prenotazioni). Nel piano Free l'intestazione della chat mostra il nome della tua azienda, con sotto “Powered by The-Y” (dalla 1.1.52). Dalla 1.1.53 la scheda del browser della pagina chat mostra il nome della tua azienda o del marchio invece di “The-Y CRM”.

Orari e risposta automatica

In Settings → Opening hours & holidays un unico piano settimanale vale per tutti i canali; la web chat può avere orari propri. In più una risposta automatica in orario (ad es. “Saremo subito da Lei”) e fuori orario (ad es. “Le risponderemo domani”). La risposta automatica viene inviata solo al primo messaggio di un visitatore. Nei giorni festivi parte il testo “fuori orario”. Di più sugli orari di apertura

Chatbot e risposte IA (facoltativo)

I visitatori diventano contatti in automatico

Dalla 1.1.53 chiunque scriva nella web chat riceve automaticamente un contatto proprio, con nome, email o numero di telefono se li indica nella chat (ad es. dopo “Mi lascia il Suo indirizzo email?”). Senza dati il contatto si chiama “Web chat visitor …”; i messaggi automatici lo salutano comunque in modo neutro. Così flussi come “Create deal” funzionano dal primo messaggio.

Inbox: conversazione della web chat con la nota “Maybe the same person as …”, Merge e Not the same person
Nell'inbox: “Maybe the same person as …” con “Merge” o “Not the same person”.
Finché non li unisci, ci sono due contatti con lo stesso indirizzo: una campagna email può quindi arrivare due volte. Per questo unisci presto i contatti che corrispondono.

Più marchi

Ogni marchio ha il suo codice di integrazione con un identificativo e un aspetto propri. Così gestisci chat separate per più siti web, tutto in un unico account e con un'unica fattura. Free include 1 marchio; con Cloud Pro (20 €/mese per azienda, tutti gli utenti e i marchi, valido in Alpha e Beta) e Paid puoi averne quanti vuoi.

Risoluzione dei problemi

La bolla della chat non compare

Controlla: l'interruttore “Active” nella riga “Web chat” è acceso (stato “Running”)? Lo script è davvero prima di </body> e l'identificativo del marchio nel codice di integrazione è corretto? Svuota la cache del browser e del sito e ricarica. Apri la console per sviluppatori (F12) e controlla se widget.js viene caricato (stato 200).

La chat deve comparire solo su alcune pagine

Inserisci lo script solo nelle pagine o nei template desiderati (non globalmente). Al contrario, per tutto il sito mettilo nel template comune del footer.

Vedo due contatti con lo stesso indirizzo email

È un visitatore della web chat che ha indicato l'indirizzo di un contatto esistente. Il nuovo contatto mostra “Maybe the same person as …”: controlla un attimo e clicca “Merge” o “Not the same person”.

Privacy / informativa sui cookie

La WebChat non imposta cookie: conserva sessione e nome nella memoria locale del browser (localStorage), così lo storico della conversazione resta. Su crm.the-y.at le chat vengono salvate su server in Austria (data center a Vienna). Cita la chat nella tua informativa sulla privacy e tratta i contenuti delle chat come qualsiasi altra comunicazione con i clienti.

Prossimi passi