Integração com o Replit
Adicionar um chat ao vivo ao seu app Replit
O Replit Agent constrói seu app, o Replit publica num endereço replit.app. Para seus visitantes poderem falar com você, passe o prompt do Hooky para o Agent, publique de novo e responda pelo celular.
Por que um chat num app Replit
Um app Replit muitas vezes é um produto de verdade: agendamento, ferramenta interna, um pequeno SaaS. Seus primeiros usuários vão travar em alguma coisa, e você quer saber na hora, não por um e-mail três dias depois. O balão do Hooky deixa eles escreverem para você de dentro do app, sem criar conta, e você responde de onde estiver.
Instalar o Hooky com o Replit Agent
Crie sua conta Hooky (grátis para um site) e cadastre seu app com o endereço publicado, por exemplo
meu-app.replit.app.Copie o prompt em Sites: a chave do seu site já está nele. Esta é a versão para o Replit.
Cole na caixa de prompt do Replit Agent e confira em Preview que o app continua funcionando.
Publique de novo: Publish no canto superior direito do editor. A versão publicada não muda até você publicar outra vez: é de propósito, para você trabalhar sem quebrar o app no ar.
O prompt para o Replit Agent
Adicione o balão de chat do Hooky a este app, em todas as páginas. Cole esta tag uma única vez, logo antes de </body>, no template HTML comum a todas as páginas enviadas ao navegador (client/index.html ou index.html em React com Vite, app/layout.tsx com o componente Script de next/script no Next.js, o template base em Flask ou Django):
<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, nem no servidor nem no cliente: o balão aparece sozinho, embaixo da tela.
Preview, replit.app e seu domínio
O Replit tem dois endereços: a pré-visualização de desenvolvimento, em replit.dev, temporária (o Replit avisa que ela pode mudar), e o app publicado, em replit.app ou no seu domínio. Cadastre no Hooky o endereço publicado e seu domínio. Para ver o balão também no Preview, o mais simples é ainda não ter cadastrado nenhum endereço: aí o balão funciona em todo lugar.
Se o seu app for restrito (senha, só o workspace, convites), só quem tem acesso vê o balão: é o esperado.
Conferir se o balão aparece
Abra o endereço publicado, não só o Preview: é ele que seus visitantes veem. O balão fica embaixo. Mande uma mensagem: ela chega em Mensagens e no seu celular. Nada? Publique de novo, confira os endereços autorizados e recarregue sem cache.
Responder e acompanhar seu app
Você responde pelo app Hooky (iPhone, iPad, Mac, Android) ou pelo painel web. Seu usuário pode anexar um print ou um PDF: ótimo para um bug. Se ele sair antes da sua resposta depois de deixar o e-mail, ela chega por e-mail.
Seu app Replit tem servidor: aproveite. Peça ao Agent para enviar seus eventos (cadastro, pedido) para a API do Hooky com a chave secreta do site, guardada nos secrets do Replit, e para publicar uma notificação no canal do site a cada pedido. Veja a documentação.
Perguntas frequentes
Preciso de um plano pago do Replit?
Não para o Hooky. Você só precisa de um app publicado; segundo o Replit, a publicação existe em todos os planos, com limites no plano gratuito (um app publicado, que expira depois de 30 dias). Confira as condições atuais no Replit.
O Agent adicionou código de servidor para o Hooky
O balão não precisa disso: peça para ele tirar esse código e deixar só a tag no template HTML.
Onde guardo a chave secreta do site?
Nos secrets do Replit (uma variável de ambiente, por exemplo HOOKY_SECRET_KEY), nunca no código enviado ao navegador. Já a chave pública da tag pode ser vista por todos: é normal.
Meu app Replit é um app de celular
O balão do Hooky é feito para páginas web: funciona num app web aberto no navegador, não num app nativo.
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.