Integrazione con Replit
Aggiungere una live chat alla tua app Replit
Replit Agent costruisce la tua app, Replit la pubblica su un indirizzo replit.app. Perché i visitatori possano parlarti, passa il prompt di Hooky all’Agent, ripubblica e rispondi dal telefono.
Perché una chat su un’app Replit
Un’app Replit è spesso un prodotto vero: prenotazioni, uno strumento interno, un piccolo SaaS. I primi utenti si bloccheranno da qualche parte, e tu vuoi saperlo subito, non da un’email tre giorni dopo. La bolla di Hooky permette loro di scriverti dall’app, senza account, e tu rispondi ovunque tu sia.
Installare Hooky con Replit Agent
Crea il tuo account Hooky (gratis per un sito) e aggiungi l’app con il suo indirizzo pubblicato, per esempio
mia-app.replit.app.Copia il prompt in Siti: la chiave del sito è già dentro. Ecco la versione per Replit.
Incollalo nella casella del prompt di Replit Agent, poi controlla in Preview che l’app funzioni ancora.
Ripubblica: Publish in alto a destra nell’editor. La versione pubblicata non cambia finché non pubblichi di nuovo: è voluto, così puoi lavorare senza rompere l’app online.
Il prompt per Replit Agent
Aggiungi la bolla di chat di Hooky a questa app, su tutte le pagine. Incolla questo tag una sola volta, subito prima di </body>, nel template HTML comune a tutte le pagine inviate al browser (client/index.html o index.html per React con Vite, app/layout.tsx con il componente Script di next/script per Next.js, il template di base per Flask o Django):
<script src="https://heyhooky.com/widget.js" data-site-key="LA_TUA_CHIAVE_PUBBLICA" async></script>Non modificare l’indirizzo dello script né l’attributo data-site-key. Non aggiungere altro codice, né lato server né lato client: la bolla compare da sola, in basso nello schermo.
Preview, replit.app e il tuo dominio
Replit ha due indirizzi: l’anteprima di sviluppo, su replit.dev, temporanea (Replit avvisa che può cambiare), e l’app pubblicata, su replit.app o sul tuo dominio. Dichiara in Hooky l’indirizzo pubblicato e il tuo dominio. Per vedere la bolla anche in Preview, la cosa più semplice è non aver ancora dichiarato nessun indirizzo: la bolla funziona ovunque.
Se la tua app è protetta (password, solo workspace, inviti), solo chi ha accesso vede la bolla: è normale.
Verificare che la bolla compaia
Apri l’indirizzo pubblicato, non solo Preview: è quello che vedono i visitatori. La bolla è in basso. Manda un messaggio: arriva in Messaggi e sul telefono. Niente? Ripubblica, controlla gli indirizzi autorizzati e ricarica senza cache.
Rispondere e seguire la tua app
Rispondi dall’app Hooky (iPhone, iPad, Mac, Android) o dalla dashboard web. L’utente può allegare uno screenshot o un PDF: comodo per un bug. Se se ne va prima della tua risposta dopo aver lasciato l’email, la riceve via email.
La tua app Replit ha un server: sfruttalo. Chiedi all’Agent di inviare i tuoi eventi (iscrizione, ordine) all’API di Hooky con la chiave segreta del sito, salvata nei secrets di Replit, e di pubblicare una notifica nel canale del sito a ogni ordine. Vedi la documentazione.
Domande frequenti
Serve un piano a pagamento di Replit?
Non per Hooky. Ti serve solo un’app pubblicata; secondo Replit, la pubblicazione è disponibile su tutti i piani, con limiti in quello gratuito (un’app pubblicata, che scade dopo 30 giorni). Controlla le condizioni attuali su Replit.
L’Agent ha aggiunto codice lato server per Hooky
Alla bolla non serve: chiedigli di togliere quel codice e di lasciare solo il tag nel template HTML.
Dove salvo la chiave segreta del sito?
Nei secrets di Replit (una variabile d’ambiente, per esempio HOOKY_SECRET_KEY), mai nel codice inviato al browser. La chiave pubblica del tag, invece, può vederla chiunque: è normale.
La mia app Replit è un’app mobile
La bolla di Hooky è fatta per le pagine web: funziona in un’app web aperta nel browser, non in un’app nativa.
Gli altri strumenti
I tuoi visitatori hanno domande. Rispondi da dove sei.
Gratis per un sito, installato con un prompt. Poi ti basta tenere il telefono in tasca.