# Assistente de Instalação - NetCorp

# Guia: O que você precisa para instalar o NetCorp

<article id="bkmrk-escopo-e-p%C3%BAblico-apl"><section>#### Escopo e Público

- **Aplica-se a:** preparação para a instalação do NetCorp pelo assistente de instalação, em hospedagens com cPanel ou DirectAdmin.
- **Não cobre:** envio dos arquivos do NetCorp para a hospedagem (feito pela equipe da NetCorp); uso do painel do site depois de instalado.
- **Público-alvo:** clientes que vão instalar o NetCorp na própria hospedagem, sem precisar de conhecimento técnico.

---

#### Contexto

A instalação do NetCorp é feita por um **assistente** que guia você tela por tela. Em alguns momentos ele pede informações que estão em outros lugares: o painel da hospedagem, uma conta de e-mail e uma conta na Cloudflare. Separar tudo antes deixa a instalação mais rápida e evita parar no meio.

</section><section>---

#### Objetivo

Listar o que você precisa ter em mãos antes de abrir o assistente de instalação.

</section><section>---

#### Pré-requisitos

- Os arquivos do NetCorp já estão na sua hospedagem. Se você ainda não recebeu o aviso de que eles foram enviados, fale com o suporte antes de seguir.

</section><section>---

#### Passos

##### Passo 1 - Confira o acesso ao painel da hospedagem

É o painel onde você gerencia o site, os e-mails e os arquivos. Normalmente é o **cPanel** ou o **DirectAdmin**. Você vai usar esse painel para abrir o código de acesso do assistente e, se quiser, para criar uma chave que automatiza parte da instalação.

##### Passo 2 - Confira se o site abre com cadeado (https)

Abra o endereço do seu site no navegador. Se aparecer o aviso **"não seguro"**, peça à hospedagem para ativar o certificado do domínio. O assistente não continua sem https.

##### Passo 3 - Separe uma conta de e-mail do próprio domínio

Por exemplo, **contato@suaempresa.com.br**, com a senha dela. O site usa essa conta para enviar as mensagens do formulário de contato e os resumos das estatísticas.

Durante a instalação, o assistente manda um e-mail de teste com um código, e você precisa digitar esse código. Tenha aberta uma caixa de entrada que receba esse e-mail.

##### Passo 4 - Crie uma conta gratuita na Cloudflare

É nela que você cria as chaves da proteção contra spam do site. O passo a passo está no guia "Como criar as chaves de proteção contra spam na Cloudflare".

##### Passo 5 - Crie a chave de acesso do painel (opcional, recomendado)

Com essa chave, o assistente cria sozinho o banco de dados e as tarefas agendadas. Sem ela, você faz essas partes à mão no painel da hospedagem. O passo a passo está nos guias "Como criar a chave de acesso do cPanel" e "Como criar a Login Key do DirectAdmin".

##### Passo 6 - Instale um app autenticador no celular

O painel do site pede, além da senha, um código que aparece num **app autenticador** do celular. Você ativa esse código durante a instalação, logo depois de criar a conta de administrador. Instale antes um app gratuito, por exemplo Google Authenticator, Microsoft Authenticator ou 2FAS, e separe um lugar seguro, fora do celular, para guardar os códigos de recuperação.

##### Passo 7 - Reserve um tempo sem pressa

A etapa das tarefas agendadas espera alguns minutos até a hospedagem rodar a primeira vez. Não feche o navegador no meio da instalação.

</section><section>---

#### Dicas

- **Use um só navegador do começo ao fim.** Se outro navegador abrir o assistente ao mesmo tempo, ele vê "Instalação em andamento em outra sessão".
- **Anote num lugar seguro as senhas que você criar.** São duas: a do administrador do site e a do superusuário das estatísticas. As duas pedem pelo menos 12 caracteres.
- Você não precisa conferir sozinho o que a hospedagem tem. O próprio assistente confere no começo: PHP 8.1 ou mais novo, https e pelo menos 200 MB livres de espaço. Ele também recomenda envio de arquivos de até 20 MB e memória do PHP de 256 MB.

</section><section>---

#### Problema/Solução

<table style="width:100%;"><thead><tr><th style="width:45%;">Problema</th><th style="width:55%;">Solução</th></tr></thead><tbody><tr><td>Não sei se a minha hospedagem usa cPanel ou DirectAdmin.</td><td>Veja no e-mail de boas-vindas da hospedagem ou pergunte ao suporte dela. O assistente também tenta reconhecer o painel sozinho.</td></tr><tr><td>Não tenho uma conta de e-mail do domínio.</td><td>Crie uma no painel da hospedagem, na área de contas de e-mail, antes de começar.</td></tr><tr><td>O site abre com o aviso "não seguro".</td><td>Peça à hospedagem para ativar o certificado (https) do domínio.</td></tr></tbody></table>

#### FAQ (Perguntas frequentes)

<dl><dt><details><summary>Posso pular alguma etapa e fazer depois?</summary>

Não. O assistente só conclui a instalação quando todas as etapas estão prontas: hospedagem, banco de dados, administrador, dados do site, e-mail, proteção contra spam, estatísticas e tarefas agendadas.

</details></dt><dt><details><summary>A chave de acesso do painel é obrigatória?</summary>

Não. Ela é recomendada porque o assistente faz sozinho parte do trabalho. Sem ela, você cria o banco de dados e as tarefas agendadas à mão no painel da hospedagem.

</details></dt></dl></section></article><article id="bkmrk-contatos-de-suporte-"><section>---

#### Contatos de suporte

- a preencher — Nome — Cargo — e-mail

</section><section>---

#### Controle de Mudanças

<details><summary>Informações de controle de versão</summary>

- **Última revisão** 05-11-2026
- **Próxima revisão** 05-05-2027
- **Autor** a preencher
- **Revisor** a preencher
- **Versão** 1.1.0

</details>---

</section><section>#### Notas adicionais

- Guia baseado na versão atual do assistente de instalação. Se uma tela estiver diferente, avise o suporte.

---

#### Referências

- \[Guia\] - Como abrir o assistente e encontrar o código de acesso.
- \[Guia\] - Etapa 1 - Como verificar a hospedagem e conectar o painel.

</section></article>

# Guia: Como criar as chaves de proteção contra spam na Cloudflare

<article id="bkmrk-escopo-e-p%C3%BAblico-apl"><section>#### Escopo e Público

- **Aplica-se a:** criação de um widget do Cloudflare Turnstile e das duas chaves pedidas na tela Proteção contra spam do assistente de instalação do NetCorp.
- **Não cobre:** outros serviços da Cloudflare, como DNS ou CDN. O site não precisa usar a Cloudflare para mais nada.
- **Público-alvo:** clientes que vão instalar o NetCorp na própria hospedagem.

---

#### Contexto

O Turnstile é o serviço gratuito da Cloudflare que protege o formulário de contato do site contra robôs. Para usá-lo, você cria na Cloudflare um **widget**, que é a configuração da proteção para o seu domínio. Ao criar, a Cloudflare mostra duas chaves: a **Site Key** (chave do site) e a **Secret Key** (chave secreta).

</section><section>---

#### Objetivo

Criar o widget do Turnstile para o domínio do site e copiar as duas chaves.

</section><section>---

#### Pré-requisitos

- Uma conta na Cloudflare. O cadastro é gratuito, em **dash.cloudflare.com**.
- Saber o domínio do site, por exemplo **suaempresa.com.br**.

</section><section>---

#### Passos

##### Passo 1 - Abra o Turnstile

Entre no painel da Cloudflare e, no menu, abra a página **Turnstile**.

##### Passo 2 - Crie o widget

1. Clique em **Add widget** (adicionar widget).
2. Em **Widget name**, dê um nome que você reconheça depois, por exemplo **Site - formulário de contato**.
3. Em **Hostname management**, adicione o domínio do site, o mesmo que o assistente mostra na tela Proteção contra spam.
4. Em **Widget mode**, escolha **Managed** (gerenciado).
5. Deixe as opções opcionais como estão e clique em **Create**.

##### Passo 3 - Copie as duas chaves

Depois de criar, a Cloudflare mostra a **Site Key** e a **Secret Key**. Copie as duas e guarde num lugar seguro até colá-las no assistente.

<p class="callout warning">A chave secreta é como uma senha. Não envie por e-mail nem publique em lugar nenhum. Use-a só no assistente de instalação.</p>

##### Passo 4 - Cole as chaves no assistente

Siga o guia "Etapa 3 - Como ativar a proteção contra spam".

</section><section>---

#### Dicas

- Se o painel da Cloudflare estiver em português, os nomes podem aparecer traduzidos. Procure pelos equivalentes: adicionar widget, nome, gerenciamento de nomes de host, modo e criar.
- Perdeu as chaves? Elas continuam disponíveis nas configurações do widget, na página Turnstile.

</section><section>---

#### Problema/Solução

<table style="width:100%;"><thead><tr><th style="width:45%;">Problema</th><th style="width:55%;">Solução</th></tr></thead><tbody><tr><td>O assistente diz que as chaves são de outro domínio.</td><td>Abra o widget na Cloudflare e confira se o domínio do site está em **Hostname management**. Se não estiver, adicione-o e salve.</td></tr><tr><td>Não encontro a página Turnstile no menu.</td><td>Use a busca do painel da Cloudflare e digite **Turnstile**.</td></tr></tbody></table>

#### FAQ (Perguntas frequentes)

<dl><dt><details><summary>Preciso mudar o DNS do meu domínio para a Cloudflare?</summary>

Não. O Turnstile funciona sem que o domínio use a Cloudflare para mais nada.

</details></dt></dl></section></article><article id="bkmrk-contatos-de-suporte-"><section>---

#### Contatos de suporte

- a preencher — Nome — Cargo — e-mail

</section><section>---

#### Controle de Mudanças

<details><summary>Informações de controle de versão</summary>

- **Última revisão** 23-10-2026
- **Próxima revisão** 23-04-2027
- **Autor** a preencher
- **Revisor** a preencher
- **Versão** 1.0.0

</details>---

</section><section>#### Notas adicionais

- Este guia não tem imagens: o painel da Cloudflare não foi acessado. Os nomes dos campos vêm da documentação oficial da Cloudflare e precisam ser conferidos na tela antes da aprovação.

---

#### Referências

- \[Documentação Cloudflare\] - Turnstile - Widget management (dashboard) - https://developers.cloudflare.com/turnstile/get-started/widget-management/dashboard/. Acesso em 23-10-2026.
- \[Guia\] - Etapa 3 - Como ativar a proteção contra spam.

</section></article>

# Guia: Como abrir o assistente e encontrar o código de acesso

<article id="bkmrk-escopo-e-p%C3%BAblico-apl"><section>#### Escopo e Público

- **Aplica-se a:** primeiro acesso ao assistente de instalação do NetCorp e retomada da instalação depois de uma pausa.
- **Não cobre:** as etapas da instalação em si, que têm guias próprios.
- **Público-alvo:** clientes que vão instalar o NetCorp na própria hospedagem.

---

#### Contexto

O assistente de instalação pede um **código de acesso** para impedir que outra pessoa instale no seu lugar. O código fica guardado num arquivo da sua hospedagem, que só quem tem acesso a ela consegue abrir.

</section><section>---

#### Objetivo

Abrir o assistente, encontrar o código de acesso na hospedagem e entrar na primeira etapa da instalação.

</section><section>---

#### Pré-requisitos

- Os arquivos do NetCorp já estão na hospedagem.
- Acesso ao painel da hospedagem (cPanel ou DirectAdmin).
- Ter lido o guia "O que você precisa para instalar o NetCorp".

</section><section>---

#### Passos

##### Passo 1 - Abra o assistente

No navegador, digite o endereço do seu site seguido de **/instalar**. Exemplo: **https://suaempresa.com.br/instalar**.

Aparece a tela **Acesso ao assistente de instalação**, com o campo **Código de acesso**. Deixe essa aba aberta: o código só é criado quando o assistente é aberto pela primeira vez.

![Tela Acesso ao assistente de instalação, com o campo Código de acesso e o botão Acessar assistente destacados em vermelho](https://oraculo.gk2.cloud/uploads/images/gallery/2026-11/05-tela-acesso.png)

**Figura 1** - Tela de acesso ao assistente de instalação

##### Passo 2 - Encontre o código na hospedagem

1. Em outra aba, entre no painel da sua hospedagem.
2. Abra o **Gerenciador de arquivos**. No cPanel, ele se chama **Gerenciador de Arquivos** ou **File Manager**.
3. Entre na pasta onde o site foi instalado, depois na pasta **storage** e, em seguida, na pasta **install**.
4. Clique no arquivo **codigo.txt** e escolha **Ver** ou **Editar**.
5. Copie o código. Ele tem 12 letras e números, no formato **XXXX-XXXX-XXXX**.

<p class="callout warning">Não altere nem apague o arquivo. Apenas copie o código.</p>

##### Passo 3 - Digite o código

1. Volte à aba do assistente.
2. Cole ou digite o código no campo **Código de acesso**. Tanto faz usar letras maiúsculas ou minúsculas, com ou sem os traços.
3. Clique em **Acessar assistente**.

##### Passo 4 - Confira que entrou na primeira etapa

Aparece a tela **Vamos preparar seu NetCorp**. No topo, uma barra mostra as 5 etapas da instalação, com a etapa **1 - Hospedagem** marcada. Continue pelo guia "Etapa 1 - Como verificar a hospedagem e conectar o painel".

![Barra das cinco etapas da instalação: Hospedagem, Site e banco, E-mail e proteção, Estatísticas e tarefas e Verificação final, com Hospedagem marcada](https://oraculo.gk2.cloud/uploads/images/gallery/2026-11/05-barra-etapas.png)

**Figura 2** - Barra de etapas da instalação

</section><section>---

#### Dicas

- **O código não muda sozinho.** Se fechar o navegador e voltar outro dia, use o mesmo código.
- **Ficou mais de 2 horas parado?** O assistente pede o código de novo. Digite o mesmo e continue de onde parou.
- **Faça toda a instalação no mesmo navegador.** Enquanto o assistente estiver aberto com você, outro navegador vê "Instalação em andamento em outra sessão".

</section><section>---

#### Problema/Solução

<table style="width:100%;"><thead><tr><th style="width:45%;">Problema</th><th style="width:55%;">Solução</th></tr></thead><tbody><tr><td>"Código incorreto. Confira o arquivo e tente de novo."</td><td>Confira se copiou o código inteiro, sem caracteres a mais ou a menos. As letras O, I e L e os números 0 e 1 nunca aparecem no código.</td></tr><tr><td>"Muitas tentativas" - "Acesso pausado"</td><td>Depois de 5 erros, o acesso fica pausado por segurança. Aguarde 15 minutos e tente de novo.</td></tr><tr><td>"A página expirou. Digite o código de novo."</td><td>A página ficou aberta tempo demais. Digite o código de novo.</td></tr><tr><td>"Instalação em andamento em outra sessão"</td><td>Se foi você em outro navegador, continue por lá. Se não souber o que aconteceu, fale com o suporte.</td></tr><tr><td>"O NetCorp já está instalado"</td><td>A instalação já foi concluída e o assistente fica fechado. Clique em **Entrar no painel** para usar o site.</td></tr><tr><td>"Intervenção necessária" ou "Assistente bloqueado"</td><td>O assistente encontrou algo no servidor que precisa de conferência técnica. Não tente contornar: fale com o suporte.</td></tr><tr><td>Não encontro a pasta storage ou o arquivo codigo.txt.</td><td>Confira se abriu o assistente pelo menos uma vez (Passo 1) e se está na pasta onde o site foi instalado. Se ainda assim não encontrar, fale com o suporte.</td></tr></tbody></table>

#### FAQ (Perguntas frequentes)

<dl><dt><details><summary>Por que o código não aparece na tela do assistente?</summary>

Por segurança. Só quem tem acesso à hospedagem consegue ler o arquivo, e é isso que prova que é você quem está instalando.

</details></dt><dt><details><summary>Posso fechar o navegador no meio da instalação?</summary>

Pode. O que já foi feito fica guardado. Ao voltar, abra o mesmo endereço, digite o mesmo código e continue de onde parou, de preferência no mesmo navegador.

</details></dt></dl></section></article><article id="bkmrk-contatos-de-suporte-"><section>---

#### Contatos de suporte

- a preencher — Nome — Cargo — e-mail

</section><section>---

#### Controle de Mudanças

<details><summary>Informações de controle de versão</summary>

- **Última revisão** 23-10-2026
- **Próxima revisão** 23-04-2027
- **Autor** a preencher
- **Revisor** a preencher
- **Versão** 1.0.0

</details>---

</section><section>#### Notas adicionais

- Guia baseado na versão atual do assistente de instalação. Se uma tela estiver diferente, avise o suporte.

---

#### Referências

- \[Guia\] - O que você precisa para instalar o NetCorp.
- \[Guia\] - Etapa 1 - Como verificar a hospedagem e conectar o painel.

</section></article>

# Guia: Etapa 1 - Como verificar a hospedagem e conectar o painel

<article id="bkmrk-escopo-e-p%C3%BAblico-apl"><section>#### Escopo e Público

- **Aplica-se a:** Etapa 1 (Hospedagem) do assistente de instalação do NetCorp, com ou sem conexão ao painel da hospedagem.
- **Não cobre:** como criar a chave de acesso do painel (há guias próprios) nem como corrigir itens na hospedagem.
- **Público-alvo:** clientes que vão instalar o NetCorp na própria hospedagem.

---

#### Contexto

Antes de instalar, o assistente confere se a hospedagem tem tudo o que o NetCorp precisa. Nessa mesma tela você pode **conectar o painel da hospedagem**. Assim o assistente preenche sozinho várias informações e depois cria o banco de dados e as tarefas agendadas para você.

A verificação só lê informações. Nada é alterado na hospedagem nesta etapa.

</section><section>---

#### Objetivo

Entender o resultado da verificação da hospedagem, conectar o painel (se quiser) e avançar para a Etapa 2.

</section><section>---

#### Pré-requisitos

- Ter entrado no assistente com o código de acesso (guia "Como abrir o assistente e encontrar o código de acesso").
- Para conectar o painel: a chave de acesso já criada (guias "Como criar a chave de acesso do cPanel" ou "Como criar a Login Key do DirectAdmin").

</section><section>---

#### Passos

##### Passo 1 - Leia o resultado da verificação

A tela **Vamos preparar seu NetCorp** mostra a lista de itens conferidos. Cada item tem um selo:

- **OK** (verde): está tudo certo.
- **Atenção** (amarelo): é uma recomendação e não impede a instalação.
- **Impede** (vermelho): precisa ser corrigido antes de continuar.

Acima da lista, um aviso resume o resultado:

- **Hospedagem aprovada**: pode seguir.
- **Hospedagem aprovada, com recomendações**: pode seguir. Se puder, peça os ajustes à hospedagem depois.
- **1 item impede a instalação** (ou **N itens impedem**): peça a correção à hospedagem e clique em **Conferir de novo**.

![Aviso Hospedagem aprovada, com recomendações, seguido da lista conferida com os selos OK e Atenção](https://oraculo.gk2.cloud/uploads/images/gallery/2026-11/06-lista-verificacao.png)

**Figura 1** - Resultado da verificação da hospedagem

##### Passo 2 - Conecte o painel da hospedagem (recomendado)

No topo da tela fica o bloco **Automatizar pela hospedagem - opcional**.

1. Confira o campo **Tipo de chave**: escolha **Token de API do cPanel** se a hospedagem usa cPanel, ou **Login Key do DirectAdmin** se usa DirectAdmin. Quando o assistente reconhece o painel sozinho, aparece o aviso **Painel detectado** e o campo já vem escolhido.
2. Confira o **Endereço do painel**. Normalmente ele já vem preenchido.
3. Preencha o **Usuário**. É o mesmo nome de usuário que você usa para entrar no painel da hospedagem. Às vezes ele já vem sugerido.
4. Em **Chave de acesso**, cole a chave que você criou no painel.
5. Clique em **Conectar e detectar configurações**.

<p class="callout warning">Não digite a senha do painel no campo Chave de acesso. Use sempre a chave criada para a instalação.</p>

![Bloco Automatizar pela hospedagem preenchido, com o botão Conectar e detectar configurações destacado em vermelho](https://oraculo.gk2.cloud/uploads/images/gallery/2026-11/06-conectar-painel.png)

**Figura 2** - Conexão com o painel da hospedagem

Se a conexão der certo, aparecem o aviso **Acesso salvo** e a lista **Detectado na hospedagem em…**, com o que o assistente encontrou na sua conta: domínio do site, espaço em disco, vagas de banco de dados e contas de e-mail.

![Lista Detectado na hospedagem com os itens Painel, Domínio do site, Pasta pública, PHP no painel, Disco da conta, bancos, Vagas de banco, E-mails do domínio e Servidor de envio, todos com selo OK](https://oraculo.gk2.cloud/uploads/images/gallery/2026-11/06-detectado.png)

**Figura 3** - Informações detectadas na hospedagem

##### Passo 3 - Avance para a Etapa 2

- Com o painel conectado, clique em **Continuar**.
- Se preferir não conectar o painel, clique em **Continuar manualmente**. Nesse caso, você cria o banco de dados e as tarefas agendadas à mão nas próximas etapas.

A barra do topo passa para a etapa **2 - Site e banco** e aparece a tela **Banco de dados**.

</section><section>---

#### Dicas

- A chave de acesso fica guardada só até o fim da instalação. Ao concluir, o assistente a apaga e mostra como desativá-la no painel.
- Se aparecer **Acesso salvo**, a chave já foi aceita. Não é preciso digitá-la de novo.
- Corrigiu algo na hospedagem? Clique em **Conferir de novo** para refazer a verificação.

</section><section>---

#### Problema/Solução

<table style="width:100%;"><thead><tr><th style="width:45%;">Problema</th><th style="width:55%;">Solução</th></tr></thead><tbody><tr><td>Um item aparece como **Impede**.</td><td>Mostre à hospedagem o nome do item e o texto abaixo dele (por exemplo, "PHP" ou "HTTPS") e peça a correção. Depois clique em **Conferir de novo**.</td></tr><tr><td>"Painel não confirmado"</td><td>O endereço não respondeu como um painel de hospedagem. Confira o **Endereço do painel**: é o mesmo que você usa para entrar no cPanel ou no DirectAdmin.</td></tr><tr><td>"Acesso não confirmado"</td><td>O painel recusou a chave. Confira se copiou a chave inteira e se o **Usuário** está certo. Se precisar, crie uma chave nova.</td></tr><tr><td>"A chave salva foi recusada"</td><td>A chave deixou de valer, por exemplo porque foi apagada no painel. Informe uma chave nova. A antiga só é trocada depois que a nova for aceita.</td></tr><tr><td>"Não identificamos o painel"</td><td>Escolha o **Tipo de chave** à mão ou clique em **Continuar manualmente**.</td></tr><tr><td>"Domínio do site" aparece com **Atenção**.</td><td>O painel não confirmou que o domínio é desta conta. Confira se entrou na conta certa da hospedagem. Na dúvida, fale com o suporte.</td></tr></tbody></table>

#### FAQ (Perguntas frequentes)

<dl><dt><details><summary>Os itens de Atenção vão atrapalhar o site?</summary>

Não impedem a instalação. Eles indicam limites que podem incomodar mais tarde, por exemplo ao enviar arquivos grandes. Vale pedir o ajuste à hospedagem quando puder.

</details></dt><dt><details><summary>É seguro informar a chave de acesso do painel?</summary>

A chave é diferente da sua senha e pode ser apagada no painel a qualquer momento. O assistente a guarda só até o fim da instalação e, no final, mostra como desativá-la.

</details></dt></dl></section></article><article id="bkmrk-contatos-de-suporte-"><section>---

#### Contatos de suporte

- a preencher — Nome — Cargo — e-mail

</section><section>---

#### Controle de Mudanças

<details><summary>Informações de controle de versão</summary>

- **Última revisão** 23-10-2026
- **Próxima revisão** 23-04-2027
- **Autor** a preencher
- **Revisor** a preencher
- **Versão** 1.0.0

</details>---

</section><section>#### Notas adicionais

- As capturas foram feitas num ambiente de teste. Endereços, domínios e e-mails aparecem borrados.

---

#### Referências

- \[Guia\] - Como abrir o assistente e encontrar o código de acesso.
- \[Guia\] - Como criar a chave de acesso do cPanel.
- \[Guia\] - Como criar a Login Key do DirectAdmin.

</section></article>

# Guia: Etapa 2 - Como criar o banco de dados

<article id="bkmrk-escopo-e-p%C3%BAblico-apl"><section>#### Escopo e Público

- **Aplica-se a:** tela **Banco de dados** da Etapa 2 (Site e banco) do assistente de instalação do NetCorp. Cobre o caminho automático, pelo painel da hospedagem, e o caminho manual, com um banco já criado.
- **Não cobre:** criação das tabelas, do administrador e dos dados do site (guia "Etapa 2 - Como criar a estrutura, o administrador e os dados do site").
- **Público-alvo:** clientes que vão instalar o NetCorp na própria hospedagem.

---

#### Contexto

O NetCorp guarda as páginas, as imagens e as configurações do site num **banco de dados** só dele. O nome desse banco termina em **\_netcorp**.

Se você conectou o painel da hospedagem na Etapa 1, o assistente cria o banco sozinho. Se não conectou, você cria o banco no painel da hospedagem e informa os dados dele ao assistente.

</section><section>---

#### Objetivo

Deixar o banco de dados do site criado e conferido, para avançar à criação das tabelas.

</section><section>---

#### Pré-requisitos

- Ter concluído a Etapa 1 (guia "Etapa 1 - Como verificar a hospedagem e conectar o painel").
- Caminho automático: a chave de acesso do painel. Se você conectou o painel na Etapa 1, ela já está salva.
- Caminho manual: um banco de dados MySQL **vazio**, criado no painel da hospedagem, e um usuário com permissão total nesse banco, com a senha dele.

</section><section>---

#### Passos

<span style="text-decoration:underline;">**Caminho automático (painel conectado)**</span>

##### Passo 1 - Valide o acesso ao painel

Em **Acesso ao cPanel** (ou **Acesso ao DirectAdmin**), o endereço e o usuário já vêm preenchidos. O aviso **Acesso salvo** mostra que a chave da Etapa 1 continua guardada. Clique em **Validar acesso**.

![Bloco Acesso ao cPanel com o aviso Acesso salvo e o botão Validar acesso destacado em vermelho](https://oraculo.gk2.cloud/uploads/images/gallery/2026-11/07-acesso-cpanel.png)

**Figura 1** - Validação do acesso ao painel

##### Passo 2 - Crie o banco

Aparece a lista **Situação no cPanel**. O item do banco, com nome terminado em **\_netcorp**, mostra **Atenção** e o texto "ainda não existe". Isso é normal, porque o banco ainda vai ser criado. Clique em **Criar o banco**.

![Lista Situação no cPanel com o banco ainda não existente e o botão Criar o banco destacado em vermelho](https://oraculo.gk2.cloud/uploads/images/gallery/2026-11/07-criar-banco.png)

**Figura 2** - Criação do banco de dados

##### Passo 3 - Prepare o usuário do banco

O item do banco passa para **OK**, com o texto "foi criado". Em **Usuário do banco**, clique em **Preparar o usuário e conferir**. O assistente cria o usuário do banco, dá as permissões e confere a conexão.

![Banco criado com selo OK e o botão Preparar o usuário e conferir destacado em vermelho](https://oraculo.gk2.cloud/uploads/images/gallery/2026-11/07-preparar-usuario.png)

**Figura 3** - Preparação do usuário do banco

Se aparecer o campo **Senha do usuário do banco**, é porque esse usuário já existia na hospedagem. Digite a senha dele, que não será trocada, e clique de novo em **Preparar o usuário e conferir**.

<span style="text-decoration:underline;">**Caminho manual (sem painel conectado)**</span>

##### Passo 4 - Informe um banco já criado

1. No painel da hospedagem, crie um banco de dados MySQL vazio e um usuário. Dê ao usuário **todas as permissões** nesse banco e anote a senha dele.
2. No assistente, abra **Opções avançadas: informar um banco já criado**.
3. Preencha os campos: 
    - **Servidor**: na maioria das hospedagens é **localhost**.
    - **Nome do banco**: o nome completo que aparece no painel, por exemplo **suaconta\_netcorp**.
    - **Usuário do banco** e **Senha do banco**: os do usuário que você criou.
    - **Porta**: deixe **3306**, a menos que a hospedagem indique outra.
4. Clique em **Conferir e salvar**. Se estiver tudo certo, o assistente avança sozinho. Se algo falhar, aparece a lista **Conferência do banco**, com os itens Conexão, Versão, Banco vazio e Permissão para criar tabelas, e o item com problema marcado como **Impede**.

![Opções avançadas abertas, com os campos Servidor, Nome do banco, Usuário do banco, Senha do banco e Porta e o botão Conferir e salvar](https://oraculo.gk2.cloud/uploads/images/gallery/2026-11/07-opcoes-avancadas.png)

**Figura 4** - Banco informado manualmente

<p class="callout info">O usuário do banco é usado só pelo sistema. Ele não é o seu login no painel do site, que você cria na tela seguinte.</p>

##### Passo 5 - Confira que avançou

Com o banco pronto, aparece a tela **Estrutura do banco**. Continue pelo guia "Etapa 2 - Como criar a estrutura, o administrador e os dados do site".

</section><section>---

#### Dicas

- Prefira o caminho automático. Ele escolhe o nome certo do banco, cria o usuário e confere tudo sozinho.
- No caminho manual, o banco precisa estar **vazio**. Não use o banco de outro site.
- As senhas digitadas aqui não aparecem de novo na tela. Isso é proposital.

</section><section>---

#### Problema/Solução

<table style="width:100%;"><thead><tr><th style="width:45%;">Problema</th><th style="width:55%;">Solução</th></tr></thead><tbody><tr><td>"Sem vaga para o banco"</td><td>A sua conta já usa todos os bancos que o plano permite. Apague no painel um banco que não usa mais, ou peça mais vagas à hospedagem. Depois clique em **Validar acesso** de novo.</td></tr><tr><td>"O banco não foi criado"</td><td>O painel recusou a criação. Confira no painel da hospedagem e clique em **Validar acesso** de novo. Se continuar, fale com o suporte.</td></tr><tr><td>"A chave salva foi recusada"</td><td>A chave do painel deixou de valer. Informe uma nova em **Substituir a chave**.</td></tr><tr><td>Caminho manual: o item **Conexão** aparece como **Impede**.</td><td>Confira o nome do banco, o usuário, a senha e se o usuário tem permissão no banco. No painel, o nome completo costuma ter o prefixo da conta, por exemplo **suaconta\_**.</td></tr><tr><td>Caminho manual: o item **Banco vazio** aparece como **Impede**.</td><td>O banco já tem tabelas. Crie um banco novo e vazio no painel e informe esse.</td></tr><tr><td>Caminho manual: o item **Permissão para criar tabelas** aparece como **Impede**.</td><td>No painel da hospedagem, dê ao usuário **todas as permissões** no banco.</td></tr><tr><td>"Bancos deixados por esta instalação"</td><td>Aparece se você recomeçou com outro banco. Os bancos antigos não foram apagados. Para reaproveitar os mesmos nomes, renomeie os antigos no painel. Quando não precisar mais deles, apague-os.</td></tr></tbody></table>

#### FAQ (Perguntas frequentes)

<dl><dt><details><summary>O assistente apaga algum banco da minha hospedagem?</summary>

Não. Ele só cria o banco do NetCorp e nunca apaga nenhum outro banco.

</details></dt><dt><details><summary>Errei o banco no caminho manual. Dá para trocar?</summary>

Dá. Até a verificação final, o assistente mostra o link **Recomeçar com outro banco**. Veja o guia "Como recomeçar com outro banco de dados".

</details></dt></dl></section></article><article id="bkmrk-contatos-de-suporte-"><section>---

#### Contatos de suporte

- a preencher — Nome — Cargo — e-mail

</section><section>---

#### Controle de Mudanças

<details><summary>Informações de controle de versão</summary>

- **Última revisão** 23-10-2026
- **Próxima revisão** 23-04-2027
- **Autor** a preencher
- **Revisor** a preencher
- **Versão** 1.0.0

</details>---

</section><section>#### Notas adicionais

- As capturas foram feitas num ambiente de teste com cPanel. No DirectAdmin, os textos trocam "cPanel" por "DirectAdmin".

---

#### Referências

- \[Guia\] - Etapa 1 - Como verificar a hospedagem e conectar o painel.
- \[Guia\] - Etapa 2 - Como criar a estrutura, o administrador e os dados do site.
- \[Guia\] - Como recomeçar com outro banco de dados.

</section></article>

# Guia: Etapa 2 - Como criar a estrutura, o administrador e os dados do site

<article id="bkmrk-escopo-e-p%C3%BAblico-apl"><section>#### Escopo e Público

- **Aplica-se a:** telas **Estrutura do banco**, **Administrador do NetCorp**, **Segundo fator do administrador** e **Dados do site**, que encerram a Etapa 2 (Site e banco) do assistente de instalação.
- **Não cobre:** criação do banco de dados (guia "Etapa 2 - Como criar o banco de dados").
- **Público-alvo:** clientes que vão instalar o NetCorp na própria hospedagem.

---

#### Contexto

Com o banco pronto, faltam quatro coisas para o site existir:

- as **tabelas**, que são a estrutura onde o site guarda as informações;
- a sua **conta de administrador**, que você usa para entrar no painel do site;
- o **segundo fator** dessa conta: um código do app autenticador do seu celular, pedido em todo login além da senha;
- os **dados do site**: o nome e o e-mail de contato.

</section><section>---

#### Objetivo

Criar as tabelas, a conta de administrador com o segundo fator ativo e os dados do site para chegar à Etapa 3 (E-mail e proteção).

</section><section>---

#### Pré-requisitos

- Banco de dados criado e conferido (guia "Etapa 2 - Como criar o banco de dados").
- Uma senha de pelo menos 12 caracteres para a sua conta de administrador.
- Um celular com um app autenticador instalado, por exemplo Google Authenticator, Microsoft Authenticator ou 2FAS (gratuitos, na loja de apps do celular).
- Um lugar seguro, fora do celular, para guardar os códigos de recuperação.

</section><section>---

#### Passos

##### Passo 1 - Crie as tabelas

Na tela **Estrutura do banco**, clique em **Criar as tabelas**. Pode levar alguns segundos. Não feche a página enquanto isso.

![Tela Estrutura do banco com o aviso Antes de criar e o botão Criar as tabelas destacado em vermelho](https://oraculo.gk2.cloud/uploads/images/gallery/2026-11/fUa08-criar-tabelas.png)

**Figura 1** - Criação das tabelas do site

##### Passo 2 - Crie a sua conta de administrador

Na tela **Administrador do NetCorp**, preencha:

- **Seu nome**: por exemplo, **Maria Souza**.
- **E-mail de acesso**: o e-mail que você vai usar para entrar no painel do site.
- **Senha** e **Repita a senha**: pelo menos 12 caracteres, iguais nos dois campos.

Clique em **Criar administrador**.

![Formulário Administrador do NetCorp preenchido com nome e e-mail de exemplo e o botão Criar administrador destacado em vermelho](https://oraculo.gk2.cloud/uploads/images/gallery/2026-11/5nd08-administrador.png)

**Figura 2** - Criação da conta de administrador

<p class="callout warning">Guarde bem o e-mail e a senha. Eles são o seu acesso ao painel do site depois da instalação.</p>

##### Passo 3 - Ative o segundo fator do administrador

Na tela **Segundo fator do administrador**:

1. No app autenticador, toque para adicionar uma conta e escolha a opção de **digitar a chave** (não a de ler QR code).
2. Digite a chave que aparece na tela, em grupos de 4 letras e números. Se o app pedir o tipo, escolha **baseado em tempo**.
3. Digite em **Código do app** o código de 6 dígitos que o app mostrar e clique em **Ativar segundo fator**.

![Tela Segundo fator do administrador com a chave borrada, o campo Código do app preenchido com 123456 e o botão Ativar segundo fator, destacados em vermelho](https://oraculo.gk2.cloud/uploads/images/gallery/2026-11/H8T08-segundo-fator.png)

**Figura 3** - Ativação do segundo fator

A tela mostra então **8 códigos de recuperação**, no formato **XXXXX-XXXXX**. Eles servem para entrar no painel quando você estiver sem o celular; cada um vale uma vez. Copie os 8 para um lugar seguro e clique em **Já guardei, continuar**.

![Tela com o aviso Códigos de recuperação, a lista dos 8 códigos borrados e o botão Já guardei, continuar, destacados em vermelho](https://oraculo.gk2.cloud/uploads/images/gallery/2026-11/bjC08-codigos-de-recuperacao.png)

**Figura 4** - Códigos de recuperação

<p class="callout warning">Os códigos de recuperação **não aparecem de novo**. Guarde antes de clicar em continuar.</p>

##### Passo 4 - Preencha os dados do site

Na tela **Dados do site**, preencha:

- **Nome do site**: o nome da empresa como deve aparecer no site e nos e-mails. Por exemplo, **Padaria Pão Quente**.
- **E-mail de contato**: o e-mail público da empresa, mostrado aos visitantes.

Clique em **Salvar e continuar**.

![Formulário Dados do site preenchido com nome e e-mail de exemplo e o botão Salvar e continuar destacado em vermelho](https://oraculo.gk2.cloud/uploads/images/gallery/2026-11/kWn08-dados-do-site.png)

**Figura 5** - Dados do site

##### Passo 5 - Confira que avançou

A barra do topo passa para a etapa **3 - E-mail e proteção** e aparece a tela **Envio e recebimento de e-mails**.

</section><section>---

#### Dicas

- O nome do site e o e-mail de contato podem ser mudados depois, no painel do site.
- Deixe o horário do celular no modo automático. O código do app depende da hora certa.
- Recarregar a tela do segundo fator não troca a chave: ela continua a mesma até você ativar.
- O **e-mail de acesso** do administrador e o **e-mail de contato** do site podem ser diferentes. O primeiro serve para entrar no painel; o segundo é mostrado aos visitantes.

</section><section>---

#### Problema/Solução

<table style="width:100%;"><thead><tr><th style="width:45%;">Problema</th><th style="width:55%;">Solução</th></tr></thead><tbody><tr><td>"As tabelas não foram criadas"</td><td>Leia a mensagem na tela. Se a estrutura ficou pela metade, o caminho seguro é **Recomeçar com outro banco**. O banco atual fica preservado para você conferir ou apagar depois.</td></tr><tr><td>"A senha precisa ter pelo menos 12 caracteres."</td><td>Use uma senha mais longa. Uma frase curta funciona bem, por exemplo três palavras e um número.</td></tr><tr><td>"As duas senhas não são iguais."</td><td>Digite a mesma senha nos campos **Senha** e **Repita a senha**.</td></tr><tr><td>"E-mail inválido." ou "E-mail de contato inválido."</td><td>Confira se o e-mail está completo, com @ e domínio, e sem espaços.</td></tr><tr><td>Aparece "Administrador já criado" e o assistente pede a senha.</td><td>A conta já foi criada antes, por exemplo se a página foi recarregada. Digite a senha que você usou e clique em **Continuar**. A senha não é trocada.</td></tr><tr><td>"Código inválido. Confira o horário do celular e tente de novo."</td><td>Confira se a chave foi digitada sem erro e se o horário do celular está no automático. Digite o código que está no app agora, antes de ele trocar.</td></tr><tr><td>"O banco recusou a gravação. O motivo foi registrado no log do servidor."</td><td>Clique em **Tentar de novo**. Se a mensagem continuar, fale com o suporte.</td></tr></tbody></table>

#### FAQ (Perguntas frequentes)

<dl><dt><details><summary>Posso criar outros usuários para a minha equipe?</summary>

Sim, mas depois da instalação, pelo painel do site, no menu Usuários.

</details></dt><dt><details><summary>Esqueci a senha que coloquei no administrador durante a instalação. E agora?</summary>

Se a instalação ainda não terminou, você precisa da mesma senha para continuar. Na dúvida, fale com o suporte antes de recomeçar.

</details></dt><dt><details><summary>Posso pular o segundo fator e ativar depois?</summary>

Não. Ele é obrigatório para todas as contas do painel, e o assistente só segue para os dados do site depois da ativação.

</details></dt><dt><details><summary>Fechei a tela sem anotar os códigos de recuperação. E agora?</summary>

A instalação continua normalmente. Depois de entrar no painel, gere códigos novos em Configurações › Segurança › **Trocar de celular** (guia "Como ativar e usar o segundo fator").

</details></dt></dl></section></article><article id="bkmrk-contatos-de-suporte-"><section>---

#### Contatos de suporte

- a preencher — Nome — Cargo — e-mail

</section><section>---

#### Controle de Mudanças

<details><summary>Informações de controle de versão</summary>

- **Última revisão** 05-11-2026
- **Próxima revisão** 05-05-2027
- **Autor** a preencher
- **Revisor** a preencher
- **Versão** 1.1.0

</details>---

</section><section>#### Notas adicionais

- Os nomes e e-mails das figuras são exemplos fictícios.
- Versão 1.1.0: entrou o Passo 3 (segundo fator do administrador). Nas Figuras 3 e 4, a chave, o link e os códigos de recuperação foram borrados; as capturas são do laboratório de instalação.

---

#### Referências

- \[Guia\] - Etapa 2 - Como criar o banco de dados.
- \[Guia\] - Como recomeçar com outro banco de dados.
- \[Guia\] - Como ativar e usar o segundo fator (app autenticador).

</section></article>

# Guia: Etapa 3 - Como configurar e testar o envio de e-mails

<article id="bkmrk-escopo-e-p%C3%BAblico-apl"><section>#### Escopo e Público

- **Aplica-se a:** tela **Envio e recebimento de e-mails** da Etapa 3 (E-mail e proteção) do assistente de instalação do NetCorp.
- **Não cobre:** criação da conta de e-mail na hospedagem nem a configuração do e-mail no celular ou no computador.
- **Público-alvo:** clientes que vão instalar o NetCorp na própria hospedagem.

---

#### Contexto

O site envia e-mails em dois casos: quando um visitante usa o formulário de contato e quando sai o resumo mensal das estatísticas. Para isso, ele usa uma conta de e-mail do seu domínio.

O assistente só deixa avançar depois de duas confirmações: o servidor aceitou o envio de um e-mail de teste, e você digitou o código que chegou nesse e-mail.

</section><section>---

#### Objetivo

Configurar a conta que envia os e-mails do site e confirmar que os e-mails chegam.

</section><section>---

#### Pré-requisitos

- Ter concluído a Etapa 2 (guias da Etapa 2).
- Uma conta de e-mail do próprio domínio, por exemplo **contato@suaempresa.com.br**, com a senha dela.
- Acesso a uma caixa de entrada para receber o e-mail de teste.

</section><section>---

#### Passos

##### Passo 1 - Preencha a conta de envio

Em **Conta de envio**, confira ou preencha os campos. Se você conectou o painel na Etapa 1, vários deles já vêm preenchidos, com a nota **Detectado na hospedagem**.

- **Servidor SMTP**: o endereço do servidor de envio de e-mails. Sem o painel conectado, peça esse dado à hospedagem ou procure, na área de contas de e-mail do painel, as configurações para programas de e-mail.
- **Porta** e **Segurança**: normalmente **587** com **TLS (STARTTLS)**, ou **465** com **SSL**.
- **Usuário**: normalmente o próprio endereço da conta de e-mail.
- **Senha**: a senha da conta de e-mail. Ela é sempre digitada por você.
- **E-mail do remetente**: o endereço que aparece como remetente. Use um endereço do próprio domínio.
- **Nome do remetente**: o nome que aparece para quem recebe, por exemplo o nome da empresa.

Clique em **Salvar configuração**.

![Formulário Conta de envio com servidor, porta 587, segurança TLS, usuário, senha, remetente e nome do remetente, e o botão Salvar configuração destacado em vermelho](https://oraculo.gk2.cloud/uploads/images/gallery/2026-11/09-conta-de-envio.png)

**Figura 1** - Conta de envio dos e-mails do site

##### Passo 2 - Envie o e-mail de teste

Aparece o bloco **Teste de envio**. Em **Enviar o teste para**, informe um e-mail cuja caixa de entrada você consiga abrir agora. Clique em **Enviar e-mail de teste**.

![Bloco Teste de envio com o campo Enviar o teste para preenchido e o botão Enviar e-mail de teste destacado em vermelho](https://oraculo.gk2.cloud/uploads/images/gallery/2026-11/09-teste-de-envio.png)

**Figura 2** - Envio do e-mail de teste

##### Passo 3 - Pegue o código no e-mail

Quando o servidor aceita, aparece o aviso **Servidor aceitou o envio**. Abra a caixa de entrada e procure o e-mail **Teste de e-mail da instalação**. Nele há uma linha **Código de recebimento**, com 8 letras e números no formato **XXXX-XXXX**.

##### Passo 4 - Confirme o recebimento

Em **Confirmação de recebimento**, digite o código no campo **Código recebido** e clique em **Confirmar recebimento**.

![Aviso Servidor aceitou o envio e bloco Confirmação de recebimento com o campo Código recebido preenchido e o botão Confirmar recebimento destacados em vermelho](https://oraculo.gk2.cloud/uploads/images/gallery/2026-11/09-confirmar-recebimento.png)

**Figura 3** - Confirmação do recebimento

##### Passo 5 - Confira que avançou

Aparece a tela **Proteção contra spam**. Continue pelo guia "Etapa 3 - Como ativar a proteção contra spam".

</section><section>---

#### Dicas

- Só vale o código do **último** e-mail de teste. Se você enviou mais de um, use o mais recente.
- Se o e-mail demorar, olhe também a pasta de spam ou de lixo eletrônico.
- Mudou algum dado da conta de envio? Clique em **Salvar configuração** e envie um novo teste. A confirmação anterior deixa de valer.

</section><section>---

#### Problema/Solução

<table style="width:100%;"><thead><tr><th style="width:45%;">Problema</th><th style="width:55%;">Solução</th></tr></thead><tbody><tr><td>"Teste com falha"</td><td>O servidor de e-mail não aceitou o envio. Confira o servidor, a porta, a segurança, o usuário e a senha. Depois salve e envie de novo.</td></tr><tr><td>"Servidor aceitou o envio", mas o e-mail não chegou.</td><td>Olhe a pasta de spam. Confira se o endereço em **Enviar o teste para** está certo. Se precisar, envie um novo teste.</td></tr><tr><td>"Envio anulado"</td><td>O código foi digitado errado 5 vezes. Clique em **Enviar e-mail de teste** de novo e use o código do novo e-mail.</td></tr><tr><td>"Esse não é o último envio de teste; use o código do e-mail mais recente."</td><td>Abra o e-mail de teste mais recente e use o código dele.</td></tr><tr><td>"E-mail do remetente inválido." ou "E-mail de destino inválido."</td><td>Confira se o endereço está completo, com @ e domínio, e sem espaços.</td></tr><tr><td>"Informe o usuário (até 190 caracteres) e a senha do SMTP."</td><td>Preencha os campos **Usuário** e **Senha** da conta de e-mail.</td></tr></tbody></table>

#### FAQ (Perguntas frequentes)

<dl><dt><details><summary>Posso usar um Gmail ou Hotmail como remetente?</summary>

O assistente recomenda um remetente do próprio domínio do site. E-mails enviados em nome de outros provedores costumam cair no spam ou ser recusados.

</details></dt><dt><details><summary>O NetCorp troca a senha da minha conta de e-mail?</summary>

Não. A senha é sempre digitada por você. O NetCorp não a lê nem a troca no painel da hospedagem.

</details></dt></dl></section></article><article id="bkmrk-contatos-de-suporte-"><section>---

#### Contatos de suporte

- a preencher — Nome — Cargo — e-mail

</section><section>---

#### Controle de Mudanças

<details><summary>Informações de controle de versão</summary>

- **Última revisão** 23-10-2026
- **Próxima revisão** 23-04-2027
- **Autor** a preencher
- **Revisor** a preencher
- **Versão** 1.0.0

</details>---

</section><section>#### Notas adicionais

- As capturas foram feitas num ambiente de teste. Servidor e contas de e-mail aparecem borrados; os demais dados são exemplos fictícios.

---

#### Referências

- \[Guia\] - Etapa 2 - Como criar a estrutura, o administrador e os dados do site.
- \[Guia\] - Etapa 3 - Como ativar a proteção contra spam.

</section></article>

# Guia: Etapa 3 - Como ativar a proteção contra spam

<article id="bkmrk-escopo-e-p%C3%BAblico-apl"><section>#### Escopo e Público

- **Aplica-se a:** tela **Proteção contra spam** da Etapa 3 (E-mail e proteção) do assistente de instalação do NetCorp.
- **Não cobre:** como criar as chaves na Cloudflare (guia "Como criar as chaves de proteção contra spam na Cloudflare").
- **Público-alvo:** clientes que vão instalar o NetCorp na própria hospedagem.

---

#### Contexto

O NetCorp usa o **Cloudflare Turnstile**, um serviço gratuito, para confirmar que quem envia o formulário de contato é uma pessoa e não um robô. Na maioria das vezes, o visitante não precisa resolver nenhum desafio.

Para funcionar, o site precisa de duas chaves criadas na Cloudflare para o seu domínio: a **chave do site** e a **chave secreta**.

</section><section>---

#### Objetivo

Informar as chaves do Turnstile e confirmar com a Cloudflare que elas são do seu domínio.

</section><section>---

#### Pré-requisitos

- Ter concluído a configuração de e-mail (guia "Etapa 3 - Como configurar e testar o envio de e-mails").
- A chave do site e a chave secreta do Turnstile, criadas para o domínio que aparece no topo da tela.

</section><section>---

#### Passos

##### Passo 1 - Confira o domínio pedido

No texto do topo da tela **Proteção contra spam**, o assistente mostra em negrito o domínio do site. As chaves precisam ter sido criadas na Cloudflare para esse mesmo domínio.

##### Passo 2 - Cole as chaves

1. Em **Chave do site**, cole a chave do site, que a Cloudflare chama de *Site Key*.
2. Em **Chave secreta**, cole a chave secreta, que a Cloudflare chama de *Secret Key*.
3. Clique em **Salvar chaves**.

![Tela Proteção contra spam com os campos Chave do site e Chave secreta e o botão Salvar chaves destacados em vermelho](https://oraculo.gk2.cloud/uploads/images/gallery/2026-11/10-chaves-turnstile.png)

**Figura 1** - Chaves do Turnstile

##### Passo 3 - Confira com a Cloudflare

Aparece o bloco **Conferência com a Cloudflare**, com uma caixa de verificação da Cloudflare.

1. Resolva a verificação: marque a caixa **Confirme que é humano** e espere aparecer **Sucesso!**.
2. Clique em **Conferir com a Cloudflare**.

![Bloco Conferência com a Cloudflare com a verificação marcada como Sucesso e o botão Conferir com a Cloudflare destacado em vermelho](https://oraculo.gk2.cloud/uploads/images/gallery/2026-11/10-conferir-cloudflare.png)

**Figura 2** - Verificação resolvida, pronta para conferir

O assistente pergunta à Cloudflare se as chaves são deste domínio. Se forem, ele avança.

##### Passo 4 - Confira que avançou

A barra do topo passa para a etapa **4 - Estatísticas e tarefas** e aparece a tela **Estatísticas (Matomo)**.

</section><section>---

#### Dicas

- As **chaves de teste** que aparecem na documentação da Cloudflare não funcionam aqui. Use as chaves do widget que você criou para o seu domínio.
- A chave secreta não aparece de novo na tela depois de salva. Isso é proposital.

</section><section>---

#### Problema/Solução

<table style="width:100%;"><thead><tr><th style="width:45%;">Problema</th><th style="width:55%;">Solução</th></tr></thead><tbody><tr><td>"Resolva a verificação do Turnstile antes de conferir."</td><td>Espere a caixa de verificação aparecer e ficar marcada. Só depois clique em **Conferir com a Cloudflare**.</td></tr><tr><td>"As chaves são de outro domínio (…)"</td><td>O widget foi criado para outro domínio. Na Cloudflare, inclua o domínio do site no widget, ou crie um widget novo para ele. Depois cole as chaves de novo.</td></tr><tr><td>"A Cloudflare recusou a verificação; confira as chaves e resolva de novo."</td><td>Confira se colou a chave do site e a chave secreta nos campos certos, sem espaços a mais. Salve de novo e refaça a verificação.</td></tr><tr><td>"A Cloudflare não respondeu; tente conferir de novo."</td><td>Foi uma falha momentânea. Aguarde um pouco e clique em **Conferir com a Cloudflare** de novo.</td></tr><tr><td>"Confira a chave … do Turnstile (letras, números, - e \_)."</td><td>A chave colada tem caracteres a mais, como espaços ou aspas. Copie de novo na Cloudflare.</td></tr><tr><td>A caixa de verificação não aparece.</td><td>Recarregue a página. Se usar um bloqueador de anúncios ou de scripts, desative-o nesta página.</td></tr></tbody></table>

#### FAQ (Perguntas frequentes)

<dl><dt><details><summary>O Turnstile é pago?</summary>

O Turnstile tem uso gratuito na Cloudflare. Basta uma conta gratuita para criar o widget.

</details></dt><dt><details><summary>Os visitantes vão precisar resolver desafios no formulário?</summary>

Na maioria das vezes, não. O Turnstile confirma sozinho que é uma pessoa. Desafios aparecem só em casos suspeitos.

</details></dt></dl></section></article><article id="bkmrk-contatos-de-suporte-"><section>---

#### Contatos de suporte

- a preencher — Nome — Cargo — e-mail

</section><section>---

#### Controle de Mudanças

<details><summary>Informações de controle de versão</summary>

- **Última revisão** 23-10-2026
- **Próxima revisão** 23-04-2027
- **Autor** a preencher
- **Revisor** a preencher
- **Versão** 1.0.0

</details>---

</section><section>#### Notas adicionais

- As capturas foram feitas num ambiente de teste. As chaves e o domínio aparecem borrados.

---

#### Referências

- \[Guia\] - Como criar as chaves de proteção contra spam na Cloudflare.
- \[Documentação Cloudflare\] - Turnstile - Get started - https://developers.cloudflare.com/turnstile/get-started/. Acesso em 23-10-2026.

</section></article>

# Guia: Etapa 4 - Como instalar as estatísticas do site

<article id="bkmrk-escopo-e-p%C3%BAblico-apl"><section>#### Escopo e Público

- **Aplica-se a:** tela **Estatísticas (Matomo)** da Etapa 4 (Estatísticas e tarefas) do assistente de instalação do NetCorp.
- **Não cobre:** como ler as estatísticas depois de instalado, nem o uso direto do Matomo.
- **Público-alvo:** clientes que vão instalar o NetCorp na própria hospedagem.

---

#### Contexto

As estatísticas mostram, no painel do site, quantas pessoas visitaram o site, de onde vieram e quantas entraram em contato. Elas funcionam com o **Matomo**, uma ferramenta de estatísticas que o assistente instala junto com o site.

O Matomo usa um banco de dados próprio, com o final **\_matomo**, e tem uma conta de administrador separada da sua conta do NetCorp, chamada **superusuário**.

</section><section>---

#### Objetivo

Instalar o Matomo e ligá-lo ao painel do site, para avançar às tarefas agendadas.

</section><section>---

#### Pré-requisitos

- Ter concluído a Etapa 3 (guias da Etapa 3).
- Uma vaga livre para mais um banco de dados na hospedagem.
- Uma senha de pelo menos 12 caracteres para o superusuário das estatísticas.

</section><section>---

#### Passos

##### Passo 1 - Crie o banco das estatísticas

No topo da tela, a lista **Pacote do Matomo** confere os arquivos das estatísticas e deve mostrar **OK** em todos os itens. Em **Banco do Matomo**, repita o que fez na tela do banco do site:

1. Clique em **Validar acesso**.
2. Clique em **Criar o banco**.
3. Clique em **Preparar o usuário e conferir**.

![Tela Estatísticas (Matomo) com a lista Pacote do Matomo toda em OK e o bloco Banco do Matomo com o botão Validar acesso destacado em vermelho](https://oraculo.gk2.cloud/uploads/images/gallery/2026-11/11-banco-estatisticas.png)

**Figura 1** - Banco das estatísticas

Ao final, aparece o aviso **Banco do Matomo** com o nome do banco e o texto "pronto, só para as estatísticas".

##### Passo 2 - Preencha a conta do superusuário

Em **Conta administrativa do Matomo**, preencha:

- **Login do superusuário**: um nome de acesso, por exemplo **maria.estatisticas**.
- **E-mail do superusuário**: normalmente já vem com o seu e-mail.
- **Fuso horário das estatísticas**: normalmente **America/Sao\_Paulo**, que é o horário de Brasília.

Clique em **Salvar**.

![Bloco Conta administrativa do Matomo com login, e-mail e fuso horário preenchidos e o botão Salvar destacado em vermelho](https://oraculo.gk2.cloud/uploads/images/gallery/2026-11/11-superusuario.png)

**Figura 2** - Conta do superusuário das estatísticas

##### Passo 3 - Instale o Matomo

Aparece a lista **Instalador oficial**, com os passos ainda em **Falta**. Em **Senha do superusuário** e **Repita a senha**, digite a mesma senha, com pelo menos 12 caracteres. Clique em **Instalar o Matomo**. Pode levar alguns segundos.

![Lista Instalador oficial com os passos em Falta, os campos de senha preenchidos e o botão Instalar o Matomo destacado em vermelho](https://oraculo.gk2.cloud/uploads/images/gallery/2026-11/11-instalar-matomo.png)

**Figura 3** - Instalação do Matomo

##### Passo 4 - Ligue as estatísticas ao painel

Quando todos os passos do **Instalador oficial** mostram **Feito**, aparece o bloco **Integração com o painel**. Digite de novo a **Senha do superusuário** e clique em **Criar o token e continuar**.

![Lista Instalador oficial toda em Feito e o bloco Integração com o painel com o botão Criar o token e continuar destacado em vermelho](https://oraculo.gk2.cloud/uploads/images/gallery/2026-11/11-criar-token.png)

**Figura 4** - Ligação das estatísticas com o painel

##### Passo 5 - Confira que avançou

Aparece a tela **Tarefas agendadas**. Continue pelo guia "Etapa 4 - Como cadastrar as tarefas agendadas".

</section><section>---

#### Dicas

- Guarde o login e a senha do superusuário. Eles servem para abrir o Matomo diretamente, se um dia precisar.
- O bloco **Integração com o painel** também mostra um aviso **Depois da instalação**, com um ajuste técnico das metas de contato. Esse ajuste é feito pelo suporte da NetCorp. Avise o suporte quando concluir a instalação.

</section><section>---

#### Problema/Solução

<table style="width:100%;"><thead><tr><th style="width:45%;">Problema</th><th style="width:55%;">Solução</th></tr></thead><tbody><tr><td>Algum item do **Pacote do Matomo** não está OK.</td><td>Os arquivos das estatísticas não estão completos na hospedagem. Fale com o suporte.</td></tr><tr><td>"Sem vaga para o banco"</td><td>Libere uma vaga de banco no painel da hospedagem ou peça mais à hospedagem. Depois clique em **Validar acesso** de novo.</td></tr><tr><td>"A senha do superusuário do Matomo precisa ter 12+ caracteres e ser repetida igual."</td><td>Use uma senha com pelo menos 12 caracteres e digite a mesma nos dois campos.</td></tr><tr><td>"A senha do Matomo não pode começar nem terminar com espaços…"</td><td>Tire os espaços do começo e do fim da senha. Espaços no meio são permitidos.</td></tr><tr><td>"Prazo do instalador"</td><td>O instalador aceita continuar até o horário mostrado. Se esse horário passar, é preciso **Recomeçar com outro banco**.</td></tr><tr><td>"O banco do Matomo já tem tabelas…"</td><td>O banco das estatísticas precisa estar vazio. Use **Recomeçar com outro banco** ou fale com o suporte.</td></tr><tr><td>"Tokens que podem ter ficado perdidos"</td><td>Aparece se a instalação foi interrompida no meio. Fale com o suporte para revogar esses acessos no Matomo.</td></tr></tbody></table>

#### FAQ (Perguntas frequentes)

<dl><dt><details><summary>Preciso entrar no Matomo para ver as estatísticas?</summary>

Não. Depois da instalação, as estatísticas aparecem na página inicial do painel do site.

</details></dt><dt><details><summary>Posso trocar o superusuário depois?</summary>

Durante a instalação, não: para mudar, é preciso recomeçar com outro banco. Depois de instalado, fale com o suporte.

</details></dt></dl></section></article><article id="bkmrk-contatos-de-suporte-"><section>---

#### Contatos de suporte

- a preencher — Nome — Cargo — e-mail

</section><section>---

#### Controle de Mudanças

<details><summary>Informações de controle de versão</summary>

- **Última revisão** 23-10-2026
- **Próxima revisão** 23-04-2027
- **Autor** a preencher
- **Revisor** a preencher
- **Versão** 1.0.0

</details>---

</section><section>#### Notas adicionais

- As capturas foram feitas num ambiente de teste com cPanel. Os endereços aparecem borrados, e o aviso técnico "Depois da instalação" foi recortado da Figura 4.

---

#### Referências

- \[Guia\] - Etapa 2 - Como criar o banco de dados.
- \[Guia\] - Etapa 4 - Como cadastrar as tarefas agendadas.
- \[Guia\] - Como recomeçar com outro banco de dados.

</section></article>

# Guia: Etapa 4 - Como cadastrar as tarefas agendadas

<article id="bkmrk-escopo-e-p%C3%BAblico-apl"><section>#### Escopo e Público

- **Aplica-se a:** tela **Tarefas agendadas** da Etapa 4 (Estatísticas e tarefas) do assistente de instalação do NetCorp, com cadastro automático pelo cPanel ou cadastro manual no painel da hospedagem.
- **Não cobre:** outras tarefas agendadas que a sua conta já tenha. Elas são preservadas.
- **Público-alvo:** clientes que vão instalar o NetCorp na própria hospedagem.

---

#### Contexto

Algumas rotinas do site rodam sozinhas, sem ninguém clicar. A hospedagem é que as executa, num horário marcado. São quatro:

- **Fila de tarefas**: roda a cada minuto e cuida dos trabalhos internos do site.
- **Resumo diário**: roda todo dia às 07:00 e envia o resumo das estatísticas a quem pediu.
- **Arquivamento do Matomo**: roda de hora em hora e prepara os relatórios de visitas.
- **Atualizações automáticas**: roda de hora em hora, num minuto sorteado para cada site, e instala versões novas do NetCorp. Só passa a agir depois do código de ativação, informado na verificação final; antes disso não faz nada.

No painel da hospedagem, essas rotinas costumam se chamar **Tarefas Cron** ou **Agendador de tarefas**.

</section><section>---

#### Objetivo

Cadastrar as quatro tarefas na hospedagem e confirmar que elas estão rodando.

</section><section>---

#### Pré-requisitos

- Ter concluído as estatísticas (guia "Etapa 4 - Como instalar as estatísticas do site").
- Para o cadastro automático: hospedagem com cPanel e o acesso ao painel conectado na Etapa 1.

</section><section>---

#### Passos

##### Passo 1 - Gere as linhas das tarefas

Em **Agendador da hospedagem**, os dois campos já vêm com uma **Sugestão do NetCorp**:

- **Fuso do agendador**: o fuso do relógio que a hospedagem usa para as tarefas. Se não souber, mantenha a sugestão ou pergunte à hospedagem.
- **PHP de linha de comando**: um endereço técnico que a hospedagem usa para rodar as tarefas. Mantenha a sugestão, a menos que a hospedagem indique outro.

Clique em **Gerar as linhas**.

![Tela Tarefas agendadas com os campos Fuso do agendador e PHP de linha de comando preenchidos pela sugestão e o botão Gerar as linhas destacado em vermelho](https://oraculo.gk2.cloud/uploads/images/gallery/2026-11/12-gerar-linhas.png)

**Figura 1** - Geração das linhas das tarefas

##### Passo 2 - Cadastre as tarefas

<span style="text-decoration:underline;">**Com cPanel conectado (automático)**</span>

No bloco **Cadastro automático no cPanel**, clique em **Cadastrar automaticamente**. O NetCorp cadastra só as tarefas que faltam e preserva as outras tarefas da sua conta.

![Bloco Cadastro automático no cPanel com o botão Cadastrar automaticamente destacado em vermelho e a lista Situação com as três tarefas em Falta](https://oraculo.gk2.cloud/uploads/images/gallery/2026-11/12-cadastrar-automaticamente.png)

**Figura 2** - Cadastro automático das tarefas

<span style="text-decoration:underline;">**Sem cPanel conectado (manual)**</span>

1. Abra **Linhas para o painel da hospedagem (cadastro manual)**. Aparecem quatro linhas: Fila de tarefas, Resumo diário, Arquivamento do Matomo e Atualizações automáticas.
2. No painel da hospedagem, abra **Tarefas Cron** ou **Agendador de tarefas**.
3. Cadastre uma tarefa para cada linha, copiando a linha exatamente como aparece no assistente. Se o painel separar a frequência do comando, os cinco primeiros campos de cada linha são a frequência e o resto é o comando.

![Bloco Linhas para o painel da hospedagem aberto, com as três linhas Fila de tarefas, Resumo diário e Arquivamento do Matomo, com o conteúdo das linhas borrado](https://oraculo.gk2.cloud/uploads/images/gallery/2026-11/12-linhas-manuais.png)

**Figura 3** - Linhas para o cadastro manual

<p class="callout warning">Copie cada linha inteira, sem mudar nada. Uma letra a mais ou a menos impede a tarefa de rodar.</p>

##### Passo 3 - Espere a primeira execução da fila

Na lista **Situação**, a **Fila de tarefas** fica em **Atenção** com o texto "aguardando a primeira execução", e uma barra mostra a espera. A página confere sozinha a cada minuto. Não é preciso clicar em nada.

No cadastro manual, você também pode clicar em **Conferir agora**.

![Lista Situação com a barra de espera, a Fila de tarefas em Atenção aguardando a primeira execução e as outras duas tarefas em OK](https://oraculo.gk2.cloud/uploads/images/gallery/2026-11/12-aguardando-fila.png)

**Figura 4** - Espera pela primeira execução da fila

##### Passo 4 - Confirme as outras duas tarefas (só no cadastro manual)

O resumo roda uma vez por dia; o arquivamento e as atualizações, de hora em hora. Então o assistente não espera por eles. Quando a fila rodar, aparece o bloco **Resumo, arquivamento e atualizações**. Marque a caixa que confirma que as três linhas foram salvas e estão ativas no painel, e clique em **Confirmar as linhas**.

##### Passo 5 - Continue

Quando as quatro tarefas mostram **OK**, clique em **Continuar**. A barra do topo passa para a etapa **5 - Verificação final**.

![Lista Situação com Fila de tarefas, Resumo diário e Arquivamento do Matomo em OK e o botão Continuar destacado em vermelho](https://oraculo.gk2.cloud/uploads/images/gallery/2026-11/12-tarefas-prontas.png)

**Figura 5** - Tarefas cadastradas e funcionando

</section><section>---

#### Dicas

- A primeira execução da fila costuma levar até 1 minuto depois do cadastro.
- **Gerar de novo** troca as linhas e recomeça as conferências desta etapa. Use só se mudar o fuso ou o PHP. No cadastro manual, cadastre as novas linhas no painel.
- Abaixo das linhas, o assistente mostra a que horas o resumo diário sai, no fuso do agendador e no fuso das estatísticas.

</section><section>---

#### Problema/Solução

<table style="width:100%;"><thead><tr><th style="width:45%;">Problema</th><th style="width:55%;">Solução</th></tr></thead><tbody><tr><td>A fila fica muito tempo em "aguardando a primeira execução".</td><td>Confira no painel da hospedagem se a tarefa da fila foi salva e está ativa. No cadastro manual, confira se a linha foi copiada inteira. Se continuar parada depois de alguns minutos, fale com a hospedagem ou com o suporte.</td></tr><tr><td>Uma tarefa aparece como **Falta** depois do cadastro automático.</td><td>Clique em **Conferir cadastro no cPanel**. Se continuar em Falta, fale com o suporte.</td></tr><tr><td>Uma tarefa aparece como **Impede**.</td><td>Leia o texto abaixo do item e fale com o suporte.</td></tr><tr><td>Não sei qual é o fuso do agendador.</td><td>Mantenha a sugestão. A maioria das hospedagens usa o horário do servidor. Na dúvida, pergunte à hospedagem.</td></tr></tbody></table>

#### FAQ (Perguntas frequentes)

<dl><dt><details><summary>O cadastro automático apaga as outras tarefas da minha conta?</summary>

Não. Ele cadastra só as tarefas do NetCorp que faltam e preserva as demais.

</details></dt><dt><details><summary>Posso fechar a página enquanto espero a fila?</summary>

Pode. A conferência fica guardada. Ao voltar, a página confere de novo.

</details></dt></dl></section></article><article id="bkmrk-contatos-de-suporte-"><section>---

#### Contatos de suporte

- a preencher — Nome — Cargo — e-mail

</section><section>---

#### Controle de Mudanças

<details><summary>Informações de controle de versão</summary>

- **Última revisão** 23-10-2026
- **Próxima revisão** 23-04-2027
- **Autor** a preencher
- **Revisor** a preencher
- **Versão** 1.0.0

</details>---

</section><section>#### Notas adicionais

- As capturas foram feitas num ambiente de teste com cPanel e cadastro automático. O conteúdo das linhas da Figura 3 aparece borrado porque varia de site para site.
- O Passo 4, só do cadastro manual, não foi capturado.

---

#### Referências

- \[Guia\] - Etapa 4 - Como instalar as estatísticas do site.
- \[Guia\] - Etapa 5 - Verificação final e conclusão.

</section></article>

# Guia: Etapa 5 - Como fazer a verificação final e concluir a instalação

<article id="bkmrk-escopo-e-p%C3%BAblico-apl"><section>#### Escopo e Público

- **Aplica-se a:** tela **Verificação final** da Etapa 5 do assistente de instalação do NetCorp e o botão **Concluir instalação**.
- **Não cobre:** o que fazer depois de concluir (guia "Depois de instalar - Como revogar os acessos temporários e entrar no painel").
- **Público-alvo:** clientes que vão instalar o NetCorp na própria hospedagem.

---

#### Contexto

Antes de liberar o site, o assistente confere de novo tudo o que foi feito nas etapas anteriores, sem alterar nada. Só com tudo certo ele mostra o botão para concluir.

Ao concluir, o assistente se fecha, apaga o código de acesso e retira do servidor as chaves temporárias usadas na instalação. **Não dá para voltar.**

</section><section>---

#### Objetivo

Conferir a instalação e concluí-la.

</section><section>---

#### Pré-requisitos

- Ter concluído a Etapa 4 (guias da Etapa 4).

</section><section>---

#### Passos

##### Passo 1 - Leia as conferências

A tela **Verificação final** mostra a lista **Conferências**. Cada item traz o nome da etapa, como "Hospedagem", "Banco de dados", "E-mail" ou "Tarefas agendadas", e um selo:

- **OK**: está tudo certo.
- **Atenção**: é uma recomendação e não impede a conclusão. São os mesmos itens de atenção da Etapa 1.
- **Impede**: precisa ser resolvido antes de concluir.

![Tela Verificação final com a lista Conferências, cada item com o nome da etapa e o selo OK](https://oraculo.gk2.cloud/uploads/images/gallery/2026-11/13-verificacao-final.png)

**Figura 1** - Conferências da verificação final

##### Passo 2 - Conclua a instalação

Se nenhum item mostrar **Impede**, aparece no fim da tela o bloco **Concluir a instalação**. Leia o aviso.

Se a equipe passou um **código de ativação das atualizações**, cole no campo com esse nome. Com ele, o site passa a se atualizar sozinho. O campo é opcional: vazio, ou se o código for recusado, a instalação termina do mesmo jeito.

Clique em **Concluir instalação**.

![Bloco Concluir a instalação com o aviso de que não dá para voltar e o botão Concluir instalação destacado em vermelho](https://oraculo.gk2.cloud/uploads/images/gallery/2026-11/13-concluir.png)

**Figura 2** - Conclusão da instalação

<p class="callout warning">Depois de concluir, o assistente fica fechado. Mudanças no site passam a ser feitas pelo painel do site.</p>

##### Passo 3 - Confira que concluiu

Aparece a tela **Instalação concluída**. Se você informou o código, ela mostra o bloco **Atualizações automáticas**: **Ativas**, ou **Não foram ativadas** com o motivo. Nesse segundo caso, a instalação está pronta e a ativação pode ser feita depois pela equipe. Continue pelo guia "Depois de instalar - Como revogar os acessos temporários e entrar no painel". Não feche essa tela antes de anotar o que ela pede para revogar.

</section><section>---

#### Dicas

- Corrigiu algo na hospedagem? Clique em **Conferir de novo** para refazer a verificação.
- A fila de tarefas precisa ter rodado nos últimos 10 minutos. Se você demorou para chegar aqui, espere um minuto e clique em **Conferir de novo**.

</section><section>---

#### Problema/Solução

<table style="width:100%;"><thead><tr><th style="width:45%;">Problema</th><th style="width:55%;">Solução</th></tr></thead><tbody><tr><td>Um item mostra **Impede** e o botão Concluir não aparece.</td><td>Leia o nome da etapa e o texto do item. Se for algo da hospedagem, peça a correção à hospedagem e clique em **Conferir de novo**. Se não souber resolver, fale com o suporte.</td></tr><tr><td>"Tarefas agendadas · Fila rodando" mostra **Impede**.</td><td>A fila de tarefas não rodou nos últimos minutos. Confira no painel da hospedagem se a tarefa está ativa, espere um minuto e clique em **Conferir de novo**.</td></tr><tr><td>"Não deu para concluir"</td><td>Leia a mensagem, clique em **Conferir de novo** e tente concluir outra vez. Se repetir, fale com o suporte.</td></tr><tr><td>"A conclusão foi interrompida"</td><td>A conclusão já tinha começado e parou no meio, por exemplo por falta de conexão. Confira e clique em **Concluir instalação** de novo. O assistente continua de onde parou.</td></tr></tbody></table>

#### FAQ (Perguntas frequentes)

<dl><dt><details><summary>Os itens de Atenção impedem a conclusão?</summary>

Não. Eles são recomendações para ajustar na hospedagem quando puder.

</details></dt><dt><details><summary>Posso abrir o assistente de novo depois de concluir?</summary>

Não. O endereço /instalar passa a mostrar "O NetCorp já está instalado", com o botão para entrar no painel.

</details></dt></dl></section></article><article id="bkmrk-contatos-de-suporte-"><section>---

#### Contatos de suporte

- a preencher — Nome — Cargo — e-mail

</section><section>---

#### Controle de Mudanças

<details><summary>Informações de controle de versão</summary>

- **Última revisão** 23-10-2026
- **Próxima revisão** 23-04-2027
- **Autor** a preencher
- **Revisor** a preencher
- **Versão** 1.0.0

</details>---

</section><section>#### Notas adicionais

- A Figura 1 mostra só o início da lista de conferências. A lista completa tem um item para cada etapa da instalação.

---

#### Referências

- \[Guia\] - Etapa 4 - Como cadastrar as tarefas agendadas.
- \[Guia\] - Depois de instalar - Como revogar os acessos temporários e entrar no painel.

</section></article>

# Guia: Depois de instalar - Como revogar os acessos temporários e entrar no painel

<article id="bkmrk-escopo-e-p%C3%BAblico-apl"><section>#### Escopo e Público

- **Aplica-se a:** tela **Instalação concluída** do assistente de instalação do NetCorp e o primeiro acesso ao painel do site.
- **Não cobre:** o uso do painel do site (páginas, conteúdos, mídia e configurações).
- **Público-alvo:** clientes que acabaram de instalar o NetCorp na própria hospedagem.

---

#### Contexto

Durante a instalação, você pode ter criado uma **chave de acesso** no painel da hospedagem (token de API do cPanel ou Login Key do DirectAdmin). O NetCorp já apagou essa chave do servidor, mas ela continua valendo no painel da hospedagem até você revogá-la. Revogar é desativar a chave, para que ninguém mais consiga usá-la.

</section><section>---

#### Objetivo

Revogar a chave temporária usada na instalação e entrar pela primeira vez no painel do site.

</section><section>---

#### Pré-requisitos

- Ter concluído a instalação (guia "Etapa 5 - Como fazer a verificação final e concluir a instalação").
- O e-mail e a senha do administrador criados na Etapa 2.
- O celular com o app autenticador ativado na Etapa 2, ou um dos códigos de recuperação.

</section><section>---

#### Passos

##### Passo 1 - Veja o que precisa ser revogado

A tela **Instalação concluída** mostra o bloco **Revogue os acessos usados na instalação**, com o endereço do painel, o usuário e o caminho do menu onde fica a chave.

![Tela Instalação concluída com o aviso cPanel: token de API, que indica onde revogar a chave, e o botão Entrar no painel, ambos destacados em vermelho](https://oraculo.gk2.cloud/uploads/images/gallery/2026-11/biI14-instalacao-concluida.png)

**Figura 1** - Tela de instalação concluída

Se você não conectou o painel da hospedagem na Etapa 1, esse bloco não aparece e não há nada para revogar.

##### Passo 2 - Revogue a chave no painel da hospedagem

- **cPanel:** entre no cPanel com o usuário indicado, abra **Segurança › Gerenciar tokens de API** e revogue o token criado para a instalação.
- **DirectAdmin:** entre no DirectAdmin com o usuário indicado, abra **Login Keys** e apague a chave criada para a instalação.

<p class="callout info">Revogar a chave não afeta o site. Ela só era necessária durante a instalação.</p>

##### Passo 3 - Entre no painel do site

1. Volte à tela **Instalação concluída** e clique em **Entrar no painel**.
2. Na tela **Entrar no painel**, digite o **E-mail** e a **Senha** do administrador que você criou na Etapa 2.
3. Espere a verificação da Cloudflare abaixo da senha terminar e clique em **Entrar**.
4. Na tela **Código de verificação**, abra o app autenticador do celular, digite o código de 6 dígitos do NetCorp e clique em **Confirmar**. É o mesmo app que você ativou na Etapa 2. Sem o celular, digite um dos códigos de recuperação.

![Tela Entrar no painel com os campos E-mail e Senha, a verificação da Cloudflare e o botão Entrar](https://oraculo.gk2.cloud/uploads/images/gallery/2026-11/f2f14-entrar-no-painel.png)

**Figura 2** - Tela de entrada no painel do site

![Tela Código de verificação com o campo Código preenchido com 123456 e o botão Confirmar, destacados em vermelho](https://oraculo.gk2.cloud/uploads/images/gallery/2026-11/14-codigo-de-verificacao.png)

**Figura 3** - Código de verificação depois da senha

Para entrar outras vezes, use o endereço do site seguido de **/admin**, por exemplo **https://suaempresa.com.br/admin**.

##### Passo 4 - Avise o suporte

Avise o suporte da NetCorp que a instalação foi concluída. O suporte faz o ajuste final das estatísticas, que passam a contar também os contatos recebidos pelo site.

</section><section>---

#### Dicas

- Guarde num lugar seguro o e-mail e a senha do administrador e o login e a senha do superusuário das estatísticas.
- Se abrir o endereço /instalar de novo, aparece a tela **O NetCorp já está instalado**. É o esperado: o assistente fica fechado depois da conclusão.

</section><section>---

#### Problema/Solução

<table style="width:100%;"><thead><tr><th style="width:45%;">Problema</th><th style="width:55%;">Solução</th></tr></thead><tbody><tr><td>Fechei a tela "Instalação concluída" sem anotar o que revogar.</td><td>No painel da hospedagem, abra a área de tokens de API (cPanel) ou de Login Keys (DirectAdmin) e revogue a chave que você criou para a instalação.</td></tr><tr><td>"E-mail ou senha invalidos." ao entrar no painel.</td><td>Confira o e-mail e a senha do administrador criados na Etapa 2. Não use a senha da hospedagem nem a do superusuário das estatísticas.</td></tr><tr><td>"Muitas tentativas. Aguarde 15 minutos e tente de novo."</td><td>O acesso foi pausado depois de várias senhas ou códigos errados. Espere 15 minutos.</td></tr><tr><td>"Codigo invalido. Confira o app autenticador e tente de novo."</td><td>Use o código da conta NetCorp deste site no app e confira se o horário do celular está no automático. Cada código vale uma vez: espere o próximo aparecer.</td></tr><tr><td>"O tempo para digitar o codigo acabou. Entre de novo."</td><td>Passaram mais de 5 minutos depois da senha. Entre de novo com o e-mail e a senha.</td></tr></tbody></table>

#### FAQ (Perguntas frequentes)

<dl><dt><details><summary>Se eu não revogar a chave, o que acontece?</summary>

O site continua funcionando, mas a chave segue valendo no painel da hospedagem. Revogue por segurança: assim ninguém consegue usá-la.

</details></dt><dt><details><summary>Esqueci a senha do administrador. Tem "esqueci minha senha"?</summary>

Não. A tela de entrada mostra "Sem acesso? Fale com o administrador do site". Se você é o único administrador, fale com o suporte.

</details></dt></dl></section></article><article id="bkmrk-contatos-de-suporte-"><section>---

#### Contatos de suporte

- a preencher — Nome — Cargo — e-mail

</section><section>---

#### Controle de Mudanças

<details><summary>Informações de controle de versão</summary>

- **Última revisão** 05-11-2026
- **Próxima revisão** 05-05-2027
- **Autor** a preencher
- **Revisor** a preencher
- **Versão** 1.1.0

</details>---

</section><section>#### Notas adicionais

- As capturas foram feitas num ambiente de teste com cPanel. O endereço do painel aparece borrado.
- As instruções do DirectAdmin vêm do texto da própria tela de conclusão e não foram capturadas.
- Versão 1.1.0: entrou a tela Código de verificação no Passo 3 (Figura 3), capturada num ambiente de demonstração; 123456 é um código de exemplo.

---

#### Referências

- \[Guia\] - Etapa 5 - Como fazer a verificação final e concluir a instalação.
- \[Guia\] - Como criar a chave de acesso do cPanel.
- \[Guia\] - Como criar a Login Key do DirectAdmin.

</section></article>