Comecando com Plugins
Este guia o conduz pela instalacao do seu primeiro plugin. Usaremos o Slack como exemplo - e gratuito, configura em menos de cinco minutos e oferece valor imediato (alertas operacionais no seu workspace do Slack).
Antes de comecar
Voce precisa:
- Uma subconta Levy Fleets ativa
- Papel de Administrador nessa subconta (somente administradores podem instalar plugins)
- Especificamente para o Slack: um workspace do Slack e permissao para instalar aplicativos do Slack la
Passo 1 - Abrir o marketplace
Navegue ate o Marketplace
Na barra lateral do painel, clique em Marketplace.
Navegue ou pesquise
Navegue por categoria na barra lateral esquerda ou digite "slack" na barra de pesquisa.
Abra a pagina de detalhes do plugin
Clique no cartao do Slack. A pagina de detalhes mostra a descricao longa, capturas de tela, permissoes, eventos suportados e precos.
Passo 2 - Instalar
Clique em Instalar. O assistente de instalacao abre com tres passos.
Consentimento de permissoes
Voce vera uma lista clara do que o Slack podera fazer - por exemplo, "Ler corridas", "Ler veiculos", "Ler zonas". Permissoes de classe administrativa (qualquer coisa que possa bloquear ou desbloquear veiculos, alterar zonas ou ler PII do passageiro) sao destacadas em ambar e exigem uma confirmacao explicita via caixa de selecao.
Configurar
Cada plugin renderiza seu proprio formulario de configuracao. Para o Slack, voce conectara um workspace do Slack via OAuth e escolhera os canais para cada tipo de alerta. Para o Veriff, voce inserira credenciais de API. Para o Captur.ai, voce definira o limite de pontuacao de estacionamento.
Confirmar
Voce vera o lembrete de preco mais uma vez (gratuito para o Slack). Clique em Instalar para finalizar.
Passo 3 - Verificar se esta funcionando
Abra Painel -> Configuracoes -> Plugins. O plugin recem-instalado aparece na lista com um indicador de status:
- Ativo - a instalacao esta saudavel e recebendo eventos
- Desativado - pausado por um operador (webhooks suspensos, configuracao retida)
- Falhando - entregas recentes de webhook falharam; clique no icone de engrenagem para ver o erro
O painel de detalhes mostra a ultima entrega bem-sucedida, a ultima falha (com trecho do corpo da resposta) e um medidor de taxa de sucesso de 24 horas.
Para o Slack, o teste mais facil e definir um veiculo para manutencao - voce devera ver uma mensagem no canal configurado em alguns segundos.
Passo 4 - Ajustar mais tarde
A maioria dos plugins permite alterar a configuracao sem reinstalar. Clique no icone de engrenagem na linha de instalacao para:
- Atualizar o formulario de configuracao (por exemplo, alterar o canal do Slack)
- Desativar o plugin temporariamente (pausa a entrega de webhook, mantem a configuracao)
- Rotacionar o token de API do plugin se voce suspeitar que vazou
- Visualizar o log de auditoria de cada acao de instalar/configurar/desinstalar
Escolhas comuns de primeira instalacao
| Se voce precisa de... | Instale... | Tempo ate o primeiro evento |
|---|---|---|
| Alertas operacionais gratuitos | Slack | 2 minutos |
| Automacao universal | Zapier | 5 minutos (atraves da UI do Zapier) |
| Verificacao de identidade | Veriff ou Persona | 10 minutos (chaves de API necessarias) |
| Exportacao diaria para warehouse | BigQuery / Snowflake / Looker | 15 minutos (credenciais de warehouse necessarias) |
O que vem a seguir
- Instalando um plugin - passo a passo completo do assistente de instalacao
- Configurando um plugin - editando configuracao apos a instalacao
- Solucao de problemas - o que fazer quando um plugin reporta falhas