Visão geral das integrações
O Omniscol integra-se ao seu sistema de informação por várias vias, conforme a necessidade.
Para exemplos de ferramentas de terceiros e parceiros regularmente conectados ao Omniscol, veja também integrations.partners.
Visão sintética
| Mecanismo | Para que serve | Sentido do fluxo |
|---|---|---|
| iCal | Permitir que professores / alunos vejam o seu horário na agenda pessoal | Omniscol → agenda |
| Links de partilha | Divulgar um horário somente leitura ou abrir uma entrada de dados específica conforme o contexto | Omniscol → web público |
| Iframe | Incorporar um horário numa página no mesmo domínio que o Omniscol; bloqueado num site externo (segurança) | Omniscol → mesmo domínio |
| API Omniscol | Integrações sistema a sistema conforme os direitos e as opções da conta | Conforme a configuração |
| MCP | Conectar um agente de IA compatível com MCP ao Omniscol | Agente de IA ↔ Omniscol |
| OAuth2 / OIDC (servidor) | Conectar um serviço de terceiros identificado por cliente registado + consentimento + token com escopo (base do MCP e do OneRoster) | Serviço ↔ Omniscol |
| OIDC / SSO (login) | Autenticação dos utilizadores via provedor de identidade (Google Workspace, Microsoft Entra ID, OIDC genérico) | Conforme a configuração |
| Sincronização com sistemas externos | Framework de conectores ERP: Aurion, Auriga, novos conectores por projeto | Bidirecional |
| Painéis de exibição | Exibir o horário em ecrãs públicos | Omniscol → ecrãs |
Escolher a integração adequada
- Divulgar um horário a um professor / aluno — assinatura iCal.
- Conceder acesso de leitura a um pai / uma auditoria — link de partilha.
- Sincronizar os alunos a partir do seu ERP / SI — veja Sincronização com sistemas externos que lista os conectores disponíveis. Se o seu ERP não constar da lista, a adição de um conector é definida com o suporte Omniscol.
- Autenticação única — OIDC / SSO.
- Assistente de IA externo na conta, se a opção estiver ativada — MCP para os clientes compatíveis.
- Exibição pública nas instalações — painéis de exibição.
Boas práticas de segurança
- Utilizar OIDC / SSO, quando a opção estiver ativada, para autenticar utilizadores reais.
- Reservar os tokens de API para integrações sistema a sistema, com escopo mínimo e rotação periódica.
- Definir datas de expiração curtas nos links de partilha.
- Não colocar um token de API num repositório Git público.