> ## Documentation Index
> Fetch the complete documentation index at: https://docs.jelou.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Crie um projeto

> Crie um projeto do zero ou clone um existente para reaproveitar toda a sua configuração.

Um projeto é o espaço onde vivem seus workflows, seus canais, suas variáveis e sua configuração. Ao criar um novo, você pode começar do zero ou partir de uma cópia de um projeto que já tem.

## Crie o projeto

<Steps>
  <Step title="Abra o criador de projetos">
    Acesse **Projetos** e clique em **Criar projeto**. Você também pode criá-lo pelo seletor de projetos na parte superior.
  </Step>

  <Step title="Escolha como quer começar">
    O modal oferece duas opções:

    * **Do zero** — um projeto novo, sem configuração herdada.
    * **Clonar existente** — copia a configuração de um projeto que você já tem.
  </Step>

  <Step title="Dê um nome e uma descrição">
    O **nome** aceita entre 3 e 50 caracteres e a **descrição** até 120. Os dois campos mostram um contador para você saber quanto ainda resta.
  </Step>

  <Step title="Complete a opção escolhida">
    Se escolher **Clonar existente**, selecione o projeto de origem em **Projeto a clonar**. Se escolher **Do zero**, você pode abrir **Configuração avançada** para escrever um **Erro padrão**.
  </Step>

  <Step title="Confirme">
    Clique em **Criar projeto** ou em **Clonar projeto**. Ao terminar, o Jelou leva você direto para o projeto novo.
  </Step>
</Steps>

## Do zero

É a opção para começar do início. O Jelou cria o projeto e o deixa pronto para trabalhar:

* Um primeiro workflow com um único nó **Start**, o ponto de entrada a partir do qual você começa a construir.
* Um canal de WhatsApp de testes com o mesmo nome do seu projeto — se o projeto se chama `Meu projeto`, o canal também — para você testar seus fluxos sem conectar o seu próprio número.

Em **Configuração avançada** você pode definir o **Erro padrão**: a mensagem que a pessoa recebe se algum nó do fluxo falhar e não houver nenhum outro erro configurado. É opcional e você pode alterá-lo depois na configuração do projeto.

<Tip>
  Se ainda não sabe bem o que construir, comece do zero e siga o guia do [seu primeiro workflow](/pt/guias/primeiros-passos/seu-primeiro-workflow).
</Tip>

## Clonar existente

Clonar copia a **estrutura** de um projeto, não os seus dados. É a opção ideal para criar um ambiente de testes, replicar uma implementação para outra marca ou partir de um fluxo que já funciona sem mexer no original.

No campo **Projeto a clonar** aparecem apenas os projetos da sua própria empresa. O projeto de origem não é modificado em nenhum momento.

### O que é copiado

| Item                                           | Como chega ao projeto novo                                                                                                                            |
| ---------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------- |
| Workflows e nós                                | Todos os canvas de cada workflow são copiados, com seus nós, conexões e posições                                                                      |
| Canais                                         | Os canais do projeto original não são replicados. O projeto novo recebe um canal de WhatsApp de testes com o nome do projeto, igual a começar do zero |
| Rotas de AI Routing                            | Recriadas apontando para os workflows copiados, com o mesmo nome e status                                                                             |
| Perguntas de treinamento                       | Copiadas como estão em cada workflow                                                                                                                  |
| Configuração do projeto                        | Ajustes gerais e de e-commerce são herdados do original                                                                                               |
| Integrações instaladas                         | Continuam disponíveis no projeto novo                                                                                                                 |
| Nós de apps do marketplace e de bases de dados | São preservados e seguem usando os mesmos recursos da sua empresa                                                                                     |
| Transferências para agente humano              | Mantêm a configuração de atribuição                                                                                                                   |
| Variáveis                                      | São copiadas com a sua definição                                                                                                                      |
| Secrets                                        | São copiados apenas pelo nome, sem o valor                                                                                                            |

### O que revisar antes de publicar

Algumas coisas ficam intencionalmente em branco porque estão atreladas ao projeto original ou são informações sensíveis:

| Item                            | O que você precisa fazer                                                                                                                    |
| ------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------- |
| Valores dos secrets             | Os secrets são copiados apenas pelo nome, sem o valor. Escreva-os novamente.                                                                |
| Conhecimento do AI Agent        | As fontes e arquivos de conhecimento não são copiados. Faça o upload de novo.                                                               |
| Nós que enviam um WhatsApp Flow | O nó e suas conexões são preservados, mas nenhum flow fica selecionado.                                                                     |
| Nós de template HSM             | Mantêm suas saídas e conexões, mas você precisa escolher o template novamente.                                                              |
| Canais                          | Nenhum canal do projeto original é transferido, nem mesmo o número de WhatsApp. Conecte os seus ou teste com o canal de WhatsApp de testes. |
| Conversas e histórico           | Cada projeto tem o seu próprio histórico. O clone começa vazio.                                                                             |

<Warning>
  Os secrets são copiados apenas pelo nome, sem o valor. Se você publicar o clone sem preenchê-los, todo nó que depender deles vai falhar em execução.
</Warning>

<Note>
  Ao concluir a clonagem, o Jelou publica automaticamente uma primeira versão do projeto novo para você testá-lo na hora. Consulte [publicar versões](/pt/guias/primeiros-passos/publicar-versoes) para entender como funciona o histórico.
</Note>

## Identifique os projetos clonados

Todo projeto criado por clonagem fica marcado com a etiqueta **Clonado**. Assim você diferencia uma cópia de um projeto criado do zero sem abrir a configuração dele. Passe o cursor sobre a etiqueta para ver o detalhe: *Este projeto foi criado como uma cópia de outro projeto*.

| Onde você vê             | Como aparece                                                     |
| ------------------------ | ---------------------------------------------------------------- |
| Tabela de **Projetos**   | Etiqueta **Clonado** ao lado do nome do projeto                  |
| Seletor de projetos      | Ícone ao lado de cada projeto da lista                           |
| Barra superior do Studio | Ícone ao lado do projeto aberto e em cada opção do menu suspenso |
| Configuração do projeto  | Etiqueta **Clonado** no card de informações                      |

### Origem do clone

Na configuração do projeto, o card de informações ganha duas linhas quando o projeto é um clone:

| Linha          | O que mostra                                                      |
| -------------- | ----------------------------------------------------------------- |
| **Origem**     | A etiqueta **Clonado**                                            |
| **Clonado de** | O nome do projeto de origem e o ID dele, com um botão para copiar |

<Note>
  Se o projeto de origem foi excluído, **Clonado de** mostra apenas o ID. A rastreabilidade se mantém mesmo que o original não exista mais.
</Note>

## Depois de criar o projeto

<Steps>
  <Step title="Preencha os secrets">
    Vá à configuração do projeto e informe o valor de cada secret copiado pelo nome.
  </Step>

  <Step title="Selecione flows e templates novamente">
    Abra os nós marcados como pendentes e escolha o WhatsApp Flow ou o template HSM correspondente.
  </Step>

  <Step title="Teste o fluxo">
    Use o canal de WhatsApp de testes ou o [tester](/pt/guias/primeiros-passos/tester) para verificar se tudo responde como você espera.
  </Step>

  <Step title="Conecte seu canal real">
    Quando o projeto estiver pronto, [conecte seu número de WhatsApp](/pt/guias/canais/whatsapp) para entrar em produção.
  </Step>
</Steps>

## Perguntas frequentes

<AccordionGroup>
  <Accordion title="Posso clonar um projeto de outra empresa?">
    Não. A lista de **Projeto a clonar** mostra apenas projetos da sua própria empresa, e a clonagem é recusada se o projeto não pertencer a você.
  </Accordion>

  <Accordion title="O projeto original é modificado?">
    Não. A clonagem apenas lê o projeto de origem. Seu nome, seus workflows e seus canais ficam intactos.
  </Accordion>

  <Accordion title="O que acontece se a clonagem falhar no meio do caminho?">
    O Jelou reverte tudo o que havia criado até aquele momento. Você não fica com um projeto pela metade na lista — pode simplesmente tentar de novo.
  </Accordion>

  <Accordion title="Posso mudar o nome ou a descrição depois?">
    Sim. Em **Projetos**, abra o menu do projeto e escolha **Editar** para alterar o nome, a descrição e o erro padrão.
  </Accordion>

  <Accordion title="Posso remover a etiqueta Clonado?">
    Não. A etiqueta reflete como o projeto foi criado, então ela permanece mesmo que você mude o nome ou a configuração.
  </Accordion>

  <Accordion title="As bases de dados são duplicadas?">
    Não. Os nós de base de dados do clone continuam apontando para as mesmas bases de dados da sua empresa. Se quiser dados separados, crie uma base nova e troque no nó.
  </Accordion>
</AccordionGroup>

## Próximos passos

<CardGroup cols={2}>
  <Card title="Seu primeiro workflow" icon="diagram-project" href="/pt/guias/primeiros-passos/seu-primeiro-workflow">
    Construa um fluxo simples de pergunta e resposta no seu projeto novo.
  </Card>

  <Card title="AI Routing" icon="route" href="/pt/guias/primeiros-passos/ai-routing">
    Entenda como o Jelou decide qual workflow atende cada mensagem.
  </Card>

  <Card title="Publicar versões" icon="rocket" href="/pt/guias/primeiros-passos/publicar-versoes">
    Aprenda a publicar mudanças e a voltar para uma versão anterior.
  </Card>

  <Card title="Conecte o WhatsApp" icon="whatsapp" href="/pt/guias/canais/whatsapp">
    Leve seu projeto para produção com o seu próprio número.
  </Card>
</CardGroup>