Intégration Replit
Ajouter un chat en direct à ton app Replit
Replit Agent construit ton app, Replit la publie sur une adresse en replit.app. Pour que tes visiteurs puissent te parler, colle le prompt Hooky à l’Agent, republie, et réponds-leur depuis ton téléphone.
Pourquoi un chat sur une app Replit
Une app Replit, c’est souvent un vrai produit : une prise de rendez-vous, un outil interne, un petit SaaS. Tes premiers utilisateurs vont buter sur quelque chose, et tu veux le savoir tout de suite, pas dans un e-mail trois jours plus tard. La bulle Hooky leur permet de t’écrire depuis l’app, sans compte à créer, et tu réponds où que tu sois.
Installer Hooky avec Replit Agent
Crée ton compte Hooky (gratuit pour un site) et déclare ton app avec son adresse publiée, par exemple
mon-app.replit.app.Copie le prompt dans Sites : la clé de ton site y est déjà. Voici sa version pour Replit.
Colle-le dans la boîte de prompt de Replit Agent, puis vérifie dans Preview que l’app marche toujours.
Republie : Publish en haut à droite de l’éditeur. La version publiée ne change pas tant que tu ne publies pas à nouveau : c’est voulu, pour que tu puisses travailler sans casser l’app en ligne.
Le prompt pour Replit Agent
Ajoute la bulle de chat Hooky à cette app, sur toutes les pages. Colle cette balise une seule fois, juste avant </body>, dans le gabarit HTML commun à toutes les pages servies au navigateur (client/index.html ou index.html pour React avec Vite, app/layout.tsx avec le composant Script de next/script pour Next.js, le gabarit de base pour Flask ou Django) :
<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, ni côté serveur ni côté client : la bulle s’affiche seule, en bas de l’écran.
Preview, replit.app et ton domaine
Replit distingue deux adresses : l’aperçu de développement, en replit.dev, temporaire (Replit prévient qu’elle peut changer), et l’app publiée, en replit.app ou sur ton domaine. Déclare dans Hooky l’adresse publiée et ton domaine. Pour voir aussi la bulle dans Preview, le plus simple est de n’avoir encore déclaré aucune adresse : la bulle marche alors partout.
Si ton app est protégée (mot de passe, espace de travail, invitations), la bulle n’est visible que pour ceux qui y ont accès : c’est le comportement attendu.
Vérifier que la bulle apparaît
Ouvre l’adresse publiée, pas seulement Preview : c’est elle que voient tes visiteurs. La bulle est en bas de l’écran. Envoie un message : il arrive dans Messages et sur ton téléphone. Rien ? Republie, vérifie les adresses autorisées, puis recharge sans le cache.
Répondre, et suivre ton app
Tu réponds depuis l’app Hooky (iPhone, iPad, Mac, Android) ou l’espace web. Ton utilisateur peut joindre une capture d’écran ou un PDF : pratique pour un bug. S’il part avant ta réponse en laissant son e-mail, elle lui arrive par e-mail.
Ton app Replit a un serveur : profites-en. Demande à l’Agent d’envoyer tes événements (inscription, commande) à l’API de Hooky avec la clé secrète du site, rangée dans les secrets de Replit, et de poster une notification dans le canal du site à chaque commande. Voir la doc.
Questions fréquentes
Ai-je besoin d’une offre payante de Replit ?
Pas pour Hooky. Il te faut seulement une app publiée ; d’après Replit, la publication existe sur toutes ses offres, avec des limites sur l’offre gratuite (une app publiée, qui expire au bout de 30 jours). Vérifie les conditions actuelles chez Replit.
L’Agent a ajouté du code serveur pour Hooky
Ce n’est pas nécessaire pour la bulle : demande-lui de retirer ce code et de ne garder que la balise dans le gabarit HTML.
Où ranger la clé secrète du site ?
Dans les secrets de Replit (variable d’environnement, par exemple HOOKY_SECRET_KEY), jamais dans le code envoyé au navigateur. La clé publique de la balise, elle, peut être vue de tous : c’est normal.
Mon app Replit est une app mobile
La bulle Hooky est faite pour les pages web : elle marche dans une app web ouverte dans le navigateur, pas dans une app native.
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.