{"section":"tutorials","requestedLocale":"pt","requestedSlug":"gerenciando-projetos","locale":"pt","slug":"gerenciando-projetos","path":"docs/pt/tutorials/storefront/headless-cms/gerenciando-projetos.md","branch":"main","content":"Projetos é uma funcionalidade do VTEX Headless CMS que simplifica o gerenciamento de vários projetos de frontend, como aplicativos móveis, sites e email marketing em uma única tela.\n\n![Projects pages](https://cdn.statically.io/gh/vtexdocs/help-center-content/refs/heads/main/docs/pt/tutorials/storefront/headless-cms/gerenciando-projetos_1.gif)\n\nCada projeto tem suas configurações, conteúdo e marca personalizados de acordo com públicos ou objetivos específicos.\n\nNeste guia, você aprenderá como gerenciar cada projeto de frontend da sua loja.\n\n## Antes de começar\nCertifique-se de que os [recursos](/pt/docs/tutorials/recursos-do-license-manager) `See CMS menu on the top-bar`, `Settings` e `CMS GraphQL API` estão associados ao seu [Perfil de acesso](/pt/tutorial/roles--7HKK5Uau2H6wxE1rH5oRbc?&utm_source=autocomplete). Caso contrário, [crie um perfil de acesso](/pt/docs/tutorials/perfis-de-acesso#criando-um-perfil-de-acesso) e adicione esses recursos a eles ou adicione esses recursos a um perfil de acesso existente.\n\n## Visão geral\nPara acessar a página de **Projetos**, entre no VTEX Admin e clique em **Storefront > Headless CMS**.\n\n![Projects overview](https://cdn.statically.io/gh/vtexdocs/help-center-content/refs/heads/main/docs/pt/tutorials/storefront/headless-cms/gerenciando-projetos_2.png)\n\n| Opção               | Descrição                                              |\n| ------------------- | ------------------------------------------------------ |\n| Cartão projeto      | Abre o projeto selecionado, para que você possa criar e editar páginas do conteúdo dele.       |\n| Configurações (⚙️) | Abre um modal com as configurações do projeto separadas em três abas: <ul><li>**Geral:** permite editar o ID do projeto e as configurações de API ou arquivar o projeto.</li> <li>**Content-Types:** conecta o projeto no Headless CMS ao código da loja via webhooks, configurando os tipos de conteúdo (content types) e as seções.</li><li>**Build:**  inicia e gerencia compilações do site. Define uma URL de webhook para notificações de compilação e um endpoint para visualizar as versões da página.</li></ul> |\n| Criar novo       | Abre uma página para configurar um novo projeto.       |\n\n## Criar novo projeto\n\nCrie um novo projeto para sua loja definindo as configurações gerais, como **ID do projeto** e **URL base de produção**. Para conectar um projeto Headless CMS ao código-fonte do seu projeto, você também precisará definir webhooks e configurações de build, como *URL de build do webhook* e * URL de pré-visualização*.\n\nO webhook é um endpoint HTTP que permite a comunicação automatizada entre o VTEX Headless CMS e o código-fonte do projeto. Ele permite, por exemplo, que o CMS notifique um projeto FastStore sobre alterações de conteúdo ou outros eventos, desencadeando ações como a sincronização de conteúdo em tempo real.\n\n1. Na página **Projetos**, clique em `Criar novo`.\n\n2. Na página **Novo projeto**, preencha os campos de acordo com a seção [Configurações do projeto](#configurações-do-projeto).\n\n3. Depois de definir cada campo da página, clique em `Criar` e uma mensagem de sucesso será exibida na tela.\n\nDepois de criar um novo projeto, você poderá criar páginas para ele com todas as rotas de URL e modelos de página compatíveis com a sua loja, como páginas iniciais, de produtos e de login.\n\nPara criar uma nova página, siga os passos em [Gerenciando páginas no Headless CMS](/pt/docs/tutorials/gerenciando-paginas)\n\n## Configurações do projeto\nAs configurações do projeto permitem que você o configure de acordo com três categorias principais:\n\n- [Geral](#geral): permite editar o ID do projeto e as configurações de API, além de arquivar o projeto.\n- [Content-Types](#content-types): conecta o projeto no Headless CMS ao código da loja via webhooks, configurando os tipos de conteúdo (content types) e as seções.\n- [Build](#build): inicia e gerencia compilações do site e define uma URL de webhook para notificações de compilação e um endpoint para visualizar as versões da página.\n\n### Geral\n\n| Nome do campo               | Descrição      | Exemplo de valor |\n| --------------------------- | -------------- | ---------------- |\n| ID do projeto (obrigatório) | ID do projeto. | `FastStore`      |\n| Storefront      | Define os storefronts da VTEX disponíveis(`FastStore` ou `Personalizado`) e sua finalidade.  | Veja a seção [Storefront](#storefront) para mais informações. |\n\n#### Storefront\n\nEste campo determina as configurações de [build](#build) com base no storefront escolhido. As opções incluem:\n\n- **VTEX Storefronts**:\n\nEscolha um storefront da sua conta (por exemplo, FastStore). Os campos de [Build](#build) se ajustam automaticamente de acordo como storefront escolhido. Você ainda poderá personalizá-los posteriormente.\n\n- **Personalizado**\n   Escolher um storefront `Personalizado` oferece a flexibilidade de definir suas próprias configurações de [build](#build).\n\n### Content-Types\n\n| Nome do campo               | Descrição      | Exemplo de valor |\n| ---------------------- | --------------------- | ----------------- |\n| URL das seções | URL do webhook para receber e salvar as seções criadas no código-fonte no Headless CMS.      |  `https://infra.io.vtex.com/vbase/v0/{nomedaconta}/master/buckets/vtex.admin-cms-graphql-rc/store/files/{builderId}/sections`       |\n| URL dos tipos de conteúdo      | URL do webhook para receber e salvar os tipos de conteúdo criados no código-fonte no Headless CMS.       | `https://infra.io.vtex.com/vbase/v0/{nomedaconta}/master/buckets/vtex.admin-cms-graphql-rc/store/files/{builderId}/content-types`       |\n\n### Build\n\n| Nome do campo               | Descrição      | Exemplo de valor |\n| ---------- | ---------- | ---------- |\n| URL das seções | URL do webhook para receber e salvar as seções criadas no código-fonte no Headless CMS.      | `https://infra.io.vtex.com/vbase/v0/{nomedaconta}/master/buckets/vtex.admin-cms-graphql-rc/store/files/{builderId}/sections`       |\n| URL dos tipos de conteúdo      | URL do webhook para receber e salvar os tipos de conteúdo criados no código-fonte no Headless CMS.       | `https://infra.io.vtex.com/vbase/v0/{nomedaconta}/master/buckets/vtex.admin-cms-graphql-rc/store/files/{builderId}/content-types`       |\n| URL de build do webhook       | URL do webhook para iniciar um novo build no Headless CMS quando uma página ou conteúdo é adicionado ou editado.</br>[Problema conhecido - O Headless CMS não está simulando dados entre espaços de trabalho](/pt/known-issues/o-headless-cms-nao-esta-simulando-dados-entre-espacos-de-trabalho--iDUOWMDKXPb6ZjO19kmO7) Devido a um problema de simulação de dados, rascunhos criados em qualquer workspace atualmente aparecem no ambiente master. Isso significa que alterações que deveriam ficar isoladas em workspaces individuais estão visíveis no workspace master | `https://app.io.vtex.com/vtex.cms-builder-sf-jamstack/v1/{nomedaconta}/master/build-releases`       |\n| Salvar URL do webhook       | URL do webhook para permitir pré-visualizações do projeto em tempo real, enviando uma notificação para que você atualize a página para refletir as alterações mais recentes no Headless CMS.       |  -       |\n| URL de pré-visualização       | URL do webhook que permite a pré-visualização de páginas no Headless CMS.       | `https://{nomedaconta}.vtex.app/api/preview`       |\n\n## Editar projeto\nApós criar o projeto, você também pode editar todas as informações que definiu durante a [criação do projeto](#criar-novo-projeto).\nNa página principal **Projetos**, clique em **Configurações** (⚙️). Em seguida, um modal aparecerá com três abas de configurações: [Geral](#geral), [Content-Types](#content-types) e [Build](#build).\n\n### Restaur a URL padrão das seções\n\nDepois de [criar o projeto](#criar-novo-projeto), para editar o campo [URL das seções](#content-types), clique em `Editar`, adicione a nova URL do webhook e clique em `Salvar`. Para restaurar a URL padrão, clique em `Restaurar URL padrão`.\n\n## Arquivar projeto\nO arquivamento de um projeto desativa a API e o acesso ao seu conteúdo.\nPara arquivar um projeto, siga os passos abaixo:\n\n1. Acesse **Storefront > Projetos**.\n\n2. Escolha o projeto que deseja arquivar e clique em **Configurações** (⚙️). Isso abrirá um modal.\n\n3. No modal, clique em `Arquivar projeto` na página `Geral`. Uma mensagem pop-up aparecerá confirmando se você deseja arquivar o projeto.\n![Arquivar projeto](https://cdn.statically.io/gh/vtexdocs/help-center-content/refs/heads/main/docs/pt/tutorials/storefront/headless-cms/gerenciando-projetos_3.png)\n4. Clique em `Arquivar`. Em seguida, será exibida uma mensagem informando que o projeto foi arquivado com sucesso.\n\nPara restaurar um projeto arquivado, siga os passos em [Restaurar projeto](#restaurar-projeto).\n\n### Restaurar projeto\nAo restaurar um projeto, sua API é reativada e o conteúdo do projeto pode ser acessado novamente. Para restaurar um projeto, siga os passos abaixo:\n\n1. Acesse **Storefront > Projetos**.\n\n2. Clique no cartão do projeto arquivado.\n\n3. Clique em `Restaurar projeto`. Uma mensagem pop-up aparecerá confirmando se você deseja restaurar o projeto.\n\n4. Clique em `Restaurar`. Em seguida, será exibida uma mensagem informando que o projeto foi restaurado com sucesso."}