Visão geral
Os Custom Scripts permitem injetar JavaScript/CSS em superfícies específicas da plataforma — o dashboard, o portal da Central de Ajuda e o widget de chat. Eles são úteis para pequenas personalizações de comportamento e estilo sem alterar o código-base.
Pré-requisitos
- Permissão de administrador para gerenciar Custom Scripts.
- Conhecimento de JavaScript/CSS.
Passo a passo
- Acesse o módulo de Custom Scripts.
- Crie um script e escolha a superfície (dashboard, portal ou widget).
- Defina o tipo (JS ou CSS) e quando ele deve rodar.
- Use o contexto ctx fornecido pelo runtime para interagir com a superfície de forma segura.
- Implemente o teardown para limpar o que o script criou, quando aplicável.
Configurações & opções
- Superfície: dashboard / portal / widget.
- Tipo: JS ou CSS.
- Execução: regras de quando o script roda.
Casos de uso
- Adicionar um botão ou aviso em uma tela específica.
- Ajustar estilos pontuais de uma superfície.
- Registrar eventos de uso para análise interna.
Dicas, limites e boas práticas
- Escreva scripts idempotentes e com teardown para evitar duplicação.
- Evite dependências pesadas; prefira código enxuto.
- Teste em ambiente controlado antes de publicar.
Solução de problemas
- Script não executa: confirme a superfície e as regras de execução.
- Comportamento duplicado: verifique o teardown e a idempotência.