Guia do Administrador
Este guia cobre as responsabilidades de quem administra uma conta Koda: membros, cargos, módulos, integrações e operação. Em instalações multiempresa, há também um Painel administrativo separado para operar os sistemas da instalação.
Painel administrativo multiempresa
O Painel administrativo é destinado à equipe que mantém a instalação Koda, não aos administradores comuns de uma empresa. Ele usa contas próprias de Responsável e Operador. Uma conta de usuário dentro de um sistema não dá acesso automático a esse painel.
Use o painel para criar e acompanhar sistemas, controlar acesso e aplicar atualizações de schema de forma auditada. Ele não exibe senhas, URLs de banco ou outras credenciais dos sistemas.
Papéis do painel
| Papel | Pode fazer |
|---|---|
| Responsável | Tudo que o Operador faz, além de criar contas do painel, alterar planos e agendar a atualização de schema de todos os sistemas ativos. |
| Operador | Criar e administrar sistemas, bloquear ou reativar acesso, reenviar ativação, atualizar schema de um sistema e reconciliar acessos. |
Criar um sistema
- Abra Criar novo sistema.
- Informe empresa, código interno, nome e e-mail do proprietário.
- Escolha o plano e os módulos adicionais, quando aplicável.
- Selecione Criar sistema e acompanhe a coluna Provisionamento.
- Quando o estado ficar Ativo, confirme o acesso do administrador com um teste controlado de login.
Cada sistema recebe banco e usuário próprios. Se a preparação falhar, use Tentar novamente após corrigir a causa; não crie um segundo sistema com o mesmo objetivo.
Estados do sistema
| Estado | Significado | Próxima ação usual |
|---|---|---|
| Em preparação | O sistema ainda está sendo criado. | Aguarde; se a operação falhar, use Tentar novamente após corrigir a causa. |
| Ativo | Pode receber login, jobs e tráfego normal. | Operação normal. |
| Bloqueado | Novos acessos são negados, mas os dados continuam preservados. | Use Reativar quando o acesso puder voltar. |
| Precisa de atenção | Uma operação de provisionamento ou schema falhou. | Leia o código de erro, corrija a causa e repita somente a operação correspondente. |
Atualizar schema com segurança
Use Atualizar schema quando a aplicação nova exigir uma tabela, coluna ou índice que ainda não existe no banco de um sistema. A ação é idempotente: se já houver uma atualização em fila ou em execução para o mesmo sistema, ela é reaproveitada.
- Confirme que o backup do sistema foi validado.
- Aplique a atualização primeiro em um sistema canário, quando houver mais de um sistema ativo.
- Na linha do sistema, selecione Atualizar schema e confirme o agendamento.
- Acompanhe a coluna Schema até aparecer Concluído.
- Teste o fluxo afetado, como login, criação de registro ou integração correspondente.
Importante: Reconciliar não corrige erro de schema. Se o log mencionar coluna ou tabela inexistente, use Atualizar schema para o sistema afetado.
Membros, cargos e módulos
O administrador pode convidar membros já com um cargo, atribuir cargos individualmente ou em lote e ajustar ações permitidas. Em Configurações → Equipe → Cargos e permissões, o assistente conduz por nome e modelo, áreas de trabalho e revisão.
Em cada área, escolha Sem acesso, Consultar, Operar ou Gerenciar. Use Personalizar ações somente quando precisar separar ações como enviar, exportar, aprovar ou publicar. Nos módulos com responsáveis, defina separadamente quais registros a pessoa pode ver e alterar: próprios, atribuídos ou todos. O alcance de alteração nunca pode ser maior que o de consulta.
Antes de salvar, confira a prévia e quantas pessoas serão afetadas. Recursos desativados para a empresa podem ficar preparados no cargo, mas só funcionam depois da ativação do módulo. Ao excluir um cargo, as pessoas associadas ficam somente com consulta até receberem outro. A autorização é avaliada no servidor em todos os canais; esconder um botão não concede acesso.
Os módulos são habilitados no fluxo de personalização da conta. Algumas funcionalidades dependem de outras: WhatsApp depende de Caixa de entrada e Empresas; Transmissões depende de Contatos e WhatsApp; Negócios depende de Contatos; Fluxos e Agentes de IA dependem de Caixa de entrada.
Integrações e operação
- WhatsApp: confirme os requisitos da Meta, valide o webhook e faça um envio de teste controlado.
- Google Calendar: configure autorização e calendário antes de criar eventos pelo Koda.
- Webhooks: use endpoints HTTPS controlados, valide a assinatura recebida e monitore falhas de entrega.
- API pública: crie uma chave com o menor escopo necessário e revogue-a quando deixar de ser usada.
Envios, campanhas, automações, mídia e webhooks podem continuar em segundo plano. Antes de repetir uma ação que falhou, confira o estado da operação para evitar duplicidade.
Segurança e manutenção
- revise membros e cargos periodicamente;
- revogue chaves e convites antigos;
- mantenha HTTPS e os serviços atualizados;
- limite o acesso ao painel de plataforma e aos volumes;
- nunca coloque credenciais em documentação ou screenshots.
Para sintomas operacionais, consulte a Solução de Problemas.