DropComments

Comentarios dentro de tu aplicación

SDK de DropComments

Recoge comentarios dentro de la app que estás creando con una etiqueta script, un endpoint en tu servidor y tu propio botón de Comentarios. Tu equipo coloca un comentario, un recuadro o un dibujo sobre la propia app, y quienes la usan envían comentarios desde un formulario breve. Todo llega a tus proyectos aquí, donde tú y tu agente de IA podéis responder.

Instala el SDK

Empieza gratis. La clave de tu app se queda en tu servidor.

Comentar algo sobre una app no debería empezar con una captura de pantalla

Cuando alguien que prueba tu app encuentra algo, hace una captura, la recorta, la pega en un chat y escribe «lo de arriba, en la segunda pantalla». Tú buscas esa pantalla e intentas adivinar a qué se refiere.

Con el script en la app, lo señala donde está. El comentario llega con una captura de la pantalla tal como estaba, el punto marcado y quién lo envió, listo para que tú o un agente de programación lo arregléis. Y la respuesta aparece en la app.

Cómo funciona

  1. 1

    Añade tu app

    En tu cuenta, en Apps: su nombre, las direcciones donde funciona y los proyectos que recibirán los comentarios; por ejemplo, uno para tu equipo y otro para tus clientes. Se le asigna una clave.

  2. 2

    Añade el script

    Su servidor guarda la clave y entrega a la página un token de corta duración para la persona que haya iniciado sesión, indicando si forma parte de tu equipo. La página carga una etiqueta script y tu propio botón de Comentarios lo abre. Pega lo que te muestra DropComments en el agente que está creando tu app y él lo añade.

  3. 3

    Llegan los comentarios

    Tu equipo pulsa Comentarios, marca el punto y escribe; ve las marcas de todos en la app y cada respuesta, en directo. Los demás ven un formulario breve. Cada envío llega como una pantalla de un Drop a su proyecto.

Instala el SDK

Para una app web con servidor y personas que inician sesión. No hay ningún paquete que instalar: una clave en tu servidor, un endpoint que entrega un token a la página, una etiqueta script y un botón propio que lo abre.

  1. Añade tu app en DropComments, en Apps: su nombre, las direcciones donde funciona (https, o http en localhost y .test durante el desarrollo) y los proyectos que recibirán sus comentarios. Obtendrás su clave y el identificador de cada proyecto.

    Añade tu app

  2. Guarda la clave en tu servidor, en sus variables de entorno o secretos:

    DROPCOMMENTS_KEY=dc_app_…

    Nunca en una página, en código que llegue al navegador ni en un commit. DropComments la rechaza si se envía desde un navegador.

  3. Añade un endpoint de tokens. Solicita a DropComments un token para la persona que haya iniciado sesión y devuelve su JSON tal cual. Si nadie ha iniciado sesión, responde con 401 y no se mostrará nada.

    // 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"}});
    }

    Escrito como un manejador de rutas de Next.js; funciona igual en un Worker, Deno o Bun. En Express, devuelve el mismo estado y JSON.

  4. Carga el script en cada página, antes de </body>:

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

    No crea ningún botón propio, así que aún no se muestra nada.

  5. Añade tu propio botón de Comentarios, oculto hasta que DropComments.ready indique que ha llegado un token, para abrir el panel a tu equipo y el formulario breve a los demás:

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

    Colócalo donde encaje en tu app: una cabecera, un menú o una pantalla de ajustes. El panel, el formulario y las marcas los proporciona el script.

  6. Si tus páginas envían una Content-Security-Policy, permite DropComments:

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

O deja que lo haga tu agente de programación. Al añadir tu app, verás unas instrucciones con tu clave y los identificadores de los proyectos ya incluidos; pégalas en el agente que está creando tu app y él añadirá el endpoint, el script y el botón.

Referencia

El token

Tu servidor llama a POST https://dropcomments.com/api/app/token con la clave de la app como token de tipo bearer. project es obligatorio y se indica por su identificador. user es la persona que ha iniciado sesión; si omites el nombre, el panel se lo pedirá. team determina qué herramientas tendrá disponibles. El token dura una hora y el script pide uno nuevo a tu endpoint antes de que caduque.

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

Opciones del script

data-token-url es tu endpoint, al que se llama con las cookies de la página; puede responder con el JSON del token o con el token como texto sin formato. data-ui="none" no muestra nada, para que uses tu propio formulario: envía lo que recoja con DropComments.send(). Desde un ordenador, los comentarios del equipo incluyen una copia de la página junto a la captura: en el Drop, el botón de página la muestra, con desplazamiento y texto que se puede seleccionar, y un agente puede leer su contenido. data-capture="picture" envía solo la captura. Los móviles y las tabletas siempre envían solo la captura.

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

JavaScript

Todo está en window.DropComments una vez cargado el script. ready indica si ha llegado un token, para que muestres tu botón solo entonces.

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

El aspecto de tu app

Tú decides el estilo de tu botón de Comentarios. Define estas variables en :root y el panel, el formulario y las marcas también las usarán. Las demás: --dc-muted, --dc-line, --dc-soft, --dc-on-accent, --dc-accent-text, --dc-pin, --dc-on-pin y --dc-button-radius.

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

Protege la privacidad

Cada comentario incluye una captura de la pantalla, así que muestra lo que hay en ella, también el texto introducido (las contraseñas aparecen como puntos). Marca cualquier elemento que nunca deba salir de tu app y aparecerá como un recuadro gris en la captura y se omitirá de la copia de la página. La copia no contiene scripts y deja vacíos los campos donde se ha escrito.

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

Qué obtienes

Tu equipo, probando una versión

Coloca una marca, traza un recuadro o dibuja sobre la app en funcionamiento, desde un ordenador o un móvil. Cada comentario incluye una captura de la pantalla con el punto marcado y, desde un ordenador, también una copia de la página, así que basta con decir «aquí falla».

Quienes la usan

Un formulario breve con la opción Señálalo y una captura de la pantalla. Nunca ven los comentarios de los demás y su captura solo se envía si dejan marcada la casilla.

Personas que prueban la beta y clientes

Haz que inicien sesión las personas con las que estás probando la app y decide quién forma parte del equipo. Un cliente que revisa un sitio de pruebas deja notas directamente sobre él.

Lo arregla un agente

Un agente de programación conectado a DropComments lee cada comentario y la página donde se hizo, aplica el cambio y responde. La respuesta aparece en la app.

Con el aspecto de tu app

El formulario para usuarios adopta tus colores, tipografía y esquinas con unas pocas variables CSS. También puedes usar tu propio formulario y enviarlo con una sola llamada.

Tu clave sigue siendo tuya

La clave se guarda en tu servidor, nunca en una página. Solo se aceptan comentarios desde las direcciones de tu app, con límites por persona y cada proyecto elegido por su identificador.

Directo a tu bandeja de entrada

Cada comentario llega como un ticket a la bandeja de entrada de su proyecto, listo para que alguien se haga cargo.

Preguntas

¿Funciona con cualquier app?

Con cualquier app web que tenga un servidor y personas que inicien sesión: el servidor le indica a DropComments quién es cada persona. Los juegos y otras apps dibujadas en un canvas también funcionan; el lienzo llega como una imagen.

¿Qué se envía con un comentario del equipo?

Una imagen de la pantalla tal como estaba, con todo lo que marques con data-dc-hide oculto en gris. Desde un ordenador, también se guarda una copia de la página junto a ella (salvo que configures data-capture="picture"): incluye sus estilos e imágenes, sin scripts, con los campos de texto vacíos y sin los elementos marcados con data-dc-hide, además de una imagen del punto señalado. El Drop muestra la imagen y, desde un ordenador, se puede cambiar a la página. El script genera la imagen a partir de la disposición de la página, así que se aproxima al original, pero no es exacta: las transformaciones, los filtros y el contenido de ::before o ::after aparecen sin esos efectos. La pantalla también guarda el contexto en el que se creó: la dirección de la página (sin su #fragment), su título, el tamaño de la ventana y el navegador.

¿Puedo separar los comentarios de los clientes de los del equipo?

Sí. Una aplicación puede enviar comentarios a varios proyectos, y su servidor indica cuál corresponde a cada persona, de modo que los del equipo van a uno y los de las demás personas a otro.

¿Cuánto cuesta?

Está incluido en todos los planes. En el plan gratuito, cada Drop de comentarios permanece abierto durante un día y después se crea uno nuevo; Pro los mantiene abiertos.

Sigue leyendo

Pruébalo con tu próximo archivo

Conseguir un enlace lleva unos diez segundos.

Suelta un archivo