🚀Per iniziare

Copia il codice da Impostazioni → Installazione nella dashboard e incollalo subito prima del tag </body> in ogni pagina del tuo sito. Lo script si carica in modo asincrono, quindi non rallenta le pagine.

<script src="https://revochat.app/widget.js"
        data-revo-chat="YOUR_SITE_KEY" async></script>

Dopo aver incollato il codice, apri il tuo sito una volta: la prima volta che il widget si connette dal tuo dominio, il passaggio nella schermata Configurazione si completa da solo. Non c'è nessun pulsante da premere.

• WordPress: Aspetto → Editor dei file del tema → footer.php, oppure un qualsiasi plugin per “inserire codice in header/footer”.
• Shopify: Negozio online → Temi → Modifica codice → theme.liquid, prima di </body>.
• Wix / Squarespace: il campo “codice personalizzato” nelle impostazioni del sito, applicato a tutte le pagine.
• Next.js / React: come <script> nel layout principale, con defer/async.

Per la privacy (KVKK/GDPR), il widget non registra nulla finché il visitatore non apre la bolla della chat: non compare nell'elenco dei visitatori live, le visualizzazioni di pagina non vengono tracciate e nel browser non viene salvato alcun ID persistente. La bolla resta visibile e la chat inizia normalmente appena il visitatore la apre.

Se usi uno strumento per il consenso ai cookie (Cookiebot, CookieYes, Google Consent Mode…), esegui la chiamata qui sotto quando il visitatore dà il consenso; per i visitatori che acconsentono, monitoraggio e messaggi proattivi funzionano anche prima che avviino una chat. Se il consenso viene revocato, consent(false) elimina l'ID persistente.

RevoChat.consent(true);   // consent given
RevoChat.consent(false);  // consent withdrawn

Se identifichi i tuoi membri con RevoChat.identify, attiva la verifica dell'identità: crea un segreto in Impostazioni → Installazione → Verifica dell'identità, conservalo solo sul tuo server e firma lì l'email. Un'email firmata mostra una spunta verde nella dashboard e i webhook includono visitorEmailVerified: true. Un'email non firmata (anche se digitata dal visitatore) viene salvata ma considerata non verificata.

const hash = crypto.createHmac("sha256", IDENTITY_SECRET).update(member.email).digest("hex");
// on the page:
RevoChat.identify({ email: member.email, name: member.name, hash });

In Impostazioni → Aspetto puoi adattare l'intero widget al tuo brand. Le modifiche sono attive appena salvi: non serve incollare di nuovo il codice.

• Colore del brand: perché la bolla e i fumetti dei messaggi siano in linea con il tuo brand.
• Posizione della bolla: in basso a destra (predefinita) o in basso a sinistra, se nell'angolo in basso a destra del tuo sito c'è già qualcos'altro.
• Messaggio di benvenuto: la prima riga che i visitatori vedono quando si apre la chat.
• Messaggio offline: mostrato quando nessun operatore è disponibile e l'assistente AI è disattivato.
• Lingua del widget: automatica, in base alla lingua del browser del visitatore, oppure fissa (inglese, turco, spagnolo, portoghese, tedesco, francese, italiano, olandese, russo).
• Domande frequenti: mostrate come pulsanti nella schermata di benvenuto; quando un visitatore ne sceglie una, la chat inizia con quella domanda.

La tua chiave di embed è visibile a chiunque nel sorgente della pagina: è normale e non è pensata per essere segreta. Ma se non vuoi che qualcuno copi la chiave e la usi sul proprio sito, compila Impostazioni → Installazione → Domini consentiti.

• Finché l'elenco è vuoto non c'è alcuna restrizione (la funzione è facoltativa).
• Separa con virgole: site.com, shop.site.com
• Sono supportati i caratteri jolly: *.site.com copre tutti i sottodomini oltre a site.com stesso.
• Le connessioni da un indirizzo non in elenco vengono rifiutate; il visitatore non vede errori, semplicemente il widget non viene mostrato.

Ogni sito ha la propria pagina di chat autonoma. Metti il link nel tuo profilo social, nella firma email o in un codice QR; quando un visitatore ci fa clic, si apre una chat a schermo intero e la conversazione arriva nella stessa inbox.

https://revochat.app/chat/YOUR_SITE_KEY