Integração com o Lovable
Adicionar um chat ao vivo ao seu site Lovable
Seu site Lovable está no ar e seus visitantes têm perguntas. Com o Hooky, um balão de chat aparece em todas as páginas: você cola um prompt no Lovable, publica e responde pelo celular.
Por que um chat num site Lovable
O Lovable leva você da ideia ao site em uma noite. Mas um site novinho também traz visitantes em dúvida: «vocês entregam em Curitiba?», «o formulário não funciona no meu celular», «tem horário no sábado?». Sem um jeito fácil de perguntar, eles vão embora.
O balão do Hooky dá esse jeito a eles, sem criar conta. Você recebe uma notificação e responde pelo app. E como um site Lovable é um app React (Vite), uma única tag no index.html cobre todas as páginas.
Instalar o Hooky no Lovable
Crie sua conta Hooky (grátis para um site) e cadastre seu site: nome e endereço, por exemplo
meu-site.lovable.app.Copie o prompt de instalação em Sites: ele já traz a chave do seu site. O de baixo é o mesmo, adaptado ao Lovable, com uma chave de exemplo.
Abra seu projeto no Lovable e cole o prompt no chat do projeto, no modo Build (os modos Chat e Plan conversam ou preparam um plano sem mexer no código).
Publique: botão Publish no canto superior direito do editor e depois Publish changes se o site já estiver no ar. Enquanto você não publicar, a versão no ar fica sem o balão.
O prompt para o Lovable
Adicione o balão de chat do Hooky a este site, em todas as páginas. Cole esta tag uma única vez no index.html, na raiz do projeto, logo antes de </body>:
<script src="https://heyhooky.com/widget.js" data-site-key="SUA_CHAVE_PUBLICA" async></script>
Deixe-a como está no index.html: não a mova para um componente React nem a adicione com um useEffect. Não altere o endereço do script nem o atributo data-site-key, e não mude mais nada.
Num plano pago do Lovable, você mesmo pode conferir: aba Code, arquivo index.html; a linha deve estar logo antes de </body>. No plano gratuito o editor de código é somente leitura, mas dá para olhar.
Ou: conectar o Hooky como conector MCP
O Lovable também pode falar com o Hooky diretamente, pelo servidor MCP. Sem prompt para copiar: a IA do Lovable cria o seu site no Hooky e adiciona a bolha.
No seu projeto do Lovable, abra Connectors, depois Add custom no canto superior direito, e escolha MCP server.
Cole o endereço do servidor,
https://api.heyhooky.com/mcp, clique em Add & authorize e entre no Hooky (ou crie sua conta, é grátis para um site).Escreva no chat do projeto, no modo Build: “Crie meu site no Hooky com o endereço deste projeto e adicione a bolha de chat no index.html, logo antes de </body>.” Depois, Publish changes.
O conector só serve ao chat do Lovable enquanto você constrói: o site publicado não precisa dele, a bolha fica na sua tag. Você também pode pedir ao Lovable para ligar o agente de IA do seu site (planos Criador e Studio) ou resumir suas últimas conversas.
Para admins de um espaço do Lovable: o conector Hooky
O conector MCP é pessoal e só serve ao chat. Se você é admin ou proprietário de um espaço (workspace) do Lovable, também pode criar nele um conector próprio «app + chat» para a API do Hooky. Duas diferenças: ele fica disponível para toda a equipe do espaço (prático para uma agência que constrói os sites dos clientes), e os apps construídos no espaço podem chamar a API depois de publicados, por exemplo para mostrar as últimas conversas ou as estatísticas num painel só da equipe. O Lovable guarda a chave do lado dele: ela não aparece nem no chat nem no código do projeto. O conector só aparece nesse espaço.
A bolha não precisa de conector nenhum: continua sendo uma tag no index.html. Os passos seguem a documentação do Lovable sobre conectores próprios; os nomes podem mudar de uma versão para outra.
Abra Connectors, depois Add custom no canto superior direito, e escolha Custom connector.
Details:
- Display name:
Hooky(o identificador interno vem dele e não muda depois); - Short description: «Chat ao vivo e agente de IA para os seus sites»;
- Description: «Cria os sites do Hooky, pega a tag da bolha, ajusta a aparência e o agente de IA, lê as conversas e as estatísticas.»;
- Logo: baixe o ícone quadrado
https://heyhooky.com/assets/icon-512.png(512 × 512 px) e envie com Upload logo; - Category: Support;
- Documentation URL:
https://heyhooky.com/pt/docs/.
- Display name:
Authentication:
- método Bearer token, Credential label: «Chave de API do Hooky (hka_…)»;
- API base URL:
https://api.heyhooky.com; - Test request: Method
GET, Path/v1/account(200 com uma chave válida, 401 caso contrário).
Você não digita nenhuma chave neste formulário: cada pessoa informa a sua ao se conectar.
Agent knowledge: Name «Hooky API», Description «As rotas da API do Hooky e as armadilhas a evitar», e em Content, cole todo o texto de
https://heyhooky.com/integrations/lovable/hooky-connector.md(em inglês, sem nenhum segredo). Depois Create.Conecte: no Hooky, abra Desenvolvedores e crie uma chave só para o Lovable. No Lovable, encontre o Hooky no catálogo de conectores, clique em Connect e cole a chave. Em Sharing, a conexão é privada por padrão: compartilhe com o espaço só se toda a equipe puder acessar sua conta Hooky, porque uma chave abre a conta inteira.
Depois, no chat de um projeto, no modo Build:
Uma frase para o chat do Lovable
Com o conector Hooky, crie um site no Hooky para o endereço publicado deste projeto e cole a tag de instalação no index.html, logo antes de </body>. Adicione também uma página só para a equipe, atrás do login, que liste as últimas conversas do Hooky. Nunca coloque a chave de API no código do navegador.
Se um campo tiver outro nome na sua conta, use os mesmos valores: token Bearer, https://api.heyhooky.com, GET /v1/account. Para cortar o acesso a qualquer momento, revogue a chave em Desenvolvedores, no Hooky.
Conferir se o balão aparece
Abra seu endereço publicado (meu-site.lovable.app ou seu domínio) numa nova aba e recarregue. O balão fica embaixo, à direita por padrão. Mande uma primeira mensagem para você mesmo: ela chega na hora em Mensagens.
Não apareceu nada? Nesta ordem:
- você clicou em Publish changes depois da mudança;
- o endereço que você testa está nos endereços autorizados do site no Hooky (assim que existe um, o balão fica escondido nos outros);
- a tag continua intacta, com a chave certa (peça ao Lovable para mostrar a linha).
Seu domínio e o endereço lovable.app
O Lovable publica primeiro seu site num endereço lovable.app, depois você conecta seu próprio domínio. Cadastre os dois na página do site, no Hooky: conversas e estatísticas ficam no mesmo lugar, e o balão funciona nos dois sem reinstalar nada. Não precisa adicionar www.: seusite.com.br também cobre www.seusite.com.br.
Responder aos seus visitantes
As mensagens de todos os seus sites chegam numa única caixa de entrada, no app para iPhone, iPad, Mac e Android, ou no painel web. Uma notificação avisa você. Seus visitantes podem mandar fotos ou um PDF (um print do erro, por exemplo), e se algum sair antes da sua resposta depois de deixar o e-mail, sua resposta vai atrás dele por e-mail, com um link para retomar a conversa.
Quer ir além? Peça também ao Lovable para contar seus cadastros ou pedidos com Hooky.track: o prompt está esperando na aba Estatísticas, e tudo está na documentação.
Perguntas frequentes
O balão aparece na pré-visualização do editor do Lovable?
A pré-visualização do editor roda num endereço de desenvolvimento. Enquanto você não cadastrar nenhum endereço no Hooky, o balão aparece em todo lugar; depois que cadastrar, só aparece nesses. O mais simples: teste no endereço publicado.
O Lovable colocou a tag fora do index.html
Acontece: uma IA gosta de «organizar» o código num componente. É só dizer: «Coloque de volta a tag do Hooky, do jeito que estava, no index.html, logo antes de </body>, e tire do componente». Depois publique de novo.
Preciso de um plano pago do Lovable?
Não para o Hooky: o prompt passa pelo chat do projeto. Você só precisa poder publicar o site. Já o domínio próprio depende do seu plano do Lovable.
Tenho vários sites no Lovable
Crie um site no Hooky para cada um: cada prompt tem a sua chave. O plano Grátis cobre um site, o Criador dez e o Studio cinquenta, e todos chegam na mesma caixa de entrada.
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.