---
title: "Sites de visitantes"
description: "Um agente prepara um site antes de o proprietário ter uma conta, e o proprietário o reivindica."
canonical: "https://atelier201.com/docs/pt/platform/guest-sites"
updated: "2026-11-06"
---

# Sites de visitantes

Um site de visitante permite que um agente de IA crie um site para alguém que ainda não tem uma conta no Atelier201.
O agente prepara um rascunho e um link de demonstração. A pessoa acessa a demonstração,
cadastra-se e reivindica o site. Nada é publicado, nenhum domínio é conectado e
nenhum crédito é gasto durante o processo.

## Etapas

1. O agente prepara o site usando
   [Preparar um site antes do login](/docs/api/guest/prepare). A resposta contém o
   `site_id`, um `write_token` válido por 2 horas e um `claim_url` válido
   por 7 dias.
2. O agente envia o projeto como um arquivo tar
   ([importação](/docs/api/guest/import)) ou mantém o modelo inicial do Atelier201 e, em seguida,
   [faz a compilação](/docs/api/guest/build). Um site de visitante tem direito a 3 compilações.
3. O agente consulta [o estado do site](/docs/api/guest/retrieve) até que `demo_url`
   apareça e mostra o link à pessoa. A demonstração fica disponível por 7 dias.
4. O agente envia o `claim_url` à pessoa em uma mensagem privada.
5. A pessoa abre o link, cadastra-se ou faz login, e o site passa a ser dela.
6. Se o agente tiver solicitado, a pessoa decide se quer conectar esse agente.
   Se não aceitar, continua com o site.

Na CLI, o mesmo processo é feito com um único comando:

```bash
atelier201 site push --guest --name "Maison Dupont"
```

O comando exibe o link da demonstração e um link privado para o proprietário, e salva o token de gravação
em `.atelier201/site.json` sem nunca exibi-lo.

## O que um site de visitante não pode fazer

Um site de visitante pode ser pré-visualizado, mas não publicado. A demonstração é executada em um ambiente isolado, não é
indexada e não tem formulários. O token de gravação dá acesso somente àquele site e deixa de funcionar
quando o site é reivindicado. Um projeto de visitante tem limite de 10
MB e 500 arquivos.

Um site não reivindicado e sua demonstração expiram. Prepare o site novamente se o link tiver
expirado.

## Mantenha os segredos em sigilo

O `write_token` e o `claim_url` são credenciais de acesso. Não os compartilhe em conversas,
logs ou commits. Quem tiver o `claim_url` poderá reivindicar o site.

## Depois da reivindicação

O site passa a ser um site comum do workspace da pessoa. Para publicá-lo, ela
(ou um agente que tenha conectado, com `sites:publish`) revisa a compilação e
publica o site. A reivindicação e a conexão não equivalem a essa autorização. Consulte
[Como um site entra no ar](/docs/platform/drafts-builds-and-publishing).