Integración con Cursor
Añadir un chat en vivo a una web hecha con Cursor
En Cursor, el código lo escribe el Agent. Dale el prompt de Hooky: encuentra la plantilla común de tu proyecto, sea cual sea el framework, y añade la burbuja de chat. Despliegas como siempre y respondes desde el móvil.
Por qué un chat en tu web
Cuando programas con Cursor, lo controlas todo: tu framework, tu hosting, tu dominio. Pero escribir tú un chat en tiempo real significa un backend, websockets, una app móvil para responder… Hooky te da todo eso con una línea de código: la burbuja en tu web, y la bandeja de entrada y las notificaciones en tu móvil.
Instalar Hooky con el Agent de Cursor
Crea tu cuenta de Hooky (gratis para un sitio), añade tu web y copia su prompt en Sitios: la clave ya va dentro.
Abre tu proyecto en Cursor y lanza el Agent en el panel lateral (Cmd+I en Mac).
Pega el prompt. El Agent busca la plantilla común a todas las páginas y añade la etiqueta. Revisa el diff antes de aceptarlo: debería aparecer una sola línea (dos con el import en Next.js).
Despliega como siempre: commit, push o el comando de tu hosting (Vercel, Netlify, tu servidor…). Cursor no publica tu web por ti.
El prompt para Cursor
Añade la burbuja de chat de Hooky a esta web, en todas las páginas. Encuentra la plantilla HTML común a todas las páginas (index.html en React o Vite, app/layout.tsx en Next.js con el componente Script de next/script y strategy="afterInteractive", el layout base en Astro, Nuxt, SvelteKit, Rails o Django) y pega ahí esta etiqueta una sola vez, justo antes de </body>:
<script src="https://heyhooky.com/widget.js" data-site-key="TU_CLAVE_PUBLICA" async></script>No cambies la dirección del script ni el atributo data-site-key. No añadas ningún otro código: la burbuja aparece sola. Si la web tiene varias plantillas independientes, añade la etiqueta en cada una y dime en cuáles.
El Agent de Cursor también puede leer la documentación de Hooky para IA: empieza el prompt con «Lee primero https://heyhooky.com/llms.txt» y sabrá además contar tus conversiones con Hooky.track.
Probar en local y luego online
Para ver la burbuja en tu servidor de desarrollo, añade localhost a las direcciones autorizadas del sitio en Hooky (cubre todos los puertos), o no declares todavía ninguna dirección: la burbuja funciona entonces en todas partes. Una página abierta como archivo (file://) no tiene dirección: sírvela con un pequeño servidor local.
Una vez desplegada, abre tu dominio: la burbuja está abajo y tu mensaje de prueba llega a Mensajes.
Ir más allá con el Agent
- Un botón «Escríbenos»: pídele que llame a
Hooky.open()al hacer clic (documentación). - Tus estadísticas:
Hooky.track("registro")tras un registro correcto,Hooky.track("pedido", { value: 49 })tras un pago (documentación). - En el servidor: los eventos por la API con la clave secreta del sitio, o tus avisos (pedido, despliegue, error) en el canal del sitio, con el formato de los webhooks de Slack (documentación).
Preguntas frecuentes
¿Puede Cursor instalar Hooky sin que yo abra el panel?
Sí. Dile al Agent: «Lee https://heyhooky.com/llms.txt, luego créame una cuenta de Hooky con mi email e instala la burbuja en https://mi-web.es». Llama a la API de registro, pone la etiqueta y tú recibes un email para activar tu cuenta. Ver Crear una cuenta desde una IA.
¿Y el servidor MCP?
Llegará pronto: entonces Cursor podrá instalar Hooky por sí mismo. Mientras tanto, el prompt y llms.txt hacen el trabajo.
Mi web tiene una CSP estricta
Como mínimo, autoriza https://heyhooky.com para los scripts, y https://api.heyhooky.com y wss://api.heyhooky.com para las conexiones (peticiones y tiempo real). Las fotos adjuntas a los mensajes pueden venir de otro origen: si alguna no se ve, la consola del navegador te dirá qué añadir.
¿La burbuja ralentiza mi web?
Se carga en async, sin dependencias ni cookies, y vive en un Shadow DOM: no bloquea el renderizado ni toca tus estilos.
Otras herramientas
Tus visitantes tienen preguntas. Respóndeles desde donde estés.
Gratis para un sitio, instalado con un prompt. Después, solo tienes que llevar el móvil en el bolsillo.