PT
Entrar Comece grátis

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

  1. Crie sua conta Hooky (grátis para um site) e cadastre seu site: nome e endereço, por exemplo meu-site.lovable.app.

  2. 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.

  3. 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).

  4. 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.

  1. No seu projeto do Lovable, abra Connectors, depois Add custom no canto superior direito, e escolha MCP server.

  2. 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).

  3. 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.

  1. Abra Connectors, depois Add custom no canto superior direito, e escolha Custom connector.

  2. 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/.
  3. 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.

  4. 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.

  5. 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.