Integrações · Widget de pesquisas
Pergunte dentro do produto, leia a resposta ao lado da receita.
O widget de pesquisas do próprio Keep roda pesquisas NPS, CSAT, CES e personalizadas dentro do seu produto. Cada resposta vai para a conta de onde veio, ao lado do MRR, do risco e da data de renovação.
O que você tem
As pesquisas são montadas no Keep: a pergunta, a escala, uma pergunta de acompanhamento, o agradecimento, o visual (claro, escuro ou a cor, o arredondamento e o logo da sua marca), o formato (flutuante, modal ou inline), o público (todos, usuários identificados, usuários novos, planos ou empresas) e quando aparece (na hora, depois de alguns segundos ou visualizações de página, num evento, ou quando o seu código chamar).
As respostas aparecem na conta, no Customer 360, e nos insights de feedback: NPS, receita por tipo de resposta contada uma vez por conta, feedback por status de risco e os detratores de maior MRR. Qualquer resposta pode virar uma issue. O Keep mostra as respostas ao lado da receita; ele não afirma que uma causou a outra.
Instalação
Cole o snippet
Adicione https://usekeep.dev/sdk/v1/keep.js às páginas onde as pesquisas podem aparecer e chame Keep.init com o id da pesquisa. O builder entrega o código exato, em HTML ou como componente React.
Identifique o usuário
Chame Keep.identify com o id ou o e-mail do usuário; id da empresa, id do cliente na cobrança, plano e data de cadastro são opcionais e usados para cruzamento e segmentação. Chame Keep.reset no logout.
Assine a identidade no seu servidor
Calcule o HMAC-SHA256 do id do usuário (ou do e-mail, quando não houver id) com o seu segredo de identidade, no seu servidor, e passe como assinatura. Respostas assinadas são marcadas como verificadas; você pode exigir isso.
O que o widget envia e recebe
| — | Widget de pesquisas do Keep |
|---|---|
| Recebe | Só os textos e o visual da própria pesquisa. Nada sobre os seus clientes. |
| Envia | A identidade que o seu app passa, que uma pesquisa foi exibida, e a resposta (nota e comentário). |
| Na página | Cerca de 8 KB com gzip, carregado de forma assíncrona, desenhado num Shadow DOM, textos renderizados como texto, nunca como HTML. Funciona com uma CSP estrita. |
| Cookies | Nenhum. Ele lembra quais pesquisas já foram exibidas no localStorage. |
| Falhas | Silenciosas: o widget nunca lança erro na sua página. Keep.debug as registra. |
| Guarda no Keep | Cada resposta com o e-mail e o comentário de quem respondeu, só com inserções (append-only). |
Perguntas
- O widget deixa meu produto mais lento?
- Ele carrega de forma assíncrona e não faz nada até uma pesquisa precisar aparecer. O CSS dele fica num Shadow DOM, então não pode afetar os seus estilos.
- Por que assinar a identidade?
- Qualquer coisa que um navegador envia pode ser digitada por qualquer pessoa. A assinatura HMAC prova que a resposta veio do usuário que o seu servidor diz que veio — o mesmo esquema que a Intercom usa para verificação de identidade.
- Posso ver uma prévia da pesquisa antes de publicar?
- Sim. O builder mostra o widget real com as suas configurações, e a prévia não envia nada.
- Qual plano inclui pesquisas?
- Todos os planos. Todos os recursos do Keep, incluindo todas as integrações, estão em todos os planos; o que muda entre eles é o MRR monitorado.
Outras integrações
Ouça as contas que mais pagam.
Monte uma pesquisa no Keep, cole um script e leia cada resposta ao lado da receita.