Primeiro Acesso ao Sistema
Este guia orienta você em seu primeiro acesso à plataforma Z-PRO após a conclusão da instalação. O objetivo é apresentar a estrutura dos dois painéis principais.
1. Realizando o Primeiro Login
Após a conclusão da instalação pela equipe Z-PRO, você receberá no Tomticket todos os dados de acesso e as credenciais da sua nova instância. Abaixo, detalhamos cada uma dessas informações.
Dados Recebidos Após a Instalação
URL Front-end e Back-end: Os endereços de acesso à sua plataforma e à sua API. A URL do Front-end é a que você usará para acessar o sistema.
Login e Senha (Superadmin): Suas credenciais de administrador mestre da plataforma.
Login e Senha (Usuário Padrão): Credenciais de um usuário de atendimento, criado para testes iniciais.
Acesso ao Portainer: URL, usuário e senha para acessar a interface de gerenciamento dos contêineres Docker da sua aplicação.
Senha (Usuário deployzdg): Senha do usuário do sistema operacional do servidor
Credenciais do Banco de Dados: Nome do banco de dados, usuário e senha de acesso.
Senha do Redis: Senha de acesso ao serviço Redis, utilizado para gerenciamento de cache e filas.
Status do Firewall: Confirmação de que o firewall do servidor foi ativado com as portas necessárias liberadas.
Passos para o Primeiro Acesso
Acesse a URL do Front-end informada no ticket.
Utilize as credenciais do Superadmin para fazer o login.
Imediatamente após o login, o primeiro passo funcional dentro do sistema é validar sua assinatura. Acesse o painel "Assinatura" para inserir sua chave de licença.
2. Entendendo a Estrutura: Superadmin vs. Admin
A plataforma Z-PRO possui dois níveis de administração distintos. Entender a diferença é fundamental para gerenciar o sistema corretamente.
Pense da seguinte forma:
O Superadmin é o "Dono do Shopping Center". Ele gerencia a estrutura, os lojistas (seus clientes) e a aparência do shopping.
O Admin é o "Gerente da Loja". Ele gerencia as operações de uma loja específica: os vendedores (atendentes), o estoque (canais de comunicação) e o atendimento ao cliente (chatbots).
Este é o painel de mais alto nível, o centro de controle do seu negócio. Você o usará para gerenciar a estrutura da sua plataforma, seus clientes e as configurações globais que afetam todo o sistema.
As funcionalidades do Superadmin estão organizadas para cobrir três áreas principais:
Gestão da Plataforma e Clientes: Esta é a área onde você gerencia os aspectos comerciais e estruturais, incluindo a gestão de Tenants (seus clientes), a criação de Planos de assinatura, o acompanhamento de Pagamentos e a validação da sua Assinatura (licença).
Configuração e Customização: Aqui você define a identidade visual e as configurações técnicas da sua plataforma. Inclui a área para Customizar logos e cores (White Label), configurar o serviço de E-mail para recuperação de senha, gerenciar Canais de comunicação em nível de sistema e acessar a API do Superadmin.
Manutenção e Monitoramento: Ferramentas para administradores de sistema manterem a saúde e a performance da aplicação. Permite Atualizar o sistema para a última versão, monitorar o uso de CPU e memória no Monitor, acessar o Terminal do servidor via SSH e verificar configurações avançadas como Filas e Tarefas e Dados Internos.
Para um guia detalhado sobre o uso de cada uma dessas funções, consulte nossa seção completa: Guia do Painel Superadmin.
Painel Admin
Este painel é usado para configurar e gerenciar as operações de uma conta de cliente (tenant) específica. Cada cliente seu terá seu próprio Painel Admin. As principais funções são:
Gestão de Canais: Conectar números de WhatsApp, contas de Instagram, etc.
Gestão de Usuários e Equipes: Criar os atendentes e organizar as equipes de atendimento.
Criação de Chatbots: Desenvolver os fluxos de automação.
Análise de Relatórios: Visualizar os dados de atendimento daquela conta.
3. Conectando um canal
Passo 1: Crie um Usuário Administrador
Ainda no painel Superadmin, acesse o menu "Usuários".
Clique em "Adicionar".
Preencha os dados:
Tenant: Deixe selecionada a opção padrão, que corresponde à sua própria empresa ou a algum tenant que já criou.
Nome: Insira um nome para identificar o administrador.
E-mail: Insira um e-mail que usará para acessar a plataforma.
Senha: Crie uma senha
Perfil: Selecione a opção "Administrador".
Para esse primeiro teste, deixe todos os menus visíveis e o horário de atendimento liberado.
Clique em "Salvar".
📚 Consulte a documentação completa sobre criação de usuários no painel do superadmin: Usuário
Passo 2: Faça Login com o Usuário Admin
Agora, vamos acessar o painel de gerenciamento do atendimento.
Faça logout da sua conta Superadmin (canto superior direito)
Na mesma tela de login, utilize o e-mail e a senha do usuário "Admin" que você acabou de criar.
Você notará que o painel é diferente. Este é o Painel Admin, onde toda a operação de atendimento acontece.
Passo 3: Adicione um Novo Canal
No menu lateral do Painel Admin, acesse "Canais".
Clique no botão "Adicionar Canal".
Preencha as informações:
Tipo: Selecione uma das opções de sua preferência. Nesse tutorial iremos utilizar a WhatsApp Baileus (QR Code)
Nome do Canal: Dê um nome para identificar a conexão (ex: "WhatsApp Principal").
Demais informações: configure o canal com as funcionalidades que gostaria
Clique em "Salvar".
Passo 4: Leia o QR Code para Conectar
Após salvar, a plataforma irá criar um novo canal na tela.
Clique no botão "Novo QR Code"
Pegue o celular com o número de WhatsApp que deseja conectar.
No aplicativo WhatsApp, vá em Configurações > Aparelhos Conectados > Conectar um Aparelho.
Aponte a câmera do celular para o QR Code exibido na tela do Z-PRO.
Aguarde a confirmação. O status do canal na tela do Z-PRO mudará para "Conexão estabelecida".
Passo 5: Teste a Conexão
Com o canal conectado, você já pode receber e enviar mensagens.
No menu lateral, clique em "Atendimentos". Esta é a sua caixa de entrada unificada.
Pegue um telefone diferente e envie uma mensagem de WhatsApp para o número que você acabou de conectar.
A mensagem deverá aparecer em poucos segundos na tela de "Atendimentos". Você pode clicar nela para responder e testar o envio de mensagens.
Atualizado