talkieback

Installer Talkieback

Un bouton dans votre app : vos utilisateurs parlent ou écrivent, vous lisez et vous leur répondez. Sur un site, une ligne suffit.

Sur un site, en une ligne

Collez ce code juste avant </body>, avec l'identifiant de votre app. Il est sur la page « Installation » de votre app, dans Talkieback.

HTML
<script src="https://cdn.talkieback.com/w.js" data-app="pk_live_…" async></script>

Laisser Claude Code tout installer

Collez ce prompt dans Claude Code, à la racine de votre projet. Il vous connecte à Talkieback, crée l'app, accorde le widget aux couleurs du produit, ajoute le code et vérifie l'installation. Vous autorisez l'accès une fois, et vous relisez les changements avant de les publier.

Voir le prompt
Prompt pour Claude Code
Installez Talkieback dans ce projet : le bouton de retours vocaux et écrits de talkieback.com. Utilisez les outils du serveur MCP « talkieback ».

Pour commencer, la connexion. Si les outils « talkieback » ne sont pas disponibles, lancez cette commande :
claude mcp add --transport http talkieback https://mcp.talkieback.com/mcp
Puis demandez-moi de taper /mcp et de choisir talkieback : une page de Talkieback s'ouvre pour que j'autorise l'accès. Si talkieback n'apparaît pas dans /mcp, demandez-moi de relancer Claude Code dans ce dossier avec claude --continue, puis de taper /mcp.

1. Comprenez le produit avant de toucher au code :
   - la techno (package.json, pubspec.yaml, Podfile, build.gradle…) et le fichier où se charge chaque page ;
   - les adresses : celle de production (configuration de déploiement, README, métadonnées) et celle du serveur de développement (son port) ;
   - l'identité visuelle : couleur principale et couleur d'accent (variables CSS, thème Tailwind…), police, coins plus ou moins arrondis, thème sombre ;
   - la langue de l'interface, et si elle tutoie ou vouvoie ;
   - les pages où le bouton gênerait : paiement, connexion, administration ;
   - l'endroit où un bouton « Idée ou bug ? » du produit aurait sa place : profil, menu, réglages, aide.

2. L'app. Appelez list_apps. Si une app correspond déjà à ce produit (même nom ou même adresse), reprenez-la. Sinon, créez-la avec create_app : le nom du produit, son type (web, native ou both), l'adresse de production, et pour une app native l'identifiant iOS et le package Android lus dans le projet. Passez ensuite son app_id à chaque outil. Si list_apps dit que mon nom n'est pas renseigné, renseignez-le avec set_my_name : le nom que vous connaissez (git config user.name, ou ce que je vous ai dit) ; demandez-moi s'il n'y en a pas.

3. L'apparence. Lisez get_widget_appearance, puis réglez avec update_widget_appearance ce que vous avez trouvé : signal (l'accent du produit, pour le bouton), ink (la couleur principale), radius, font (custom avec fontFamily et fontUrl seulement si la police est servie en https en .woff2), theme, lang, tone, hiddenPaths. Ne remplacez pas les textes du panneau sauf si je le demande.
   Demandez-moi si le produit est en bêta ou en production, puis réglez launcherDisplay : always en bêta (le bouton flottant partout) ; dismissible pour que l'utilisateur puisse le masquer en le glissant sur la croix ; app en production (pas de bouton flottant, le panneau s'ouvre depuis un bouton du produit, et le bouton flottant n'apparaît que quand l'équipe a répondu).

4. L'installation. Appelez get_install_guide avec la techno du produit, puis appliquez ses étapes dans le code : le code du bouton au bon endroit, le micro pour une app native, la politique de sécurité (CSP) si le projet en a une. Avec launcherDisplay à dismissible ou app, ajoutez au produit un bouton « Idée ou bug ? » à l'endroit trouvé. Sur un site, l'attribut data-talkieback-open ouvre le panneau contre lui, et data-talkieback-show fait plutôt revenir le bouton flottant masqué. En React Native, Talkieback.open({ anchor: ref }) et Talkieback.show(). Proposez-moi l'emplacement avant de l'ajouter. Déclarez avec add_app_domain chaque adresse où le produit tourne et qui manque : le serveur de développement (localhost avec son port), la préproduction.
   Proposez-moi les notifications, qui préviennent l'utilisateur d'une réponse même app fermée : si j'accepte, appelez enable_notifications avec la techno et appliquez ce qu'il dit. Ne cherchez pas les clés de push : je les dépose moi-même dans Talkieback.
   Si les utilisateurs se connectent, mettez en place l'identité vérifiée sans me le demander : appelez enable_verified_identity et appliquez ce qu'il dit, le hash calculé sur le serveur et l'appel identify avec l'identifiant, l'e-mail et le nom de l'utilisateur connecté. Le secret va dans la variable d'environnement TALKIEBACK_SECRET du serveur, dans le fichier d'environnement local seulement s'il est ignoré par git, jamais dans le code ni dans un commit. N'inventez jamais de secret. Si l'offre ne comprend pas l'identité vérifiée, passez et dites-le-moi dans le compte rendu.

5. La vérification. Pour un site, lancez le serveur de développement si c'est possible, puis start_install_check avec une page où le bouton doit s'afficher. Ouvrez le lien renvoyé dans un navigateur, ou demandez-moi de l'ouvrir, puis lisez get_install_status et corrigez ce qui est en échec. Pour une app native, demandez-moi de la lancer en mode debug : get_install_status montre le résultat de Talkieback.check(). Pour finir, demandez-moi d'envoyer un retour de test depuis le bouton.

6. La routine du matin. Si list_apps indique que l'offre comprend la lecture et le tri des retours depuis un agent, proposez-moi une routine Claude qui trie les nouveaux retours chaque matin : elle pose les étiquettes, attribue et repère les doublons sans prévenir aucun utilisateur, puis me laisse un bilan avec ce qui reste à décider (statuts, réponses aux questions). Sinon, ne la proposez pas. Si j'accepte :
   - La routine tourne dans le cloud de Claude, pas sur cet ordinateur : le serveur branché ici, dans Claude Code, ne lui sert pas. Si Talkieback n'est pas encore un connecteur de mon compte claude.ai, demandez-moi de l'ajouter comme connecteur personnalisé sur claude.ai/customize/connectors, avec l'adresse https://mcp.talkieback.com/mcp, puis d'autoriser l'accès avec cette app à ouvrir en premier, en gardant cochés « Lire les retours » et « Répondre aux utilisateurs et trier les retours ».
   - Demandez-moi à quelle heure la lancer (par défaut tous les jours à 8 h 07 : quelques minutes après l'heure pile, elle part à l'heure). Puis écrivez pour moi la commande à taper, en entier, sur ce modèle :
     /schedule tous les jours à 8 h 07, triez les nouveaux retours Talkieback : appelez l'outil get_procedure du connecteur Talkieback avec name « trier », mode « routine » et filtre « app_id l'app_id, nouveaux depuis 24 heures », puis suivez-la.
   - Pendant la création, gardez le connecteur Talkieback et retirez ceux dont le tri n'a pas besoin. Le tri ne touche pas au code : si un dépôt est demandé, celui du projet convient.
   - Si /schedule est inconnu, Claude Code n'est pas connecté avec un abonnement claude.ai (Pro, Max, Team ou Enterprise) : dites-le-moi et passez.

7. Le compte rendu. Dites-moi ce que vous avez changé (fichiers et réglages), si la routine du matin est en place, et ce qui reste à faire : la mise en ligne, la variable TALKIEBACK_SECRET à ajouter chez l'hébergeur de production si l'identité vérifiée est en place, et la clause à reprendre dans la politique de confidentialité (Réglages › Confidentialité dans Talkieback). Lisez manage_subscription et dites-moi mon offre en une phrase, avec la fin de l'essai s'il y en a un : si je veux en changer, demandez-moi laquelle, au mois ou à l'année, puis donnez-moi le lien de paiement. Ne faites aucun commit sans me le demander.

Sites et web apps

Apps natives

Apps hybrides

Pour les développeurs

Une étape bloque ? Écrivez-nous.