Intégration Cursor
Ajouter un chat en direct à un site codé avec Cursor
Dans Cursor, c’est l’Agent qui écrit le code. Donne-lui le prompt Hooky : il trouve le gabarit commun de ton projet, quel que soit le framework, et y pose la bulle de chat. Tu déploies comme d’habitude, et tu réponds depuis ton téléphone.
Pourquoi un chat sur ton site
Quand tu codes avec Cursor, tu maîtrises tout : ton framework, ton hébergeur, ton domaine. Écrire toi-même un chat en temps réel, en revanche, c’est un backend, des websockets, une app mobile pour répondre… Hooky te donne tout ça avec une ligne de code : la bulle sur ton site, la boîte de réception et les notifs sur ton téléphone.
Installer Hooky avec l’Agent de Cursor
Crée ton compte Hooky (gratuit pour un site), déclare ton site et copie son prompt dans Sites : la clé y est déjà.
Ouvre ton projet dans Cursor et lance l’Agent dans le panneau latéral (Cmd+I sur Mac).
Colle le prompt. L’Agent cherche le gabarit commun à toutes les pages et y ajoute la balise. Relis le diff avant de l’accepter : une seule ligne doit apparaître (deux avec l’import pour Next.js).
Déploie comme d’habitude : commit, push, ou la commande de ton hébergeur (Vercel, Netlify, ton serveur…). Cursor ne publie pas ton site à ta place.
Le prompt pour Cursor
Ajoute la bulle de chat Hooky à ce site, sur toutes les pages. Trouve le gabarit HTML commun à toutes les pages (index.html pour React ou Vite, app/layout.tsx pour Next.js avec le composant Script de next/script et strategy="afterInteractive", le layout de base pour Astro, Nuxt, SvelteKit, Rails ou Django) et colles-y cette balise une seule fois, juste avant </body> :
<script src="https://heyhooky.com/widget.js" data-site-key="TA_CLE_PUBLIQUE" async></script>Ne modifie ni l’adresse du script ni l’attribut data-site-key. N’ajoute aucun autre code : la bulle s’affiche seule. Si le site a plusieurs gabarits indépendants, ajoute la balise dans chacun et dis-moi lesquels.
L’Agent de Cursor peut aussi lire la doc de Hooky pour les IA : ajoute « Lis d’abord https://heyhooky.com/llms.txt » au début du prompt, et il saura aussi compter tes conversions avec Hooky.track.
Tester en local, puis en ligne
Pour voir la bulle sur ton serveur de développement, ajoute localhost aux adresses autorisées du site dans Hooky (tous les ports sont couverts), ou ne déclare encore aucune adresse : la bulle marche alors partout. Une page ouverte comme fichier (file://) n’a pas d’adresse : sers-la avec un petit serveur local.
Une fois déployé, ouvre ton domaine : la bulle est en bas de l’écran, et ton message de test arrive dans Messages.
Aller plus loin avec l’Agent
- Un bouton « Nous écrire » : demande-lui d’appeler
Hooky.open()au clic (doc). - Tes stats :
Hooky.track("inscription")après une inscription réussie,Hooky.track("commande", { value: 49 })après un paiement (doc). - Côté serveur : les événements par l’API avec la clé secrète du site, ou tes alertes (commande, déploiement, erreur) dans le canal du site, au format des webhooks Slack (doc).
Questions fréquentes
Cursor peut-il installer Hooky sans que j’ouvre le tableau de bord ?
Oui. Dis à l’Agent : « Lis https://heyhooky.com/llms.txt, puis crée-moi un compte Hooky avec mon e-mail et installe la bulle sur https://mon-site.fr ». Il appelle l’API d’inscription, pose la balise, et tu reçois un e-mail pour activer ton compte. Voir Créer un compte depuis une IA.
Et le serveur MCP ?
Il arrive bientôt : Cursor pourra alors installer Hooky par lui-même. En attendant, le prompt et llms.txt font le travail.
Mon site a une politique CSP stricte
Il faut au minimum autoriser https://heyhooky.com pour les scripts, et https://api.heyhooky.com ainsi que wss://api.heyhooky.com pour les connexions (requêtes et temps réel). Les photos jointes aux messages peuvent venir d’une autre origine : si l’une ne s’affiche pas, la console du navigateur te dira quoi ajouter.
La bulle ralentit-elle mon site ?
Elle se charge en async, sans dépendance ni cookie, et vit dans un Shadow DOM : elle ne bloque pas l’affichage et ne touche pas à tes styles.
Les autres outils
Tes visiteurs ont des questions. Réponds-leur d’où tu es.
Gratuit pour un site, installé en un prompt. Ensuite, garde ton téléphone dans la poche.