Configurando um Plugin
Apos instalar um plugin, voce o gerencia em Painel -> Configuracoes -> Plugins. Esta pagina lista cada instalacao em sua subconta com sua saude, configuracao e log de auditoria.
A pagina de plugins instalados
Cada linha mostra:
| Coluna | O que significa |
|---|---|
| Plugin | Logo + nome + versao |
| Status | Ativo, Desativado, Falhando ou Desinstalando |
| Ultimo evento | Timestamp da entrega de webhook mais recente |
| Taxa de sucesso 24h | Porcentagem de tentativas de webhook que tiveram sucesso |
| Acoes | Icone de engrenagem -> painel de gerenciamento completo |
Indicadores de status
- Ativo (verde) - instalacao saudavel, webhooks entregando, token valido.
- Desativado (cinza) - operador pausou a entrega de webhook; configuracao retida, token ainda valido.
- Falhando (ambar) - entregas recentes de webhook estao com erro; o endpoint do fornecedor provavelmente esta fora do ar.
- Desinstalando (cinza) - janela de exclusao suave de 30 dias em andamento; a linha e removida assim que terminar.
Um plugin que permanece no estado Falhando por 7 dias continuos e desativado automaticamente pela Levy. Voce pode reativa-lo assim que o endpoint do fornecedor estiver de volta.
Editar configuracao
Clique no icone de engrenagem -> Configurar. O mesmo formulario que voce viu na instalacao reabre com seus valores atuais pre-preenchidos. Salve suas alteracoes e o plugin comeca a usar a nova configuracao na proxima entrega de evento.
Voce nao precisa desinstalar e reinstalar para alterar uma configuracao. Razoes comuns para editar configuracao:
- Mover alertas do Slack para um canal diferente
- Apertar ou afrouxar o limite de pontuacao de estacionamento do Captur.ai
- Alterar qual dataset BigQuery recebe a exportacao diaria
- Atualizar uma chave de API depois que um fornecedor rotaciona a sua
Desativar temporariamente
Clique em Desativar para pausar a entrega de webhook sem desinstalar. O plugin permanece em sua lista, a configuracao e o token sao preservados, mas a Levy para de enviar eventos. Use isto para:
- Janelas de manutencao do lado do fornecedor
- Investigar um volume descontrolado de alertas
- Pausar plugins cobrados por evento enquanto voce depura
Clique em Ativar para retomar.
Rotacionar o token de API do plugin
Plugins se autenticam de volta para /api/plugin/v1/* com um token no formato lvy_plg_<prefixo-do-id-de-instalacao>_<aleatorio>. Se voce suspeitar que o token vazou:
Abrir a instalacao
Configuracoes -> Plugins -> icone de engrenagem ao lado da instalacao.
Clicar em Rotacionar Token
Um novo token e emitido imediatamente. O token antigo entra em um periodo de gracia de 24 horas durante o qual ambos funcionam - tempo suficiente para o fornecedor trocar.
Notificar o fornecedor
Envie o novo token ao fornecedor atraves do canal de suporte dele. Apos 24 horas, o token antigo para de funcionar.
A rotacao e registrada no log de auditoria do plugin.
Visualizar o log de auditoria
Clique no icone de engrenagem -> Log de auditoria. Cada acao executada contra esta instalacao e registrada:
| Acao | Registrado |
|---|---|
install | Instalacao inicial com permissoes + configuracao |
configure | Cada salvamento de configuracao |
disable / enable | Pausar / retomar |
token_rotated | Rotacao de token |
webhook_sent | Cada webhook de saida (amostrado em escala) |
webhook_failed | Entrega falhada com trecho do corpo da resposta |
uninstall | Desinstalacao final com motivo |
Os logs sao retidos por 18 meses e exportaveis para CSV.
Reenviar um webhook falhado
Se uma entrega de webhook falhou mas o endpoint do fornecedor agora esta de volta, voce pode reenvia-lo manualmente:
Abrir o log de auditoria
Configuracoes -> Plugins -> engrenagem -> Log de auditoria.
Encontrar o evento falhado
Filtre por acao = webhook_failed. Cada linha tem um botao Reenviar.
Clicar em Reenviar
O evento e reenviado ao fornecedor imediatamente. O resultado e registrado como uma nova linha de auditoria.
Voce tem uma janela de reenvio de 7 dias a partir do tempo do evento original.
Desinstalar
Clique em Desinstalar no menu de engrenagem. Voce sera solicitado a confirmar. Ao confirmar:
- O token de API do plugin e revogado imediatamente.
- As assinaturas de webhook sao pausadas.
- A configuracao entra em uma janela de exclusao suave de 30 dias - se voce reinstalar dentro dessa janela, sua configuracao retorna.
- O fornecedor recebe um webhook de exclusao para que possa limpar sua copia dos seus dados (importante para conformidade com LGPD/GDPR).
- Uma linha de auditoria
uninstalle escrita.
Assinaturas pagas sao canceladas no Stripe; voce e cobrado apenas pelo uso ate o timestamp de desinstalacao.
O que vem a seguir
- Cobranca de plugins - como as cobrancas funcionam
- Solucao de problemas - diagnosticar falhas