Plataforma & Operadores
Por Conversa Labs
Por Conversa Labs
Super Admin (contas, planos, licença), instalador/deploy, tenancy e tópicos de operador. Conteúdo em altitude operador.
Visão geral para operadores da plataforma
Visão geral Esta categoria é voltada a operadores da plataforma — quem administra a instalação como um todo, não apenas uma conta. Aqui ficam os temas de Super Admin (contas, planos, licença), instalação e deploy, tenancy e provisionamento de serviços auxiliares. Pré-requisitos - Acesso de Super Admin à instalação. - Acesso de infraestrutura (servidor/cluster) para tarefas de instalação e deploy. Passo a passo 1. Acesse o painel Super Admin para administrar contas, planos e licença. 2. Use os artigos de instalação/deploy para provisionar ou atualizar a plataforma. 3. Configure a tenancy e os serviços auxiliares (por exemplo, o gateway de WhatsApp Web). 4. Acompanhe a saúde da instalação e a validade da licença. Configurações & opções - Contas e planos: criação, limites e features por conta. - Licença: ativação e estado da licença da instalação. - Infraestrutura: imagens, variáveis de ambiente e serviços. Casos de uso - Operar uma instalação que atende múltiplas contas. - Provisionar novas instâncias e manter atualizações. Dicas, limites e boas práticas - Restrinja o acesso de Super Admin ao mínimo necessário. - Mantenha backups e um plano de rollback antes de cada deploy. Solução de problemas - Não vejo o Super Admin: confirme que seu usuário tem o papel de operador da instalação. - Funcionalidade indisponível: verifique plano/licença e variáveis de ambiente. Veja também - Super Admin: contas, planos e licença - Instalador e deploy
Super Admin: contas, planos e licença
Visão geral O painel de Super Admin é onde o operador administra a instalação inteira: criar e gerenciar contas, definir planos e features, e acompanhar o estado da licença. Pré-requisitos - Usuário com papel de Super Admin. - Licença válida para a instalação. Passo a passo 1. Acesse o painel de Super Admin. 2. Em Contas, crie ou edite contas e ajuste limites e features. 3. Em Planos, defina os planos disponíveis e o que cada um habilita. 4. Em Licença, confira o estado de ativação e a validade. Configurações & opções - Features por conta: habilite/desabilite módulos por conta. - Limites: agentes, inboxes e outros limites por plano. - Licença: chave, estado e renovação. Casos de uso - Provisionar uma nova conta para um cliente. - Ajustar o plano de uma conta conforme a contratação. Dicas, limites e boas práticas - Documente o plano e as features de cada conta. - Monitore a validade da licença para evitar interrupções. Solução de problemas - Conta sem um módulo: verifique as features habilitadas no plano/conta. - Licença inválida: confira a chave e o estado da ativação. Veja também - Visão geral para operadores - Instalador e deploy
Instalador e deploy
Visão geral O operador provisiona e mantém a plataforma por meio de um instalador automatizado e de um processo de deploy baseado em imagens versionadas. O objetivo é subir e atualizar a instalação de forma previsível, com rollback à mão. Pré-requisitos - Acesso de infraestrutura (servidor único ou cluster). - Credenciais do registro de imagens e DNS/TLS do domínio. Passo a passo 1. Provisione a infraestrutura (servidor único ou cluster) com o instalador. 2. Configure domínios, DNS e certificados TLS. 3. Faça o deploy da imagem versionada da plataforma. 4. Rode as migrações de banco e verifique a saúde dos serviços. 5. Em atualizações, faça deploy da nova versão com estratégia de atualização gradual. Configurações & opções - Variáveis de ambiente: segredos e parâmetros da instalação. - Imagens versionadas: fixe a versão a implantar (evite tags genéricas em produção). - Migrações: rode as migrações como etapa controlada do deploy. Casos de uso - Subir uma nova instalação do zero. - Atualizar para uma nova versão com rollback disponível. Dicas, limites e boas práticas - Tenha sempre o comando de rollback escrito antes de iniciar o deploy. - Atualize um serviço por vez e verifique a saúde antes de prosseguir. - Nunca exponha segredos em arquivos versionados. Solução de problemas - Serviço não sobe: verifique variáveis de ambiente e logs do serviço. - Migração falhou: confira a conectividade do banco e rode a migração isoladamente. Veja também - Super Admin: contas, planos e licença - Tenancy e ZuckZapGo
Tenancy e ZuckZapGo
Visão geral O operador define como as contas compartilham (ou não) os serviços auxiliares. Um exemplo central é o gateway de WhatsApp Web (ZuckZapGo), que hospeda as sessões pareadas usadas pelas inboxes de WhatsApp Web. Pré-requisitos - Serviço de gateway provisionado e acessível pela plataforma. - Token administrativo do gateway (mantido apenas no backend, nunca exposto). Passo a passo 1. Defina o modelo de tenancy: gateway único compartilhado pelo operador ou gateway por conta. 2. Configure a URL do gateway e o token administrativo na instalação. 3. Ao criar uma inbox de WhatsApp Web, a plataforma provisiona automaticamente um usuário no gateway. 4. Acompanhe o estado das sessões (conectado, pareando, desconectado). Configurações & opções - Modo de tenancy: compartilhado (operador) ou por conta. - Credenciais: token administrativo e URL do gateway (criptografados/seguros). - Webhooks: o gateway notifica a plataforma sobre eventos de sessão e mensagens. Casos de uso - Operar um gateway único para todas as contas (self-hosted). - Permitir que cada conta aponte para o próprio gateway externo. Dicas, limites e boas práticas - Nunca exponha o token administrativo do gateway em respostas de API ou logs. - Monitore a saúde do gateway e a validade das sessões pareadas. Solução de problemas - Inbox não pareia: verifique a conectividade com o gateway e o token. - Sessão cai com frequência: cheque a estabilidade do aparelho/origem e os webhooks. Veja também - Conectar WhatsApp Web (pareamento por QR) - Instalador e deploy