# Onboarding Quando você abre o Capyshop pela primeira vez, um **assistente de configuração de 9 etapas** guia você pela configuração inicial da sua loja. Esse assistente é executado automaticamente e deve ser concluído antes de acessar o painel administrativo. Ao finalizar, você é direcionado para o painel de administração, onde uma lista de **Primeiros Passos** ajuda a iniciar o lançamento da sua loja. ## Antes de começar Certifique-se de que o Capyshop está em execução e acessível no seu navegador. Assim que você abrir o aplicativo, será redirecionado automaticamente para o assistente de onboarding — não é necessário nenhuma ação manual. ## Etapa 1 — Boas-vindas A primeira tela exibe uma saudação e mostra a barra de progresso com as 9 etapas no topo. Clique em **Get Started** para começar. ![Tela de boas-vindas](/features/onboarding/welcome.png) ## Etapa 2 — Criar sua conta de administrador Aqui você cria a primeira conta de administrador para a sua loja. Preencha seu nome, e-mail e uma senha segura (mínimo 8 caracteres), depois clique em **Create & Continue**. ![Formulário de criação de conta](/features/onboarding/create-admin-user.png) | Campo | Observações | | ------ | --------------------------------------------- | | Nome | Seu nome de exibição no painel administrativo | | E-mail | Usado para login; deve ser um e-mail válido | | Senha | Mínimo de 8 caracteres | > **Importante:** Guarde suas credenciais em segurança. Esta conta tem acesso total de administrador à loja. ## Etapa 3 — Selecionar países O Capyshop precisa saber para quais países sua loja vai vender. O aplicativo importa automaticamente uma lista completa de países, estados e cidades em segundo plano — isso pode levar alguns segundos. Quando a lista carregar, ative cada país para o qual deseja vender. É necessário pelo menos um país ativo. ![Seleção de países](/features/onboarding/select-countries.png) Você pode adicionar ou remover países depois em **Configurações → Países** no painel de administração. ## Etapa 4 — Configurações gerais Aqui você configura a identidade principal da sua loja: nome, moeda, endereço, logotipo e links de redes sociais. ![Configurações gerais](/features/onboarding/general-settings-top.png) | Campo | Observações | | -------------- | --------------------------------------------------------------- | | Nome da loja | Exibido na aba do navegador, e-mails e tags de SEO | | Moeda | Moeda padrão para preços e checkout | | País | **Obrigatório.** Selecione o país onde sua empresa está sediada | | Endereço | Endereço físico da sua empresa | | Logo / Favicon | Faça o upload das imagens da sua marca (PNG ou SVG recomendado) | | Links sociais | Adicione URLs para X, Facebook, Instagram, TikTok ou WhatsApp | ## Etapa 5 — Tema Personalize a aparência visual da sua loja. Você pode configurar paletas de cores separadas para o **modo claro** e o **modo escuro**, além de escolher uma fonte global. ![Configurações de tema](/features/onboarding/theme-top.png) Pelo menos um modo (claro ou escuro) deve estar ativado. Você pode alterar todas as cores depois em **Configurações → Tema**. ## Etapa 6 — E-mail Configure o envio de e-mails para que sua loja possa enviar confirmações de pedidos, atualizações de envio e outras notificações aos clientes. ![Configurações de e-mail — configuração SMTP](/features/onboarding/email-top.png) Você precisará das credenciais SMTP do seu provedor de e-mail (Gmail, SendGrid, Mailgun, etc.). | Campo | Observações | | ------------------- | --------------------------------------------------------- | | E-mail de contato | Seu e-mail público de suporte exibido aos clientes | | E-mail sem resposta | Usado como remetente nos e-mails automáticos | | Host SMTP | Hostname do servidor de e-mail (ex.: `smtp.sendgrid.net`) | | Porta SMTP | Normalmente `587` para TLS ou `465` para SSL | | Usuário SMTP | Seu nome de usuário de login SMTP | | Senha SMTP | Sua senha de login SMTP | > **Dica:** Clique em **Save & Continue** primeiro para salvar as configurações e, em seguida, use o botão **Enviar e-mail de teste** para verificar se a configuração SMTP está funcionando. > **Importante:** Se você já configurou o SMTP através das variáveis de ambiente `SMTP_HOST`, `SMTP_PORT`, `SMTP_USER` e `SMTP_PASSWORD` no momento do deploy, os campos correspondentes ficam desabilitados aqui e exibem _"Configured by environment variable"_ — você pode deixá-los como estão e prosseguir apenas com os dois campos de endereço de e-mail. ## Etapa 7 — Integrações Conecte serviços terceiros opcionais para desbloquear recursos adicionais. Todas as integrações são opcionais — você pode pular esta etapa e configurar depois em **Configurações → Integrações**. ![Integrações](/features/onboarding/integrations.png) | Integração | O que habilita | | ---------------------------- | -------------------------------------------------------------- | | **Telemetria da plataforma** | Partilhe dados de utilização anónimos para melhorar o Capyshop | | **IA (OpenAI / Anthropic)** | Descrições de produtos e busca com IA | | **Stripe** | Pagamentos com cartão de crédito e carteiras digitais | | **Google Auth** | "Entrar com o Google" para clientes | | **Facebook Auth** | "Entrar com o Facebook" para clientes | > **Nota:** Ao ativar a telemetria da plataforma, são enviadas estatísticas de utilização anónimas do painel de administração para a equipa do Capyshop. Nunca são recolhidos dados pessoais, nomes de lojas ou informações de clientes. Pode desativar a qualquer momento em **Definições → Integrações**. ## Etapa 8 — Idiomas Escolha em quais idiomas sua loja estará disponível. **Inglês, espanhol, holandês e português vêm pré-selecionados por padrão** — desative os que não precisar e ative qualquer outro idioma que deseje oferecer. Pelo menos um idioma deve estar ativo e não precisa ser o inglês. ![Idiomas](/features/onboarding/languages.png) ## Etapa 9 — Configuração concluída Parabéns! Todas as etapas foram concluídas. Clique em **Go to Admin Panel** para abrir o painel de administração. ![Configuração concluída](/features/onboarding/complete.png) ## Lista de primeiros passos Após o onboarding, o painel de administração exibe uma lista de **Primeiros Passos** com três ações recomendadas: ![Painel de administração com lista de primeiros passos](/features/onboarding/getting-started.png) | Tarefa | O que fazer | | ---------------------------------- | ------------------------------------------------------------------- | | **Criar seu primeiro produto** | Vá em **Produtos → Novo** e adicione pelo menos um item ao catálogo | | **Configurar método de envio** | Vá em **Envio → Novo** para configurar taxas e zonas de entrega | | **Configurar método de pagamento** | Vá em **Métodos de Pagamento → Novo** para habilitar pagamentos | Quando as três tarefas estiverem concluídas, sua loja estará pronta para receber pedidos.