Estensione AI Chatbot per TYPO3 (Gratuito, da TYPO3 10 a 14)

Estensione TYPO3

L'estensione WebChatAgent inserisce il tuo chatbot su un sito TYPO3. La installi, incolli il tuo ID del chatbot nella configurazione del sito, e il pulsante di chat compare su ogni pagina del sito. Non serve includere TypoScript né modificare template. Design, testi, comportamento dell'IA e live chat rimangono nella dashboard di WebChatAgent, quindi le modifiche apportate lì compaiono subito sul sito web.

Una sola versione supporta TYPO3 10.4, 11.5, 12.4, 13.4 e 14.

Passo 1: Installa l'estensione

Con Composer (la maggior parte dei progetti TYPO3):

composer require webchatagent/typo3-webchatagent
vendor/bin/typo3 extension:setup

Senza Composer: apri Admin Tools → Extensions, cerca webchatagent e installala. TYPO3 crea i campi del database in autonomia.

L'estensione è gratuita. La trovi nel TYPO3 Extension Repository e su Packagist.

Passo 2: Copia il tuo ID del chatbot

Accedi alla dashboard di WebChatAgent e apri il tuo chatbot.
Apri Azioni del chatbot e fai clic su Copia l’ID del chatbot.

L'ID ha questo formato: 3f2b9c1e-8a7d-4e5f-9b0c-1d2e3f4a5b6c.

Passo 3: Aggiungi l'ID al tuo sito

In TYPO3, vai su Site Management → Sites e modifica il tuo sito.
Apri la scheda Chat.
Incolla l'ID del chatbot nel campo ID del chatbot e salva.

Apri il tuo sito web in una nuova scheda: il pulsante di chat compare nell'angolo di ogni pagina. Con più siti in una singola installazione TYPO3, ogni sito riceve il proprio ID, così ogni sito web può utilizzare un chatbot dedicato.

Nascondi la chat su pagine specifiche

Apri le proprietà della pagina, scheda Chat, e attiva l'opzione Hide the chat button on this page and all subpages. Utile per pagine di checkout, landing page per annunci o aree intranet.

L'opzione si applica alla pagina e a tutte le sue sottopagine. Se la imposti sulla pagina radice, il pulsante di chat scompare dall'intero sito, un metodo rapido per mettere in pausa la chat senza eliminare l'ID.

Mostra la chat all'interno di una pagina

Per una pagina di contatto o di aiuto puoi inserire la chat direttamente nel contenuto, al posto del pulsante mobile o in aggiunta ad esso:

Nel modulo Page, aggiungi un nuovo elemento di contenuto.
Seleziona Chat integrata da Special elements.
Lascia ID del chatbot vuoto per usare l'ID del sito, oppure inseriscine un altro per questa pagina.
Facoltativo: imposta un valore di Altezza, ad esempio 600px o 80vh. In assenza di questo valore, la chat si adatta alle dimensioni del contenuto.

Lo script per la chat integrata viene caricato solo sulle pagine che contengono tale elemento. Testo di benvenuto, tema e le altre opzioni per l'integrazione inline si gestiscono da Canali → Chat integrata nella dashboard, vedi la guida alla Chat integrata.

Gli editor senza diritti di amministrazione devono avere i nuovi campi e il tipo di contenuto "Chat integrata" abilitati nel loro gruppo di utenti backend.

Passa gli utenti autenticati del sito web alla chat

Se il tuo sito TYPO3 dispone di un'area di login, attiva Pass logged-in website users to the chat nella scheda Chat del sito. Per i visitatori autenticati, la chat riceve nome, indirizzo email e nome utente. Il bot può così salutarli per nome e non richiede nuovamente i dati di contatto.

TYPO3 aggiunge questi dati a ogni richiesta, non finiscono mai nella cache di pagina. I visitatori non autenticati non trasmettono alcun dato utente. Indica questo passaggio di dati nella tua informativa sulla privacy.

Invia dati personalizzati (per sviluppatori)

Per trasmettere ulteriori informazioni, ad esempio un numero cliente, registra un listener per l'evento WebChatAgent\WebChatAgent\Event\ModifyContextDataEvent e aggiungi le tue chiavi con setContextData(). Il file README su GitHub contiene un esempio completo. Formato e limiti sono descritti nella guida Integrazione del widget di chat.

Content Security Policy

Con la CSP frontend abilitata (TYPO3 12 e versioni successive), l'estensione aggiunge il server di chat alla policy per script, connessioni, immagini e contenuti multimediali, consentendo inoltre stili inline per il widget. Non è necessario modificare csp.yaml.

WebChatAgent non mostra un proprio banner di consenso. Senza un segnale di consenso esplicito opera in Privacy Mode anonima. Se il tuo sito TYPO3 utilizza un gestore del consenso, collegalo come descritto nella guida Consenso ai cookie e trigger proattivi anonimi.

Risoluzione dei problemi

Manca il pulsante di chat? Verifica che l'ID nella scheda Chat sia completo e che la pagina e le sue pagine genitore non abbiano attiva l'opzione per nascondere il pulsante. Svuota poi le cache di TYPO3. Se utilizzi una cache per file statici come EXT:staticfilecache, svuota anche quella.
Il problema persiste? Il tuo chatbot potrebbe essere limitato a determinati domini. Aggiungi il dominio del tuo sito web in Domini consentiti nella dashboard.
Bloccato dalla Content Security Policy? Controlla la console del browser. Se ospiti la chat con un tuo indirizzo personalizzato (white-label), inseriscilo come Server address nella scheda Chat, così l'estensione autorizzerà esattamente quell'indirizzo.