# Instalar a Qixoo num site que já existe

Adicionar a Qixoo leva cerca de um minuto e não muda nada em como o seu site foi feito
nem onde ele está hospedado.

## O trecho

```html
<script src="https://qixoo.app/qixoo.js" data-key="SEU_SITE_ID" defer></script>
```

Cole **uma vez, antes de `</head>`, em cada página**. Depois publique ou faça o deploy
do site como você faria normalmente.

`SEU_SITE_ID` é o Site ID mostrado no card do site no painel — clique no ícone de
copiar ao lado dele.

## Passo a passo

1. Entre em `https://qixoo.app/dashboard/`. Link mágico por e-mail ou Google, sem
   senha. E-mails novos ganham conta automaticamente no plano Free.
2. **Sites → + Add site** → informe um nome e a URL do site.
3. No card novo, abra **Connect → Install**.
4. Copie o trecho e cole no seu HTML, ou copie o **AI install prompt** e entregue ao
   seu assistente de código (Cursor, Claude, v0, Lovable) — ele insere a tag para você.
5. Publique o site e clique em **Open editor** no card. Seu site no ar abre com uma
   camada de edição por cima.

Para os visitantes nada muda até você fazer uma edição e salvá-la.

## Onde colar, por plataforma

- **HTML escrito à mão** — no `<head>` de cada página.
- **Um framework ou gerador de sites estáticos** — no layout ou template compartilhado,
  para cair em todas as páginas.
- **Construtores de site** — quase todos têm uma opção «Custom code → head»; use essa.
- **Webflow** — Site Settings → Custom Code → Head Code. Exige um plano pago de site do
  Webflow.
- **WordPress** — o `header.php` do tema, ou qualquer plugin de scripts no cabeçalho.

## O Site ID é secreto?

Não, e não é uma senha. O Site ID apenas identifica **qual** site o editor e a API
pública de conteúdo estão tratando. Ele não consegue logar ninguém, não consegue mudar
seu conteúdo e não revela nada que já não esteja público na sua página. Editar exige
estar logado na sua conta Qixoo, e o editor usa um token separado de vida curta que
nunca aparece no seu HTML. O Site ID no código-fonte da sua página é tão inofensivo
quanto o próprio endereço da página.

Na API de conteúdo para desenvolvedores o cabeçalho HTTP ainda se chama literalmente
`X-API-Key` — esse é o formato de transporte e carrega o mesmo valor do Site ID.

## Notas

- Sites conectados antes com o nome de script antigo `vibe-cms.js` continuam
  funcionando; não é preciso fazer nada.
- O loader tem cerca de 3 KB, não define cookies, não rastreia e não envia dados de
  visitantes a ninguém.
- Single-page apps que renderizam o DOM de novo depois do carregamento são suportadas
  na medida do possível. Teste uma página antes de prometer a um cliente. HTML
  renderizado no servidor e exportações estáticas são o caso confiável.

Próximo: [Edição](https://qixoo.app/pt/docs/editing.md) ·
[Acesso do cliente](https://qixoo.app/pt/docs/client-access.md)
