Integración con Replit
Añadir un chat en vivo a tu app de Replit
Replit Agent construye tu app y Replit la publica en una dirección replit.app. Para que tus visitantes puedan hablarte, dale el prompt de Hooky al Agent, vuelve a publicar y respóndeles desde el móvil.
Por qué un chat en una app de Replit
Una app de Replit suele ser un producto de verdad: reservas, una herramienta interna, un pequeño SaaS. Tus primeros usuarios se van a atascar en algo, y quieres saberlo enseguida, no por un email tres días después. La burbuja de Hooky les deja escribirte desde la app, sin crear cuenta, y tú respondes estés donde estés.
Instalar Hooky con Replit Agent
Crea tu cuenta de Hooky (gratis para un sitio) y añade tu app con su dirección publicada, por ejemplo
mi-app.replit.app.Copia el prompt en Sitios: la clave de tu web ya va dentro. Esta es su versión para Replit.
Pégalo en el cuadro de prompt de Replit Agent y comprueba en Preview que la app sigue funcionando.
Vuelve a publicar: Publish arriba a la derecha del editor. La versión publicada no cambia hasta que publicas de nuevo: es intencionado, para que puedas trabajar sin romper la app online.
El prompt para Replit Agent
Añade la burbuja de chat de Hooky a esta app, en todas las páginas. Pega esta etiqueta una sola vez, justo antes de </body>, en la plantilla HTML común a todas las páginas que se envían al navegador (client/index.html o index.html en React con Vite, app/layout.tsx con el componente Script de next/script en Next.js, la plantilla base en Flask o Django):
<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, ni en el servidor ni en el cliente: la burbuja aparece sola, abajo de la pantalla.
Preview, replit.app y tu dominio
Replit tiene dos direcciones: la vista previa de desarrollo, en replit.dev, temporal (Replit avisa de que puede cambiar), y la app publicada, en replit.app o en tu dominio. Declara en Hooky la dirección publicada y tu dominio. Para ver también la burbuja en Preview, lo más sencillo es no haber declarado aún ninguna dirección: la burbuja funciona entonces en todas partes.
Si tu app está protegida (contraseña, solo el espacio de trabajo, invitaciones), solo quien tiene acceso ve la burbuja: es lo esperado.
Comprobar que aparece la burbuja
Abre la dirección publicada, no solo Preview: es la que ven tus visitantes. La burbuja está abajo. Envía un mensaje: llega a Mensajes y a tu móvil. ¿Nada? Vuelve a publicar, revisa las direcciones autorizadas y recarga sin caché.
Responder y seguir tu app
Respondes desde la app de Hooky (iPhone, iPad, Mac, Android) o desde el panel web. Tu usuario puede adjuntar una captura o un PDF: muy útil para un fallo. Si se va antes de tu respuesta tras dejar su email, le llega por email.
Tu app de Replit tiene servidor: aprovéchalo. Pide al Agent que envíe tus eventos (registro, pedido) a la API de Hooky con la clave secreta del sitio, guardada en los secretos de Replit, y que publique un aviso en el canal del sitio con cada pedido. Ver la documentación.
Preguntas frecuentes
¿Necesito un plan de pago de Replit?
No para Hooky. Solo necesitas una app publicada; según Replit, la publicación está disponible en todos sus planes, con límites en el plan gratuito (una app publicada, que caduca a los 30 días). Revisa las condiciones actuales en Replit.
El Agent ha añadido código de servidor para Hooky
La burbuja no lo necesita: pídele que quite ese código y deje solo la etiqueta en la plantilla HTML.
¿Dónde guardo la clave secreta del sitio?
En los secretos de Replit (una variable de entorno, por ejemplo HOOKY_SECRET_KEY), nunca en el código que llega al navegador. La clave pública de la etiqueta sí puede verla todo el mundo: es normal.
Mi app de Replit es una app móvil
La burbuja de Hooky está hecha para páginas web: funciona en una app web abierta en el navegador, no en una app nativa.
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.