O catálogo deixa um plugin hospedado por uma conta ser instalado por outras contas do Novus CRM, sem copiar arquivos nem hospedar de novo. Cada versão passa pela análise do time Novus antes de chegar a quem instalou.
O catálogo está em beta, junto com a hospedagem no Novus CRM, e é liberado por conta, sob pedido ao suporte técnico do Novus CRM.
O plugin precisa cumprir quatro condições:
  • Ser Hospedado no Novus. Plugin com endereço próprio não entra no catálogo.
  • Estar com Só eu vejo este plugin desligado.
  • Ter uma versão publicada.
  • Ser enviado por um administrador ou pelo responsável pela conta.
1

Abra a seção Catálogo

Em Configurações > Plugins, abra a ação Versões do plugin. A seção Catálogo mostra a situação do plugin e o botão Enviar para o catálogo.
2

Preencha a ficha pública

Nome no catálogo, Descrição, Categoria, Contato de suporte e, opcionalmente, o caminho de uma imagem dentro do pacote para servir de ícone. A descrição é o que as outras contas leem antes de instalar: diga o que o plugin faz e com quais dados ele trabalha.
3

Escolha a versão e envie para análise

Só versões publicadas podem ir para análise. A conta publicadora recebe uma notificação quando o time Novus decide.
Um plugin feito para o catálogo precisa funcionar em qualquer conta:
  • Segredos são sempre da conta que instala. O manifesto só declara nomes. Use nomes próprios do plugin, como agenda.token, e explique na descrição quais variáveis a conta precisa cadastrar e onde conseguir cada valor.
  • Não dependa de dado da sua conta. Ids de canal, de etapa ou de usuário mudam de uma conta para outra. Busque pela API em vez de fixar no código.
  • Declare só o que usa. A lista de permissões aparece para quem vai instalar, e cada permissão nova numa atualização exige nova aprovação em todas as contas.

​
Moderação

O time Novus analisa cada versão enviada: manifesto, permissões, diferença em relação à última versão aprovada, avisos do pacote e o plugin rodando na pré-visualização. A análise termina de um de dois jeitos:
  • Aprovada: a versão passa a ser a do catálogo e segue para as contas que instalaram, conforme Atualizações.
  • Reprovada: a conta publicadora vê o motivo. Se já havia uma versão aprovada, ela continua no catálogo e nada muda para quem instalou.
Você continua publicando versões na sua conta como sempre. O catálogo só distribui a última versão aprovada. Enquanto uma versão nova está em análise, o plugin segue instalável na versão aprovada anterior. Plugins aprovados aparecem em Configurações > Catálogo de Plugins, com busca por nome ou descrição e filtro por categoria. O detalhe de cada plugin mostra quem publicou, a versão aprovada, onde ele aparece, o que ele acessa e o contato de suporte.
1

Revise as permissões

A tela lista os hosts, domínios, segredos e superfícies da versão aprovada, e os segredos que ainda não existem na sua conta.
2

Autorize e instale

Só um administrador ou o responsável pela conta instala. Se o plugin pede permissões, marque Revisei e autorizo estas permissões e clique em Instalar.
3

Cadastre os segredos que faltam

O plugin é instalado mesmo com segredo pendente. As chamadas que usam esse segredo falham com Secret not found até a variável existir em Variáveis Globais.
Cada plugin do catálogo é instalado uma vez por conta. A instalação aparece em Configurações > Plugins e aponta para o endereço da versão aprovada, https://{slug}--v{n}.novusplugin.com/. Uma conta não instala pelo catálogo um plugin que ela mesma publicou.

​
Atualizações

Quando o time Novus aprova uma versão nova, cada instalação segue uma de duas regras: Quando uma atualização fica pendente, os administradores da conta recebem uma notificação. Um administrador ou o responsável clica em Atualizar, revisa as permissões novas, se houver, e confirma. A atualização automática vem ligada. O diálogo Atualizar tem a opção Atualizar sozinho nas próximas versões. Com ela desmarcada, nenhuma versão nova é instalada sem alguém confirmar.

​
Retirada e bloqueio

Retirada é decisão da conta publicadora. Retirar do catálogo tira o plugin da listagem, com um motivo opcional que as contas instaladas veem. As instalações existentes continuam funcionando na versão que têm, marcadas como Retirado, e não recebem mais atualizações. O plugin pode ser enviado para análise de novo depois. A conta publicadora só exclui o plugin de origem depois de retirá-lo do catálogo. Mesmo excluído, as versões que outras contas usam continuam no ar. Bloqueio é decisão do time Novus, por segurança ou abuso. Um plugin bloqueado:
  • Deixa de ser servido em todas as versões. O endereço responde 410.
  • Tem todas as chamadas de apiRequest recusadas pelo proxy, em todas as contas.
  • Aparece como Bloqueado, com o motivo, para quem instalou.
  • Não volta ao catálogo enquanto estiver bloqueado.
As contas instaladas e a conta publicadora recebem uma notificação.