Publicar

Versões

O rascunho vira uma versão quando você publica, na aba Versões:

1. Salve o rascunho e confira que o portal não aponta problemas.
2. Publicar: informe a versão em SemVer, maior que todas as anteriores (0.1.0, 0.2.0, 1.0.0…), e as notas de mudança.
3. Ativar: a versão ativa é a que vale para todas as empresas (menu, escopos, eventos, URL do iframe). Só uma fica ativa por vez.

Rollback é ativar uma versão anterior. Publicar e ativar exigem papel dono ou admin.

Mudança	O que acontece com as empresas
Menu, textos, ícone, URL do iframe, eventos já cobertos pelos escopos	Vale na próxima carga do Botzetta
Escopo novo	Só vale para uma empresa depois que o admin dela aceitar o novo consentimento (o app recebe app.escopos-alterados). Até lá a instalação segue com os escopos antigos
Escopo removido	Deixa de valer na hora para todas

Revisão

Uma versão exige revisão quando pede um escopo de risco alto (mensagens:ler, mensagens:enviar) que nenhuma versão aprovada do app tinha. Enquanto não for aprovada:

• ela só pode ser ativada se o app ainda não tem instalação ativa fora da sandbox;
• ativa e sem aprovação, só a sandbox instala: empresas reais recebem a tela "app indisponível" (ERR_APP_INDISPONIVEL).

Para testar escopo de risco alto num app que já tem clientes, crie um segundo app só de desenvolvimento.

Enviar para revisão (aba Versões): informe a URL de um vídeo (https:) mostrando o app em uso e as instruções para o revisor (como entrar, o que clicar). Só cabe uma revisão pendente por app. A equipe da Botzetta confere, entre outras coisas:

• manifesto válido e URLs https:;
• o cabeçalho Content-Security-Policy: frame-ancestors da sua página;
• redirect URIs sem curinga e sem localhost;
• a justificativa de cada escopo novo;
• a política de privacidade respondendo;
• a saúde do webhook nas últimas 24 horas;
• nome e títulos que imitem o Botzetta ou outro app.

O parecer aparece no portal e chega por e-mail a todos os membros da organização. Aprovar não ativa a versão: depois da aprovação, quem ativa é você.

App privado

Todo app começa privado: pode ter instalação ativa em até 5 empresas reais, além da sandbox. A sexta recebe ERR_LIMITE_APP_PRIVADO no consentimento. Desinstalar libera a vaga.

Para distribuir sem limite, peça a liberação à Botzetta. Voltar ao limite não desinstala ninguém: só recusa novas instalações acima de 5.

Distribuir

O link de instalação é a sua URL de instalação. Mande-o aos clientes, ponha no seu site ou no seu produto. Quem instala precisa ser admin da empresa no Botzetta, e o plano dela precisa incluir apps de parceiros (ERR_PLANO_SEM_RECURSO na tela de consentimento, se não incluir).

A aba Instalações do portal mostra as empresas com o app instalado.

Suspensão

A Botzetta pode suspender um app (abuso, vazamento, descumprimento dos termos). Em até 60 segundos: as chamadas à API recebem 403, os refresh são recusados, os webhooks param e o app sai do menu. Se os tokens forem revogados junto, as empresas precisam reinstalar quando o app voltar; senão, ele volta a funcionar sem reinstalação.

Se a organização for bloqueada, todos os apps dela são suspensos, a sandbox é desligada e o portal recusa alterações (ERR_ORGANIZACAO_SUSPENSA), com o motivo.