Menu do Botzetta

O app ganha um ícone próprio no menu lateral do Botzetta, que abre o painel com os itens do app. Você define tudo no rascunho (Itens de menu e Geral) e vale na próxima carga do Botzetta depois de ativar a versão.

Posição e ícone

• Os apps de parceiro ficam entre o CRM e a Administração, em ordem alfabética pelo nome. Não há como escolher a posição nem entrar nos menus do próprio Botzetta.
• O Botzetta marca o ícone com um selo e "(app de parceiro)" no rótulo.
• Ícone do app: um PNG próprio (quadrado, de 32 a 256 px, até 32 KB, sem texto, EXIF ou perfil de cor; SVG não é aceito) ou um ícone da lista abaixo. O Botzetta guarda e serve o PNG: nunca carrega imagem da sua origem. Sem os dois, usa o ícone do primeiro item.

Itens

[
  { "titulo": "Notas emitidas", "abrir": "embutido", "rota": "notas", "icone": "FileText" },
  { "titulo": "Configurações", "abrir": "embutido", "rota": "config", "icone": "Settings", "soAdmin": true },
  { "titulo": "Central de ajuda", "abrir": "nova-aba", "url": "https://ajuda.meuapp.exemplo.com", "icone": "BookText" }
]

Campo	Regra
titulo	Até 30 caracteres, sem quebra de linha
abrir	embutido (padrão) ou nova-aba
rota	Em embutido: caminho relativo. /apps/<slug>/<rota> abre <URL base>/<rota> no iframe. Sem URL base no app, o item não aparece
url	Em nova-aba: URL https: absoluta, até 500 caracteres, sem usuário/senha
icone	Da lista abaixo
soAdmin	true: só o administrador da empresa vê
acesso	Referência de um acesso GBAC do app: só quem tem o acesso vê

Os itens aparecem na ordem do array.

nova-aba abre com rel="noopener noreferrer" e sem Referer, e o domínio aparece no rótulo. A página não recebe token nem contexto. Se ela precisa saber quem é o usuário, use um item embutido.

Esconder não é proteger

soAdmin e acesso escondem o item e bloqueiam a rota no Botzetta, mas são só apresentação. O seu backend tem de conferir de novo, pelo GET /sessao (ver Tela em iframe).

Ícones permitidos

BarChart3, Bell, BookText, Bot, Box, Cake, Calendar, CalendarClock, Clock, FileText, FolderOpen, Gift, KanbanSquare, Layers, LayoutGrid, ListChecks, ListPlus, Mail, Megaphone, MessageSquare, Plug, Send, Settings, Sparkles, Star, Tag, Target, Users, Workflow, Zap.

Os nomes são os do Lucide. Um nome fora da lista é recusado ao publicar.