Integrazione con Cursor
Aggiungere una live chat a un sito fatto con Cursor
In Cursor il codice lo scrive l’Agent. Dagli il prompt di Hooky: trova il template comune del progetto, qualunque sia il framework, e aggiunge la bolla di chat. Pubblichi come sempre e rispondi dal telefono.
Perché una chat sul tuo sito
Quando programmi con Cursor controlli tutto: framework, hosting, dominio. Scrivere da te una chat in tempo reale, invece, vuol dire un backend, websocket, un’app mobile per rispondere… Hooky ti dà tutto questo con una riga di codice: la bolla sul sito, la casella e le notifiche sul telefono.
Installare Hooky con l’Agent di Cursor
Crea il tuo account Hooky (gratis per un sito), aggiungi il sito e copia il suo prompt in Siti: la chiave è già dentro.
Apri il progetto in Cursor e avvia l’Agent nel pannello laterale (Cmd+I su Mac).
Incolla il prompt. L’Agent cerca il template comune a tutte le pagine e aggiunge il tag. Rileggi il diff prima di accettarlo: deve comparire una sola riga (due con l’import in Next.js).
Pubblica come sempre: commit, push o il comando del tuo hosting (Vercel, Netlify, il tuo server…). Cursor non pubblica il sito al posto tuo.
Il prompt per Cursor
Aggiungi la bolla di chat di Hooky a questo sito, su tutte le pagine. Trova il template HTML comune a tutte le pagine (index.html per React o Vite, app/layout.tsx per Next.js con il componente Script di next/script e strategy="afterInteractive", il layout di base per Astro, Nuxt, SvelteKit, Rails o Django) e incollaci questo tag una sola volta, subito prima di </body>:
<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: la bolla compare da sola. Se il sito ha più template indipendenti, aggiungi il tag in ognuno e dimmi in quali.
L’Agent di Cursor può anche leggere la documentazione di Hooky per le IA: inizia il prompt con «Leggi prima https://heyhooky.com/llms.txt» e saprà anche contare le tue conversioni con Hooky.track.
Provare in locale, poi online
Per vedere la bolla sul server di sviluppo, aggiungi localhost agli indirizzi autorizzati del sito in Hooky (tutte le porte sono coperte), oppure non dichiarare ancora nessun indirizzo: la bolla funziona ovunque. Una pagina aperta come file (file://) non ha indirizzo: servila con un piccolo server locale.
Una volta pubblicato, apri il tuo dominio: la bolla è in basso e il messaggio di prova arriva in Messaggi.
Andare oltre con l’Agent
- Un pulsante «Scrivici»: chiedigli di chiamare
Hooky.open()al clic (documentazione). - Le tue statistiche:
Hooky.track("iscrizione")dopo un’iscrizione riuscita,Hooky.track("ordine", { value: 49 })dopo un pagamento (documentazione). - Lato server: gli eventi via API con la chiave segreta del sito, o i tuoi avvisi (ordine, deploy, errore) nel canale del sito, nel formato dei webhook di Slack (documentazione).
Domande frequenti
Cursor può installare Hooky senza che io apra la dashboard?
Sì. Di’ all’Agent: «Leggi https://heyhooky.com/llms.txt, poi creami un account Hooky con la mia email e installa la bolla su https://miosito.it». Chiama l’API di registrazione, mette il tag e tu ricevi un’email per attivare l’account. Vedi Creare un account da un’IA.
E il server MCP?
Arriverà presto: allora Cursor potrà installare Hooky da solo. Nel frattempo, il prompt e llms.txt fanno il lavoro.
Il mio sito ha una CSP rigida
Come minimo, autorizza https://heyhooky.com per gli script, e https://api.heyhooky.com e wss://api.heyhooky.com per le connessioni (richieste e tempo reale). Le foto allegate ai messaggi possono arrivare da un’altra origine: se una non si vede, la console del browser ti dirà cosa aggiungere.
La bolla rallenta il mio sito?
Si carica in async, senza dipendenze né cookie, e vive in uno Shadow DOM: non blocca il rendering e non tocca i tuoi stili.
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.