Widget di chat web

Il widget di chat web è una chat incorporabile e con il tema del tuo brand per il tuo sito. C'è zero configurazione, nessun token o chiave API da gestire. I visitatori chattano come ospiti (senza login), le risposte arrivano in streaming in tempo reale e il pulsante di avvio si configura da solo a partire dalle impostazioni salvate, così modificare il colore, il saluto o l'icona ha effetto senza dover reincollare lo snippet. Poiché gli ospiti eseguono solo abilità sicure per il pubblico, un visitatore non può mai raggiungere i tuoi dati privati.

Prima di iniziare

• L'agente deve avere il canale Web Chat abilitato (si trova nella scheda Integrazioni dell'agente).
• Devi avere accesso per modificare l'HTML del tuo sito, incollerai un tag <script> prima di </body>.
• Decidi in anticipo se vuoi limitare l'incorporamento a domini specifici e se chiedere ai visitatori un contatto prima che chattino.

Aggiungilo al tuo sito

1. Apri l'agente, vai su Integrazioni e trova la scheda Web Chat.
2. Fai clic su Incorpora nel sito web per aprire la finestra di incorporamento.
3. Fai clic su Copia codice e incolla lo snippet subito prima del tag di chiusura </body> su ogni pagina in cui il widget deve comparire.

Lo snippet è un singolo tag. La dashboard inserisce automaticamente l'ID del tuo agente (BOT_UID) e l'host AnyBot corretto, quindi copialo alla lettera:

<script src="https://app.any.bot/widget.js" data-anybot="BOT_UID" async></script>

Carica il widget AnyBot, che aggiunge alla pagina un pulsante di avvio fluttuante; un clic apre la chat (a schermo intero sui telefoni, e Escape la chiude). Il codice del widget viene servito da AnyBot invece di essere incollato nella tua pagina, così le correzioni e le tue impostazioni di aspetto raggiungono il tuo sito senza reincollare nulla. Se scegli un tema nella finestra di incorporamento, il tag riporta anche un attributo data-theme; cambiare il tema in seguito è l'unica modifica che richiede di copiare di nuovo il tag.

Apri la chat dai tuoi pulsanti

Aggiungi data-anybot-open a qualsiasi elemento della tua pagina, come un pulsante "Chatta con noi" o un link nell'intestazione, e un clic su di esso apre la chat. Non serve nessuno script aggiuntivo.

<button type="button" data-anybot-open>Chatta con noi</button>

Dal tuo JavaScript, il widget offre anche window.AnyBotWidget.open(), close() e toggle().

Personalizza il widget

L'aspetto e il comportamento provengono dalle impostazioni del canale Web Chat e vengono serviti sull'endpoint pubblico di informazioni sul bot che il widget interroga. Campi modificabili:

Questi si trovano insieme ai controlli condivisi per canale, vedi Impostazioni del canale per saluto, orari di lavoro e fuori orario.

Limita dove può essere incorporato

Aggiungi al canale un elenco di domini consentiti e solo quei siti potranno caricare il widget, una richiesta da qualsiasi altro dominio viene rifiutata (403). Viene applicato lato server a ogni richiesta ospite (Origin/Referer controllati), quindi non può essere aggirato modificando lo snippet. Un elenco vuoto significa nessuna restrizione. L'origine della tua stessa dashboard AnyBot è sempre consentita, così l'anteprima del proprietario non viene mai bloccata.

Cattura un contatto prima della chat

Attiva la cattura pre-chat per proteggere la conversazione dietro un breve modulo. Scegli un qualsiasi sottoinsieme tra nome, email e telefono; il visitatore li compila prima del primo messaggio e i valori popolano il contatto. Questa è una delle poche scritture sicure per il pubblico, vedi Privacy by design qui sotto.

Su questo canale

• Riceve: messaggi digitati dai visitatori ospiti.
• Invia: risposte di testo in streaming, con i passaggi delle chiamate agli strumenti e feedback 👍/👎; le immagini generate dall'agente vengono renderizzate in linea.
• Sessioni: gli ospiti mantengono la loro conversazione tra i ricaricamenti di pagina sullo stesso dispositivo.

Privacy by design

I visitatori ospiti eseguono solo strumenti sicuri per il pubblico, attualmente 27 delle abilità della piattaforma. Un visitatore non può mai far leggere all'agente la tua casella di posta, il tuo CRM o i tuoi dati finanziari. Un piccolo e deliberato sottoinsieme di strumenti sicuri per il pubblico sono scritture (cattura di lead, prenotazione di appuntamenti), tutto ciò che è sensibile resta riservato al proprietario. Vedi Sicurezza.

Risoluzione dei problemi

• Il pulsante di avvio non compare, verifica che lo <script> sia prima di </body> e che il canale Web Chat sia abilitato per questo agente.
• 403 quando il widget si carica, il dominio della pagina non è nell'elenco dei domini consentiti. Aggiungilo (oppure svuota l'elenco per rimuovere le restrizioni).
• Il pulsante di avvio mostra il colore e l'icona predefiniti, la pagina ha ancora lo snippet precedente su più righe. Sostituiscilo con il tag su una riga di Copia codice.
• Le modifiche allo stile non sono state applicate, il widget legge le impostazioni al caricamento; ricarica la pagina forzatamente. Non devi reincollare il tag per recepire le nuove impostazioni, tranne dopo aver cambiato il tema.
• I visitatori bloccati su un modulo, la cattura pre-chat è attiva; ogni campo elencato è obbligatorio prima che la chat inizi.

FAQ

Ho bisogno di una chiave API? No, zero configurazione. Il tag contiene l'ID del tuo agente e nient'altro.

I visitatori possono attivare azioni sensibili? No, solo abilità sicure per il pubblico, più le deliberate scritture sicure per il pubblico come la cattura di lead e la prenotazione.

Posso limitare quali siti lo incorporano? Sì, con l'elenco dei domini consentiti; vuoto significa qualsiasi sito.

Modificare le impostazioni romperà l'incorporamento? No, il widget si configura da solo a ogni caricamento, così colore, icona e saluto si aggiornano senza toccare lo snippet.

Un mio pulsante può aprire la chat? Sì. Aggiungi data-anybot-open a qualsiasi pulsante o link, oppure chiama window.AnyBotWidget.open().

Prossimi passi

• Impostazioni del canale, saluto, orari di lavoro e fuori orario
• Tutti i canali, connetti WhatsApp, Telegram, email e altro
• Abilità, quali strumenti sicuri per il pubblico può eseguire il tuo agente
• Sicurezza, il modello riservato al proprietario vs sicuro per il pubblico