DropComments

Des retours dans votre application

DropComments SDK

Recueillez des retours dans l’application que vous développez avec une balise script, un endpoint sur votre serveur et votre propre bouton de retour. Votre équipe épingle un commentaire, un cadre ou un dessin sur l’application elle-même, et les personnes qui l’utilisent envoient leurs retours via un formulaire court. Tout arrive dans vos projets ici, où vous et votre agent IA pouvez répondre.

Installer le SDK

Gratuit pour commencer. La clé de votre application reste sur votre serveur.

Un retour sur une application ne devrait pas commencer par une capture d’écran

Quand une personne qui teste votre application remarque quelque chose, elle fait une capture d’écran, la recadre, la colle dans une discussion et écrit « le truc en haut, sur le deuxième écran ». Vous retrouvez cet écran et essayez de deviner de quoi elle parle.

Avec le script dans l’application, elle désigne directement l’élément concerné. Le commentaire arrive avec une image de l’écran tel qu’il était, l’endroit marqué et le nom de la personne qui l’a envoyé. Vous ou un agent de programmation avez tout pour corriger le problème, et la réponse s’affiche dans l’application.

Comment ça marche

  1. 1

    Ajoutez votre application

    Dans votre compte, sous Applications : son nom, les adresses où elle s’exécute et les projets qui recevront ses retours, par exemple un pour votre équipe et un pour vos clients. Une clé lui est attribuée.

  2. 2

    Ajoutez le script

    Le serveur de votre application conserve la clé et fournit à la page un jeton de courte durée pour la personne connectée, en précisant si elle fait partie de votre équipe. La page charge une balise script, que votre propre bouton de retour permet d’ouvrir. Copiez les instructions affichées par DropComments et transmettez-les à l’agent qui développe votre application : il se charge de les ajouter.

  3. 3

    Les retours arrivent

    Votre équipe appuie sur le bouton de retour, épingle un commentaire au bon endroit et écrit ; elle voit les épingles de chacun dans l’application et toutes les réponses, en direct. Les autres personnes disposent d’un formulaire court. Chaque retour devient un écran d’un Drop dans le projet correspondant.

Installer le SDK

Pour une application web avec un serveur et des utilisateurs qui se connectent. Aucun paquet à installer : une clé sur votre serveur, un endpoint qui fournit un jeton à la page, une balise script et votre propre bouton pour l’ouvrir.

  1. Ajoutez votre application dans DropComments, sous Applications : son nom, les adresses où elle s’exécute (https, ou http sur localhost et .test pendant le développement) et les projets qui recevront ses retours. Vous obtenez sa clé et l’identifiant de chaque projet.

    Ajoutez votre application

  2. Conservez la clé sur votre serveur, dans ses variables d’environnement ou ses secrets :

    DROPCOMMENTS_KEY=dc_app_…

    Jamais dans une page, dans du code envoyé au navigateur ou dans un commit. DropComments la refuse lorsqu’elle provient d’un navigateur.

  3. Ajoutez un endpoint de jetons. Pour la personne connectée, il demande un jeton à DropComments et renvoie le JSON reçu tel quel. Si personne n’est connecté, renvoyez une réponse 401 et rien ne s’affiche.

    // GET /api/feedback-token
    export async function GET(request) {
      const user = await getSignedInUser(request); // your own sign-in
      if (!user) return new Response(null, {status: 401});
    
      const res = await fetch("https://dropcomments.com/api/app/token", {
        method: "POST",
        headers: {
          authorization: `Bearer ${process.env.DROPCOMMENTS_KEY}`,
          "content-type": "application/json",
        },
        body: JSON.stringify({
          project: "YOUR_PROJECT_ID",
          user: {id: user.id, name: user.name},
          team: user.isStaff, // true: pin comments on the app. false: the short form
        }),
      });
      return new Response(res.body, {status: res.status, headers: {"content-type": "application/json"}});
    }

    Cet exemple utilise un gestionnaire de route Next.js ; le principe est le même dans un Worker, Deno ou Bun. Dans Express, renvoyez le même statut et le même JSON.

  4. Chargez le script sur chaque page, avant </body> :

    <script src="https://dropcomments.com/live.js" data-token-url="/api/feedback-token"></script>

    Il n’affiche aucun bouton par lui-même : rien n’apparaît donc pour le moment.

  5. Ajoutez votre propre bouton de retour, masqué jusqu’à ce que DropComments.ready indique qu’un jeton a été reçu. Il ouvre le panneau pour votre équipe et le formulaire court pour les autres personnes :

    <button id="feedback" hidden>Feedback</button>
    
    const button = document.getElementById("feedback");
    if (await DropComments.ready) {
      button.hidden = false;
      button.addEventListener("click", () => DropComments.open());
    }

    Placez-le là où il convient dans votre application : un en-tête, un menu, un écran de paramètres. Le panneau, le formulaire et les épingles sont fournis par le script.

  6. Si vos pages envoient une Content-Security-Policy, autorisez DropComments :

    script-src https://dropcomments.com;
    connect-src https://dropcomments.com wss://dropcomments.com;

Vous pouvez aussi laisser votre agent de programmation s’en charger. Quand vous ajoutez votre application, des instructions s’affichent avec votre clé et les identifiants des projets déjà renseignés ; transmettez-les à l’agent qui développe votre application, et il ajoute l’endpoint, le script et le bouton.

Référence

Le jeton

Votre serveur appelle POST https://dropcomments.com/api/app/token avec la clé de l’application comme jeton Bearer. project est obligatoire et correspond à l’identifiant du projet. user désigne la personne connectée ; si vous omettez son nom, le panneau lui en demande un. team détermine les outils à sa disposition. Un jeton est valable une heure, et le script en demande un nouveau à votre endpoint avant son expiration.

{
  "project": "YOUR_PROJECT_ID",
  "user": {"id": "u_123", "name": "Sam Lee"},
  "team": true
}
// → {"token": "dct.…", "expiresAt": …, "team": true, "project": {…}}

Options du script

data-token-url est votre endpoint, appelé avec les cookies de la page ; il peut renvoyer le JSON du jeton ou le jeton en texte brut. data-ui="none" n’affiche rien du tout, pour vous permettre d’utiliser votre propre formulaire : envoyez les données recueillies avec DropComments.send(). Sur ordinateur, les commentaires de l’équipe incluent une copie de la page en plus de l’image : dans le Drop, le bouton de page l’affiche, avec défilement et texte sélectionnable, et un agent peut en lire le contenu. data-capture="picture" envoie uniquement l’image. C’est toujours le cas sur téléphone et tablette.

<script src="https://dropcomments.com/live.js"
  data-token-url="/api/feedback-token"
  data-capture="picture"></script>

JavaScript

Tout est disponible dans window.DropComments une fois le script chargé. ready indique si un jeton a été reçu, pour que vous n’affichiez votre bouton qu’à ce moment-là.

await DropComments.ready; // true once a token came
DropComments.open();  // the team’s panel, or everyone else’s form
DropComments.close();
await DropComments.send({text: "The total is wrong", picture: true});
await DropComments.link(); // the team’s feedback in DropComments, or null

L’apparence de votre application

Vous choisissez le style de votre bouton de retour. Définissez ces variables sur :root pour que le panneau, le formulaire et les épingles les reprennent aussi. Les autres variables : --dc-muted, --dc-line, --dc-soft, --dc-on-accent, --dc-accent-text, --dc-pin, --dc-on-pin et --dc-button-radius.

:root {
  --dc-font: "Inter", sans-serif;
  --dc-surface: #ffffff;
  --dc-text: #111827;
  --dc-accent: #4f46e5;
  --dc-radius: 12px;
}

Préserver la confidentialité

Un commentaire contient une image de l’écran, qui montre donc ce qui s’y trouve, y compris le texte saisi (les mots de passe apparaissent sous forme de points). Marquez tout ce qui ne doit jamais quitter votre application : ces éléments sont remplacés par un rectangle gris dans l’image et exclus de la copie de la page. La copie ne contient aucun script et laisse les champs de saisie vides.

<div data-dc-hide>
  Card ending 4242
</div>

Ce que vous obtenez

Votre équipe teste une version

Épinglez un commentaire, encadrez un élément ou dessinez sur l’application en cours d’exécution, sur ordinateur ou téléphone. Chaque commentaire contient une image de l’écran avec l’endroit marqué et, sur ordinateur, une copie de la page aussi. « Ça ne marche pas ici » suffit.

Les personnes qui l’utilisent

Un formulaire court avec l’option « Désigner l’élément » et une image de l’écran. Ces personnes ne voient jamais les retours des autres, et leur image n’est envoyée que si elles laissent la case cochée.

Bêta-testeurs et clients

Faites se connecter les personnes avec qui vous testez l’application et choisissez celles qui font partie de l’équipe. Un client qui examine un site de préproduction y laisse ses remarques directement.

Un agent se charge des corrections

Un agent de programmation connecté à DropComments lit chaque commentaire et la page sur laquelle il a été laissé, effectue la modification et répond. La réponse s’affiche dans l’application.

Aux couleurs de votre application

Le formulaire destiné aux utilisateurs reprend vos couleurs, votre police et vos arrondis grâce à quelques variables CSS. Vous pouvez aussi utiliser votre propre formulaire et envoyer son contenu en un appel.

Votre clé reste entre vos mains

La clé reste sur votre serveur, jamais dans une page. Les retours sont acceptés uniquement depuis les adresses de votre application, leur nombre est limité par personne et chaque projet est choisi par son identifiant.

Dans votre boîte de réception

Chaque retour arrive sous forme de ticket dans la boîte de réception de son projet, prêt à être pris en charge.

Questions

Est-ce compatible avec toutes les applications ?

Avec toute application web disposant d’un serveur et d’utilisateurs qui se connectent : le serveur indique à DropComments qui est chaque personne. Les jeux et autres applications affichées dans un canvas fonctionnent aussi ; leur surface de jeu ou de travail est transmise sous forme d’image.

Qu’envoie un commentaire de l’équipe ?

Une image de l’écran tel qu’il était, avec les éléments marqués data-dc-hide grisés. Depuis un ordinateur, une copie de la page est aussi jointe (sauf si vous définissez data-capture="picture") : elle contient ses styles et ses images, sans scripts, avec les champs de saisie laissés vides et les éléments marqués data-dc-hide exclus, ainsi qu’une image de la zone. Le Drop affiche l’image, et sur ordinateur, on peut passer à la page. L’image est générée par le script à partir de la mise en page : elle est donc proche de l’original, sans être exacte. Les transformations, les filtres et les contenus ::before ou ::after sont rendus sans leurs effets. L’écran conserve aussi le contexte de sa création : l’adresse de la page (sans son #fragment), son titre, la taille de la fenêtre et le navigateur.

Puis-je séparer les retours des clients de ceux de l’équipe ?

Oui. Une application peut envoyer les retours dans plusieurs projets, et son serveur indique lequel utiliser pour chaque personne : ceux de l’équipe vont dans un projet et ceux des autres dans un autre.

Combien ça coûte ?

C’est inclus dans toutes les offres. Avec l’offre gratuite, chaque Drop de retours reste ouvert pendant une journée, puis un nouveau prend le relais ; Pro les garde ouverts.

Lire la suite

Essayez avec votre prochain fichier

Une dizaine de secondes suffit pour obtenir un lien.

Déposer un fichier