Scegliere dove può comparire il tuo agente

Il codice di incorporamento contiene solo l'ID del tuo agente, e chiunque può leggerlo nel sorgente delle tue pagine. Qualcuno potrebbe copiare lo snippet sul proprio sito, e ogni risposta che l'agente dà lì conterebbe sui tuoi messaggi del mese. I domini consentiti lo impediscono: indichi i siti in cui l'agente può comparire, e gli altri siti non possono più mostrarlo.

L'impostazione si trova nella scheda Share (Condividi), nel riquadro Where this agent can appear in cima alla pagina.

Impostare i domini consentiti

1. Apri il tuo agente e vai alla scheda Share.
2. In Where this agent can appear, scrivi i tuoi domini sotto Allowed domains, uno per riga.
3. Clicca Save.

Come funzionano le voci:

• Scrivi un dominio, per esempio example.com. Se incolli un indirizzo completo come https://www.example.com/contatti, viene tenuto solo il dominio.
• Ogni dominio comprende i suoi sottodomini. example.com consente anche www.example.com e shop.example.com. Non vale il contrario: www.example.com da solo non consente example.com.
• http o https e la porta non contano.
• Puoi aggiungere fino a 20 domini.
• Un elenco vuoto consente qualsiasi sito. È l'impostazione predefinita: finché non aggiungi un dominio, il tuo agente funziona come sempre.

Se una voce non è un indirizzo di sito, il riquadro mostra "Not a website address" con quella voce e Save resta disattivato finché non la correggi.

Quando valgono le modifiche

intoCHAT controlla l'elenco a ogni richiesta di chat, quindi una modifica vale subito per le richieste. La finestra di chat invece può impiegare fino a un minuto, perché questa impostazione resta in cache per poco tempo. Se hai appena aggiunto un dominio e la chat lì non si apre ancora, aspetta un minuto e ricarica la pagina.

Le anteprime nella dashboard e il Playground funzionano qualunque cosa contenga l'elenco.

Cosa vedono gli altri siti

Quando l'elenco contiene almeno un dominio, un sito che non ne fa parte non riceve nessuna chat:

• Tag script: la bolla non compare. La console per sviluppatori del browser mostra intoCHAT: this website is not in the allowed domains of this agent, so the chat is not shown.
• Iframe: il browser si rifiuta di caricare la pagina della chat nel riquadro. La maggior parte dei browser mostra un riquadro vuoto o un errore, e la console cita frame-ancestors.
• Script di quella pagina: le chiamate all'API della chat vengono rifiutate.

Una richiesta rifiutata non consuma nessuno dei tuoi messaggi.

Il tuo link diretto continua a funzionare, perché apre la chat su intochat.ai e non su un altro sito. Per disattivare anche il link, rendi privato l'agente.

Provare sul tuo computer

Aggiungi localhost all'elenco per provare il widget su un server di sviluppo locale, per esempio http://localhost:3000. Va bene qualsiasi porta. Finché localhost è nell'elenco, l'agente funziona anche sui server locali di altre persone, quindi toglilo quando hai finito di provare.

Una pagina aperta direttamente da un file, con un indirizzo che inizia con file://, non ha un dominio. Finché l'elenco contiene domini, lì la chat non compare. Servi invece la pagina da un server locale.

Agenti privati

Attiva Private agent e clicca Save quando l'agente non è ancora pronto per i visitatori, o quando deve usarlo solo tu.

• Solo tu puoi chattare con l'agente, nel Playground.
• Il tag script, l'iframe e il link diretto smettono di funzionare. Il link diretto mostra "This agent is private." Su un sito con il tag script la bolla non compare e la console mostra intoCHAT: this agent is private, so the chat is not shown.
• I tuoi domini consentiti restano salvati, ma non si possono modificare finché l'agente è privato. Quando disattivi di nuovo Private agent, l'elenco torna a valere.

Cosa non coprono i domini consentiti

I domini consentiti si basano sul browser. Il browser comunica a intoCHAT da quale sito arriva una richiesta, e si rifiuta di mostrare la chat dentro un sito che non hai indicato. Così gli altri siti non possono né mostrare il tuo agente né chiamare l'API della chat dalle loro pagine.

Le richieste fatte fuori da un browser, per esempio da uno script che gira su un server, non arrivano da un sito, quindi non si possono valutare in base al dominio. Per queste valgono i normali limiti di frequenza, come per ogni agente.

I domini consentiti decidono dove compare la chat, non chi può parlarle. Ogni visitatore del tuo sito può comunque chattare con l'agente e leggerne le risposte, quindi addestra un agente pubblico solo con contenuti che possono essere pubblici.

Se la chat non compare dove te l'aspetti, vedi Risoluzione dei problemi. Per installare l'agente, vedi Installare con un tag script.