Instalando um Plugin
Cada plugin usa o mesmo assistente de instalacao em tres etapas: consentimento de permissoes, configuracao e confirmacao. Este guia explica cada etapa em detalhes.
Quem pode instalar plugins
Apenas usuarios com o papel de Administrador em uma subconta podem instalar ou desinstalar plugins. Operadores com papeis de Gerente, Despachante ou Mecanico podem ver o marketplace mas nao instalar.
Se sua subconta esta no plano gratuito, voce pode instalar ate dois plugins gratuitos. Planos pagos recebem instalacoes ilimitadas.
Passo 1 - Consentimento de permissoes
Quando voce clica em Instalar em uma pagina de detalhes de plugin, o assistente abre com uma lista de permissoes em linguagem clara:
O Slack gostaria de:
- Ler corridas
- Ler veiculos
- Ler zonas
Cada item mapeia para um ou mais escopos de permissao no manifesto do plugin. O assistente agrupa escopos relacionados em itens unicos para manter a lista legivel.
Escopos de classe administrativa
Algumas permissoes sao de maior risco. Estas sao mostradas em ambar e exigem uma confirmacao explicita via caixa de selecao:
| Escopo | O que significa |
|---|---|
read:customers.pii | Ler nomes, e-mails, numeros de telefone do passageiro |
write:vehicles.status | Bloquear, desbloquear ou alterar status do veiculo |
write:zones | Criar, editar ou excluir zonas |
read:rides.financial | Acessar precos de corrida, taxas e repasses |
Se o plugin precisar apenas de escopos comuns (como read:rides), nenhuma confirmacao ambar e necessaria.
Permissoes sao limitadas a sua subconta
Um token de plugin concedido pela Subconta A nunca pode ler dados na Subconta B. O acesso entre subcontas e aplicado no nivel do banco de dados via row-level security - nao ha como um plugin escalar escopo.
Passo 2 - Configurar
O formulario de configuracao e gerado automaticamente a partir do config_schema (JSON Schema) do plugin. Plugins diferentes pedem coisas diferentes:
- Chaves de API - Veriff, Persona, Captur.ai
- Conexao OAuth - Slack (workspace), Zapier (conta Zapier)
- URL de destino do webhook - para plugins de construcao propria
- Limites, canais, filtros - ajuste especifico do plugin (por exemplo, "postar em #ops se um veiculo tiver < 20% de bateria")
Fluxo OAuth
Se o plugin usar OAuth (Slack e o exemplo mais comum), voce clicara em Conectar e sera redirecionado para a pagina de autorizacao do fornecedor. Aprove os escopos solicitados, e voce sera redirecionado de volta para a Levy com a conexao estabelecida.
Tokens emitidos durante o OAuth sao armazenados criptografados em repouso no Supabase Vault. A Levy nunca exibe o token bruto apos a troca inicial.
Segredos criptografados
Chaves de API e outros campos sensiveis tambem sao armazenados no Supabase Vault, criptografados por linha. Eles sao descriptografados apenas quando o handler do plugin precisa deles para chamar a API do fornecedor.
Passo 3 - Confirmar
A tela final recapitula:
- O nome e versao do plugin
- As permissoes que voce concedeu
- O modelo de preco (gratuito, unico, mensal, uso)
- O link dos termos de servico do fornecedor
Clique em Instalar. Se o plugin for pago:
- Unico - o Stripe cobra seu cartao imediatamente.
- Mensal - o Stripe cria uma assinatura. A primeira cobranca e proporcional ao seu ciclo de faturamento.
- Uso - sem cobranca hoje; voce sera cobrado mensalmente com base no uso real.
Voce retorna para Configuracoes -> Plugins, onde a nova instalacao aparece como Ativa.
Reinstalando um plugin
Se voce desinstalou um plugin anteriormente, a reinstalacao reutiliza a mesma linha de instalacao. Sua configuracao antiga se foi (a janela de exclusao suave de 30 dias passou quando a maioria dos operadores reinstala), entao voce reinserira sua configuracao do zero. Cada subconta pode ter apenas uma instalacao ativa por plugin.
Erros de instalacao comuns
| Erro | Causa | Solucao |
|---|---|---|
| "Voce precisa do papel de admin para instalar plugins" | Logado como Gerente / Despachante | Peca a um administrador da subconta para instalar |
| "Limite de plugin do plano gratuito atingido" | Ja instalou 2 plugins gratuitos no plano gratuito | Desinstale um ou atualize o plano |
| "Callback OAuth rejeitado" | Fornecedor retornou um erro | Verifique a pagina de status do fornecedor; tente novamente |
| "Cobranca do Stripe falhou" | Cartao recusado para plugin pago | Atualize o metodo de pagamento em Configuracoes -> Cobranca |
| "Manifesto do plugin nao mais valido" | Fornecedor empurrou uma versao breaking no meio da instalacao | Atualize a pagina e reconsente |
O que vem a seguir
- Configurando um plugin - editando configuracoes apos a instalacao
- Cobranca de plugins - como cobrancas, reembolsos e a taxa de 20% funcionam
- Solucao de problemas - falhas de webhook, rotacao de tokens e mais