Feedback dentro do seu app
DropComments SDK
Receba feedback dentro do app que você está criando com uma tag de script, um endpoint no seu servidor e um botão de Feedback próprio. Sua equipe marca um comentário, um retângulo ou um desenho no próprio app, e quem usa o app envia feedback por um formulário curto. Tudo chega aos seus projetos aqui, onde você e seu agente de IA respondem.
Instale o SDKGrátis para começar. A chave do seu app fica no seu servidor.
O feedback sobre um app não deveria começar com uma captura de tela
Quando alguém que está testando seu app encontra algo, tira uma captura de tela, recorta, cola em uma conversa e escreve “aquilo lá em cima, na segunda tela”. Você vai procurar a tela e tenta adivinhar de qual elemento a pessoa está falando.
Com o script no app, a pessoa aponta o que encontrou no próprio lugar. O comentário chega com uma imagem da tela como ela estava, o local marcado e a identificação de quem enviou, pronto para você ou um agente de programação fazer a correção. E a resposta aparece no app.
Como funciona
- 1
Adicione seu app
Na sua conta, em Apps: o nome, os endereços em que ele funciona e os projetos que vão receber o feedback, por exemplo, um para sua equipe e outro para seus clientes. O app recebe uma chave.
- 2
Adicione o script
O servidor do app guarda a chave e fornece à página um token de curta duração para quem está conectado, informando se a pessoa faz parte da sua equipe. A página carrega uma tag de script, e seu próprio botão de Feedback abre a interface. Cole o que o DropComments mostrar no agente que está criando seu app, e ele adiciona tudo.
- 3
O feedback chega
Sua equipe clica em Feedback, marca o local e escreve; todos veem as marcações de toda a equipe no app e cada resposta, em tempo real. As outras pessoas recebem um formulário curto. Cada feedback chega como uma tela de um Drop no projeto correspondente.
Instale o SDK
Para um app web com servidor e usuários que fazem login. Não há pacote para instalar: uma chave no seu servidor, um endpoint que fornece um token à página, uma tag de script e um botão próprio que abre a interface.
Adicione seu app no DropComments, em Apps: o nome, os endereços em que ele funciona (https, ou http em localhost e .test durante o desenvolvimento) e os projetos que vão receber o feedback. Você recebe a chave do app e o id de cada projeto.
Mantenha a chave no seu servidor, nas variáveis de ambiente ou nos segredos:
DROPCOMMENTS_KEY=dc_app_…
Nunca em uma página, em código que chega ao navegador ou em um commit. O DropComments recusa a chave quando ela vem de um navegador.
Adicione um endpoint de token. Para quem estiver conectado, ele solicita um token ao DropComments e retorna o JSON recebido, sem alterações. Se ninguém estiver conectado, responda com 401 e nada será exibido.
// 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 um manipulador de rota do Next.js; funciona da mesma forma em um Worker, Deno ou Bun. No Express, retorne o mesmo status e JSON.
Carregue o script em todas as páginas, antes de
</body>:<script src="https://dropcomments.com/live.js" data-token-url="/api/feedback-token"></script>
Ele não cria um botão próprio, então nada aparece ainda.
Adicione seu próprio botão de Feedback, oculto até que
DropComments.readyindique que um token chegou, abrindo o painel para sua equipe e o formulário curto para as outras pessoas:<button id="feedback" hidden>Feedback</button> const button = document.getElementById("feedback"); if (await DropComments.ready) { button.hidden = false; button.addEventListener("click", () => DropComments.open()); }Coloque onde fizer sentido no seu app: no cabeçalho, em um menu ou na tela de configurações. O painel, o formulário e as marcações ficam por conta do script.
Se suas páginas enviam uma Content-Security-Policy, permita o DropComments:
script-src https://dropcomments.com; connect-src https://dropcomments.com wss://dropcomments.com;
Ou deixe seu agente de programação fazer isso. Ao adicionar seu app, você recebe instruções com a chave e os ids dos projetos já preenchidos; cole no agente que está criando seu app, e ele adiciona o endpoint, o script e o botão.
Referência
O token
Seu servidor chama POST https://dropcomments.com/api/app/token com a chave do app como token bearer. project é obrigatório e deve conter o id. user é a pessoa conectada; se você omitir o nome, o painel pede que ela informe um. team determina quais ferramentas ela recebe. Um token dura uma hora, e o script solicita um novo ao seu endpoint antes que ele expire.
{
"project": "YOUR_PROJECT_ID",
"user": {"id": "u_123", "name": "Sam Lee"},
"team": true
}
// → {"token": "dct.…", "expiresAt": …, "team": true, "project": {…}}Opções do script
data-token-url é seu endpoint, acessado com os cookies da página; ele pode responder com o JSON do token ou com o token em texto simples. data-ui="none" não exibe nada, para você usar seu próprio formulário: envie o que ele coletar com DropComments.send(). Em um computador, os comentários da equipe trazem uma cópia da página junto com a imagem: no Drop, o botão de página mostra essa cópia, com rolagem e texto selecionável, e um agente consegue ler o texto. data-capture="picture" envia apenas a imagem. Celulares e tablets sempre enviam apenas a imagem.
<script src="https://dropcomments.com/live.js" data-token-url="/api/feedback-token" data-capture="picture"></script>
JavaScript
Tudo fica em window.DropComments assim que o script carrega. ready indica se um token chegou, para você só exibir seu botão depois disso.
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 nullO visual do seu app
Você define o estilo do seu botão de Feedback. Defina estas variáveis em :root, e o painel, o formulário e as marcações também as usarão. As demais: --dc-muted, --dc-line, --dc-soft, --dc-on-accent, --dc-accent-text, --dc-pin, --dc-on-pin e --dc-button-radius.
:root {
--dc-font: "Inter", sans-serif;
--dc-surface: #ffffff;
--dc-text: #111827;
--dc-accent: #4f46e5;
--dc-radius: 12px;
}Como preservar a privacidade
Um comentário leva uma imagem da tela, então mostra o que está nela, inclusive o texto digitado (senhas aparecem como pontos). Marque tudo o que nunca deve sair do seu app: esse conteúdo vira um retângulo cinza na imagem e fica de fora da cópia da página. A cópia não contém scripts e deixa os campos de entrada em branco.
<div data-dc-hide> Card ending 4242 </div>
O que você ganha
Sua equipe testando uma versão
Marque um ponto, trace um retângulo ou desenhe no app em funcionamento, no computador ou no celular. Cada comentário leva uma imagem da tela com o local marcado e, no computador, uma cópia da página também. Assim, basta dizer “aqui não funciona”.
Quem usa o app
Um formulário curto com a opção Apontar o local e uma imagem da tela. As pessoas nunca veem o feedback de outras, e a imagem só é enviada se elas mantiverem a opção marcada.
Testadores beta e clientes
Dê acesso por login às pessoas que estão testando o app com você e defina quem faz parte da equipe. Um cliente que revisa um site de homologação deixa comentários diretamente nele.
Corrigido por um agente
Um agente de programação conectado ao DropComments lê cada comentário e a página em que ele foi feito, faz a alteração e responde. A resposta aparece no app.
Com o visual do seu app
O formulário dos usuários adota suas cores, fonte e cantos a partir de algumas variáveis CSS. Ou use seu próprio formulário e envie os dados com uma chamada.
Sua chave continua com você
A chave fica no seu servidor, nunca em uma página. O feedback só é aceito a partir dos endereços do seu app, com limite por pessoa e cada projeto escolhido pelo id.
Direto para sua Caixa de entrada
Cada feedback chega como um chamado na Caixa de entrada do projeto, pronto para alguém assumir.
Perguntas
Funciona com qualquer app?
Qualquer app web com servidor e usuários que fazem login: o servidor informa ao DropComments quem é cada pessoa. Jogos e outros apps desenhados em um canvas também funcionam; a área desenhada chega como uma imagem.
O que um comentário da equipe envia?
Uma imagem da tela como ela estava, com tudo o que você marcar com data-dc-hide em cinza. No computador, também vai uma cópia da página ao lado (a menos que você defina data-capture="picture"): com os estilos e as imagens incluídos e sem scripts, com os campos preenchidos em branco e tudo o que estiver marcado com data-dc-hide removido, além de uma imagem do local. O Drop mostra a imagem, e no computador dá para alternar para a página. A imagem é desenhada pelo script a partir do layout da página, então fica próxima do original, mas não idêntica: transformações, filtros e conteúdo de ::before ou ::after aparecem sem os efeitos. A tela do Drop também guarda o contexto em que foi criada: o endereço da página (sem o #fragmento), o título, o tamanho da janela e o navegador.
Posso separar o feedback dos clientes do feedback da equipe?
Sim. Um app pode enviar feedback para vários projetos, e o servidor dele define o destino para cada pessoa. Assim, o feedback da equipe vai para um projeto e o de todos os outros vai para outro.
Quanto custa?
Está disponível em todos os planos. No plano gratuito, cada Drop de feedback fica aberto por um dia; depois, um novo é iniciado. O Pro mantém os Drops abertos.
Continue lendo
Experimente com seu próximo arquivo
Leva cerca de dez segundos para gerar um link.
Solte um arquivo