Sul tuo sito e su WhatsApp
Lo stesso assistente, sul tuo sito e su WhatsApp. I clienti scrivono la lista della spesa con parole loro, e l’assistente GroceryAI risponde con il tuo catalogo e il tuo marchio — da dovunque scelgano di scrivere.
Il pulsante nell’angolo in basso di questa pagina è GroceryAI Web Chat.
Installazione
Incolla questa riga nel tuo sito, prima della chiusura di </body>. La chiave del sito è una chiave pubblicabile, pensata solo per aprire sessioni di chat del tuo sito: è in arrivo (vedi sotto), e fino ad allora si entra con la modalità server.
<script src="https://groceryai.ai/plugin/v1.js"
data-site-key="gai_pk_…"
data-site="id-del-tuo-sito"
async></script>Se il tuo sito ha un server, può aprire lui la sessione con la chiave API segreta e passare alla pagina solo il gettone di sessione. La chiave segreta non arriva mai nel browser. Quando il gettone scade, la Web Chat chiama la tua funzione refresh e prosegue.
// 1. Sul tuo server, con la chiave API segreta (mai nel browser):
POST <il tuo endpoint GroceryAI>/session
Authorization: Bearer <chiave API segreta>
→ { "session_token": "…", "expires_at": "…", "brand": { … }, "environment": "live" }
// 2. Nella tua pagina:
<script src="https://groceryai.ai/plugin/v1.js" async></script>
<script>
window.GroceryAI.open({
token: session_token,
expiresAt: expires_at,
brand: brand,
refresh: () => fetch("/la/tua/rotta/sessione").then((r) => r.json())
.then((s) => ({ token: s.session_token, expiresAt: s.expires_at })),
});
</script>:root {
--gai-accent: #0a7d4f; /* pulsante, testata, invio */
--gai-bg: #ffffff; /* pannello */
--gai-surface: #f6f7f9; /* conversazione */
--gai-text: #14181d;
}Che cosa fa
Un pulsante flottante apre la conversazione: a tutto schermo sul telefono, una finestra di 380 × 600 sul computer. Le lingue da destra a sinistra hanno l'impaginazione speculare.
Il nome del negozio e la lingua predefinita arrivano dalla tua configurazione GroceryAI, non dallo script: la stessa riga funziona per ogni insegna.
I messaggi arrivano alla piattaforma GroceryAI attraverso il suo canale web, che è attivo: lo stesso motore conversazionale che risponde ai tuoi clienti su WhatsApp. Due porte, un solo assistente.
Ogni visitatore è un identificativo anonimo firmato dalla piattaforma. La sessione dura un'ora e resiste al ricaricamento della pagina nella stessa scheda del browser.
Qualunque cosa scriva l'assistente viene mostrata come testo semplice: non viene mai interpretata come HTML o script nella tua pagina.
Ogni sessione di chat può inviare fino a 12 messaggi al minuto; oltre, la Web Chat aspetta e riprova da solo. A ogni risposta la piattaforma controlla l'indirizzo web che chiede contro l'elenco dichiarato per il tuo sito.
I colori seguono il tuo sito con le variabili CSS che iniziano per --gai-. Gli stili della Web Chat vivono in uno strato proprio: non cambiano la tua pagina e la tua pagina non li rompe.
Nessuna dipendenza e nessun framework: un solo script, sotto i 30 KB prima della compressione.
Non ancora
Configuriamo con te il catalogo, l’indirizzo del sito e la chiave.
Prenota un incontro