PT
Entrar Comece grátis

Integração com o Codex

Um chat ao vivo no seu site com o Codex

O Codex escreve o código no seu projeto, pelo terminal, pelo seu editor ou pelo app de desktop. Passe o prompt do Hooky: ele coloca o balão de chat no seu template. Depois adicione o servidor MCP do Hooky, e o Codex lê suas conversas e estatísticas, ou cria um site para você.

Duas formas de conectar o Hooky ao Codex

Para ter um chat no seu site, um prompt basta: o Codex adiciona uma linha ao seu template, você publica e responde pelo celular. O servidor MCP é um extra: dá ao Codex acesso à sua conta Hooky (sites, conversas, canais, estatísticas, agente de IA). Você pode fazer uma coisa sem a outra.

Seu site saiu de uma conversa no chatgpt.com, sem repositório? O guia ChatGPT é para você.

Instalar o balão com um prompt

  1. Crie sua conta Hooky (grátis para um site), cadastre seu site e copie o prompt dele em Sites: a chave já está dentro.

  2. Abra o Codex no seu projeto: codex na raiz do repositório, a extensão no seu editor, ou o app de desktop nessa pasta.

  3. Cole o prompt. O Codex encontra o template comum e adiciona a tag. Revise a mudança: só uma linha deve aparecer (duas com o import no Next.js).

  4. Publique como sempre: commit, push ou o comando da sua hospedagem. Se você passar a tarefa ao Codex no seu repositório do GitHub, revise a mudança proposta e faça o merge.

O prompt para o Codex

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.

Comece o prompt com «Leia primeiro https://heyhooky.com/llms.txt»: o Codex também vai saber contar seus cadastros ou pedidos com Hooky.track.

Adicionar o servidor MCP do Hooky

O servidor MCP do Hooky fica em https://api.heyhooky.com/mcp (transporte HTTP). O CLI do Codex, a extensão para o seu editor e o app de desktop do ChatGPT leem a mesma configuração: você escreve uma vez.

  1. Adicione o servidor em ~/.codex/config.toml (crie o arquivo se ele não existir):

    [mcp_servers.hooky]
    url = "https://api.heyhooky.com/mcp"
  2. Entre na sua conta num terminal:

    codex mcp login hooky

    Uma página do Hooky abre no navegador: entre (ou crie sua conta), escolha a conta e autorize o acesso. No app de desktop ou na extensão, o botão Authenticate faz o mesmo.

  3. Confira: codex mcp list no terminal, ou /mcp no Codex, mostra o hooky.

Prefere uma chave de API? Crie em Desenvolvedores, coloque numa variável de ambiente (export HOOKY_API_KEY=hka_…) e diga ao Codex para enviá-la no cabeçalho Authorization: Bearer:

[mcp_servers.hooky]
url = "https://api.heyhooky.com/mcp"
bearer_token_env_var = "HOOKY_API_KEY"

Assim a chave fica fora do arquivo de configuração. Tudo está detalhado na documentação do servidor MCP.

O que você pode pedir ao Codex

  • «Adicione o chat do Hooky a este projeto»: ele cria o site na sua conta (ou encontra o que já existe), pega a tag e coloca no seu template.
  • «Resuma minhas conversas de ontem»: quem escreveu, sobre o quê, e o que espera resposta.
  • «Ligue o agente de IA do meu site»: nos planos pagos, ele ativa o agente, indica a página que ele deve ler e pode adicionar suas instruções.
  • «Adicione meu domínio de teste aos endereços autorizados»: as configurações do site (endereços, cor, lado, estilo) sem abrir o painel.
  • «Procure as notificações de pedidos de ontem»: ele lê os canais dos seus sites, onde chegam seus alertas.
  • «Prepare uma resposta para o último visitante»: ele escreve, mostra para você e só envia com o seu ok.

Manter o controle

Uma resposta enviada pelo Codex chega de verdade ao seu visitante, assinada com o seu nome: o Codex deve mostrá-la antes. A conexão cria uma chave com o nome da ferramenta em Desenvolvedores; apague-a para cortar o acesso. Você continua respondendo pelo app Hooky (iPhone, iPad, Mac, Android) ou pelo painel web.

Perguntas frequentes

Preciso do servidor MCP para ter o chat no meu site?

Não. O prompt basta: o balão só precisa da tag. O servidor MCP serve para gerenciar sua conta Hooky pelo Codex.

Ainda não tenho conta Hooky

Rode codex mcp login hooky: a página de login oferece criar sua conta. Sem MCP, o Codex também pode criá-la pela API de cadastro: diga «Leia https://heyhooky.com/llms.txt, depois crie uma conta Hooky com o meu e-mail e instale o balão» (veja a documentação).

Minha máquina não tem navegador

Rode codex mcp login hooky --no-browser, feito para esse caso, ou use a chave de API com bearer_token_env_var.

E no ChatGPT na web?

O ChatGPT na web não lê a configuração local do Codex. Para um site feito numa conversa, siga o guia ChatGPT.

Como corto o acesso do Codex?

Apague a chave dele em Desenvolvedores, no Hooky, e remova a seção [mcp_servers.hooky] do seu config.toml.

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.