Integração com o Cursor
Adicionar um chat ao vivo a um site feito com o Cursor
No Cursor, quem escreve o código é o Agent. Dê a ele o prompt do Hooky: ele encontra o template comum do seu projeto, seja qual for o framework, e adiciona o balão de chat. Você publica como sempre e responde pelo celular.
Por que um chat no seu site
Quando você programa com o Cursor, controla tudo: o framework, a hospedagem, o domínio. Já escrever você mesmo um chat em tempo real significa backend, websockets, um app de celular para responder… O Hooky entrega tudo isso com uma linha de código: o balão no seu site, a caixa de entrada e as notificações no seu celular.
Instalar o Hooky com o Agent do Cursor
Crie sua conta Hooky (grátis para um site), cadastre seu site e copie o prompt dele em Sites: a chave já está nele.
Abra seu projeto no Cursor e abra o Agent no painel lateral (Cmd+I no Mac).
Cole o prompt. O Agent procura o template comum a todas as páginas e adiciona a tag. Revise o diff antes de aceitar: deve aparecer uma única linha (duas com o import no Next.js).
Publique como sempre: commit, push ou o comando da sua hospedagem (Vercel, Netlify, seu servidor…). O Cursor não publica o site por você.
O prompt para o Cursor
Adicione o balão de chat do Hooky a este site, em todas as páginas. Encontre o template HTML comum a todas as páginas (index.html em React ou Vite, app/layout.tsx no Next.js com o componente Script de next/script e strategy="afterInteractive", o layout base em Astro, Nuxt, SvelteKit, Rails ou Django) e cole lá esta tag uma única vez, logo antes de </body>:
<script src="https://heyhooky.com/widget.js" data-site-key="SUA_CHAVE_PUBLICA" async></script>Não altere o endereço do script nem o atributo data-site-key. Não adicione nenhum outro código: o balão aparece sozinho. Se o site tiver vários templates independentes, adicione a tag em cada um e me diga em quais.
O Agent do Cursor também pode ler a documentação do Hooky para IAs: comece o prompt com «Leia primeiro https://heyhooky.com/llms.txt» e ele também vai saber contar suas conversões com Hooky.track.
Testar localmente e depois no ar
Para ver o balão no seu servidor de desenvolvimento, adicione localhost aos endereços autorizados do site no Hooky (todas as portas ficam cobertas), ou ainda não cadastre nenhum endereço: aí o balão funciona em todo lugar. Uma página aberta como arquivo (file://) não tem endereço: sirva-a com um pequeno servidor local.
Depois de publicar, abra seu domínio: o balão fica embaixo, e sua mensagem de teste chega em Mensagens.
Ir além com o Agent
- Um botão «Fale com a gente»: peça para ele chamar
Hooky.open()no clique (documentação). - Suas estatísticas:
Hooky.track("cadastro")depois de um cadastro bem-sucedido,Hooky.track("pedido", { value: 49 })depois de um pagamento (documentação). - No servidor: os eventos pela API com a chave secreta do site, ou seus alertas (pedido, deploy, erro) no canal do site, no formato dos webhooks do Slack (documentação).
Perguntas frequentes
O Cursor consegue instalar o Hooky sem eu abrir o painel?
Sim. Diga ao Agent: «Leia https://heyhooky.com/llms.txt, depois crie uma conta Hooky com o meu e-mail e instale o balão em https://meusite.com.br». Ele chama a API de cadastro, coloca a tag, e você recebe um e-mail para ativar a conta. Veja Criar uma conta a partir de uma IA.
E o servidor MCP?
Vem aí em breve: o Cursor vai poder instalar o Hooky sozinho. Até lá, o prompt e o llms.txt fazem o trabalho.
Meu site tem uma CSP rígida
No mínimo, autorize https://heyhooky.com para os scripts, e https://api.heyhooky.com e wss://api.heyhooky.com para as conexões (requisições e tempo real). As fotos anexadas às mensagens podem vir de outra origem: se alguma não aparecer, o console do navegador diz o que adicionar.
O balão deixa meu site mais lento?
Ele carrega em async, sem dependências nem cookies, e vive num Shadow DOM: não bloqueia a renderização nem mexe nos seus estilos.
Outras ferramentas
Seus visitantes têm perguntas. Responda de onde você estiver.
Grátis para um site, instalado com um prompt. Depois, é só deixar o celular no bolso.