MiroxMirox
  • Plataforma

    • Filosofia
    • Visão geral da plataforma
    • Recursos da plataforma
    • Disponibilidade e janelas de manutenção
    • Lançamentos e versões
  • Mirox-Cloud

    • Visão geral da cloud
    • Microsserviços ligados
  • Mirox-Agent

    • Visão geral do agente
    • Opções de implementação
    • Data Scraper
    • Gémeo digital
  • Detalhes técnicos

    • Recolha de métricas
  • Informações

    • Centrais suportadas
  • Tipos de central

    • Centrais solares
    • Seguidores solares e controladores do parque
    • Postos de transformação
    • Parques eólicos
    • Armazenamento por baterias
    • Sistema de alarme
  • Monitorização e visualização

    • Monitorização em tempo real
    • Gémeo digital
    • Estados dos componentes
    • Códigos de estado do inversor
    • Eventos do inversor
    • Deteção de perdas
    • Limites de potência e corte
    • Deteção de eficiência
    • Painel de KPI
  • Gestão de dados

    • Eventos
    • Níveis de alarme
    • Tickets
    • Previsões
    • Relatórios
    • Métricas
  • Alert Manager

    • Visão geral
    • Regras de alerta
    • Alertas e notificações
    • Exemplos
  • Integração e partilha

    • Cooperações
    • Tokens de API
    • VPN
    • Conflitos de endereços VPN
    • Proxy
  • IA

    • Assistente de IA e assistentes
    • Acesso agêntico (MCP)
  • Faturação

    • Mercado e tarifas
    • Como a Receita É Calculada
    • Contabilidade e faturação
    • Contratos
    • Certificados de serviço e faturas
  • Colaboração

    • Convites
  • Segurança

    • Autenticação
    • Bloqueio de conta
    • Política de segurança da organização
    • Sistema de permissões
    • Segmentação de rede
    • Restrições de cooperação
    • Registo de auditoria de acesso
    • Atividade e auditoria
    • Isolamento de Dados
  • Primeiros passos

    • Onboarding
    • Configuração inicial
  • Pessoal

    • Utilizar a VPN
    • Utilizar o proxy
    • Autenticação de dois fatores
    • Sessões
    • Tokens de API
    • Notificações
    • Ligar o Microsoft Teams
  • Por central

    • Contactos
    • Dispositivos de rede
    • Registadores de dados
    • Leitor Modbus genérico
    • Componentes
    • VPN direta (por agente)
    • Volume de dados
    • Importar histórico
  • Organização

    • Permissões de membros
    • Política de segurança
    • Cooperações
    • Armazenamento de ficheiros
    • Serviços VPN
    • Trabalhar com Relatórios
  • Exportação de dados

    • Exportação de métricas
    • API de exportação de métricas
    • Migrar para a exportação de métricas
    • API de exportação legada
    • Geração externa de relatórios
    • Grafana
    • Dashboards Grafana
    • Visão geral da API
    • Fórmulas MiroxQL (API)
  • Suporte

    • Solicitar uma integração
  • Relatórios

    • Gerador de relatórios externo
    • Exportação de métricas para Excel
  • Acesso Remoto
  • Segurança da conta
  • IA na Mirox
  • Importação do histórico
  • Relatórios
  • Exportação de dados
  • English
  • Deutsch
  • Español
  • Français
  • Português
  • Italiano
  • English
  • Plataforma

    • Filosofia
    • Visão geral da plataforma
    • Recursos da plataforma
    • Disponibilidade e janelas de manutenção
    • Lançamentos e versões
  • Mirox-Cloud

    • Visão geral da cloud
    • Microsserviços ligados
  • Mirox-Agent

    • Visão geral do agente
    • Opções de implementação
    • Data Scraper
    • Gémeo digital
  • Detalhes técnicos

    • Recolha de métricas
  • Informações

    • Centrais suportadas
  • Tipos de central

    • Centrais solares
    • Seguidores solares e controladores do parque
    • Postos de transformação
    • Parques eólicos
    • Armazenamento por baterias
    • Sistema de alarme
  • Monitorização e visualização

    • Monitorização em tempo real
    • Gémeo digital
    • Estados dos componentes
    • Códigos de estado do inversor
    • Eventos do inversor
    • Deteção de perdas
    • Limites de potência e corte
    • Deteção de eficiência
    • Painel de KPI
  • Gestão de dados

    • Eventos
    • Níveis de alarme
    • Tickets
    • Previsões
    • Relatórios
    • Métricas
  • Alert Manager

    • Visão geral
    • Regras de alerta
    • Alertas e notificações
    • Exemplos
  • Integração e partilha

    • Cooperações
    • Tokens de API
    • VPN
    • Conflitos de endereços VPN
    • Proxy
  • IA

    • Assistente de IA e assistentes
    • Acesso agêntico (MCP)
  • Faturação

    • Mercado e tarifas
    • Como a Receita É Calculada
    • Contabilidade e faturação
    • Contratos
    • Certificados de serviço e faturas
  • Colaboração

    • Convites
  • Segurança

    • Autenticação
    • Bloqueio de conta
    • Política de segurança da organização
    • Sistema de permissões
    • Segmentação de rede
    • Restrições de cooperação
    • Registo de auditoria de acesso
    • Atividade e auditoria
    • Isolamento de Dados
  • Primeiros passos

    • Onboarding
    • Configuração inicial
  • Pessoal

    • Utilizar a VPN
    • Utilizar o proxy
    • Autenticação de dois fatores
    • Sessões
    • Tokens de API
    • Notificações
    • Ligar o Microsoft Teams
  • Por central

    • Contactos
    • Dispositivos de rede
    • Registadores de dados
    • Leitor Modbus genérico
    • Componentes
    • VPN direta (por agente)
    • Volume de dados
    • Importar histórico
  • Organização

    • Permissões de membros
    • Política de segurança
    • Cooperações
    • Armazenamento de ficheiros
    • Serviços VPN
    • Trabalhar com Relatórios
  • Exportação de dados

    • Exportação de métricas
    • API de exportação de métricas
    • Migrar para a exportação de métricas
    • API de exportação legada
    • Geração externa de relatórios
    • Grafana
    • Dashboards Grafana
    • Visão geral da API
    • Fórmulas MiroxQL (API)
  • Suporte

    • Solicitar uma integração
  • Relatórios

    • Gerador de relatórios externo
    • Exportação de métricas para Excel
  • Acesso Remoto
  • Segurança da conta
  • IA na Mirox
  • Importação do histórico
  • Relatórios
  • Exportação de dados
  • English
  • Deutsch
  • Español
  • Français
  • Português
  • Italiano
  • English
  • Monitorização e visualização

    • Monitorização em Tempo Real
    • Gémeo Digital
    • Estados dos Componentes
    • Códigos de estado do inversor
    • Eventos do inversor
    • Deteção de Perdas
    • Limites de potência e corte
    • Deteção de Eficiência (PRRC)
    • Inspetor de Rede Local
    • Monitorização de Acessos
    • Painel de KPI
    • Visualização Gráfica
  • Gestão de dados

    • Eventos
    • Níveis de Alarme e Eventos Notificáveis
    • Tickets
    • Previsões
    • Relatórios
    • Métricas
  • Alert Manager

    • Gestor de alertas
    • Regras de Alerta
    • Alertas e Notificações
    • Exemplos
  • Integração e partilha

    • Cooperações
    • Tokens de API
    • VPN
    • VPN: conflitos de endereços
    • Proxy (Acesso Web aos Dispositivos do Parque)
  • IA

    • Assistente de IA e Assistentes Guiados
    • Acesso agêntico (MCP)
  • Faturação

    • Mercado e Tarifas
    • Como a Receita É Calculada
    • Contabilidade e Faturação
    • Contratos
    • Certificados de serviço e faturas
  • Colaboração

    • Convites
  • Segurança

    • Autenticação
    • Conta temporariamente bloqueada
    • Política de Segurança da Organização
    • Sistema de Permissões
    • Segmentação de rede
    • Restrições de Permissões de Cooperação
    • Registo de Auditoria de Acessos
    • Registo de Atividade e Auditoria
    • Isolamento de Dados

Alertas e Notificações

Alertas

Gestor de alertas ▸ Alertas lista os alertas gerados pelas suas regras. Abrir no Mirox Por predefinição vê o que está disparado neste momento; dois interruptores alargam a lista:

  • Mostrar resolvidos — acrescenta os alertas que terminaram, como histórico.
  • Mostrar silenciados — acrescenta os alertas que um silenciamento retém. Os alertas silenciados estão ocultos por predefinição, disparados ou resolvidos, para que a lista mostre o que alguém ainda tem de ver; a Visão geral conta-os à parte dos alertas disparados como + N silenciados.

Cada alerta mostra o seu nível, a regra, a central, o componente (nas regras avaliadas por componente), o valor e desde quando — ou de quando até quando — esteve disparado; as datas e horas seguem as definições de idioma e região do seu navegador. A central e o componente são ligações para as suas páginas. Um alerta de uma regra avaliada sobre o total da central oferece Que componentes?: reproduz a regra por componente no período do alerta e lista quais estiveram por trás. Um alerta que um silenciamento retém fica marcado como Silenciado.

Um alerta resolve-se por si quando a condição deixa de se verificar, quando a regra é desativada, alterada de modo que já não corresponda, ou eliminada. Os alertas resolvidos permanecem na lista como histórico.

Quem foi notificado, quem o viu

Notificados e Visto por nos detalhes do alerta mostram quem a plataforma notificou do alerta e quando, e quem o abriu desde então — abrir os detalhes regista-o aí. Não há nada a confirmar: um alerta termina por si quando a condição deixa de se verificar.

Silenciar um alerta a partir dos seus detalhes

Silenciar este alerta nos detalhes do alerta mantém exatamente este alerta calado sem abrir o separador Silenciamentos. Escolha durante quanto tempo — 1 h, 4 h (a predefinição), 8 h, 24 h, 3 d ou 7 d — e é criado um silenciamento para esta regra, esta central e este componente (o total da central quando o alerta abrange toda a central). O alerta é marcado de imediato como Silenciado e ninguém é notificado enquanto o silenciamento durar. Se o alerta ainda estiver disparado quando o silenciamento termina, é notificado nesse momento — o silenciamento adia, não engole. Um alerta que já tinha sido notificado antes de ser silenciado continua a enviar o seu aviso de resolução. Os detalhes ligam ao silenciamento em Abrir os silenciamentos, onde pode ser prolongado, alargado ou removido.

As alterações a regras e silenciamentos também aparecem na atividade da sua organização.

Quem é notificado

Quando um alerta se abre, todas as pessoas da sua organização que têm acesso à central são notificadas — na app, por push na app móvel e por e-mail, exatamente como cada pessoa escolheu nas suas próprias definições de notificação no grupo Gestor de alertas. Aí cada pessoa escolhe os canais e o nível mínimo a partir do qual quer ser informada sobre estes alertas; por predefinição é Normal.

Quando o alerta se resolve, as pessoas que foram notificadas recebem um aviso de resolução. A notificação liga diretamente ao alerta.

Silenciamentos

Um silenciamento mantém as notificações afastadas durante algum tempo — para manutenção, um problema conhecido ou uma paragem planeada. Os alertas correspondentes continuam a abrir e a fechar e são registados, marcados como Silenciado (e ocultos do separador Alertas até Mostrar silenciados); apenas as notificações e os destinatários ficam calados.

Abra Gestor de alertas ▸ Silenciamentos e clique em Novo silenciamento. Abrir no Mirox Escolha:

  • Regra — uma regra ou todas as regras.
  • Central — uma central ou todas as centrais.
  • Início — agora ou num momento planeado.
  • Durante — de 1 hora até 1 ano, ou Até uma data… para uma data de fim livre (no máximo um ano após o início).
  • Comentário — o motivo, para que os seus colegas saibam.

Enquanto escolhe, a caixa de diálogo conta em direto quantos alertas abertos correspondem — N alertas abertos seriam silenciados agora — para que veja o que o silenciamento vai reter antes de o criar. Um silenciamento que começa agora retém de imediato os alertas abertos correspondentes.

A tabela mostra para cada silenciamento a sua regra, central, início e fim, comentário e estado — Ativo, Agendado ou Encerrada — e Retém: o número de alertas abertos que o silenciamento retém neste momento.

Um silenciamento pode ser editado a partir da sua linha (Editar): regra, central, início, fim e comentário. A alteração aplica-se de imediato — os alertas que o silenciamento passa a abranger deixam de notificar, os que já não abrange voltam a notificar a partir da próxima avaliação. Um silenciamento criado a partir de um único alerta abrange apenas o componente desse alerta (ou o total da central); em Componente pode ser alargado a Todos os componentes da regra e da central, mas não restringido a outro componente.

Um silenciamento termina por si. Remova-o mais cedo com Remover — os alertas correspondentes voltam a ser notificados a partir da próxima avaliação, incluindo os disparados neste momento. Os silenciamentos são criados, editados e removidos por Administradores, Moderadores e pelas duas funções de Gestor de ativos.

Destinatários

Um destinatário recebe automaticamente cada alerta das regras a que está associado — um sistema de tickets, um canal de equipa ou uma caixa de correio partilhada. As pessoas não precisam de um destinatário; são, de qualquer forma, notificadas através das suas próprias definições. Dois tipos cria-os você mesmo, Webhook e E-mail; um comercializador direto configurado em Organização torna-se destinatário por si só — consulte Comercializador direto.

Abra Gestor de alertas ▸ Destinatários e clique em Novo destinatário Abrir no Mirox, e depois associe-o a regras em Destinatários no separador Notificação do editor de regras. Enviar teste entrega um alerta de exemplo — com uma comunicação de indisponibilidade de exemplo dentro — para que possa verificar a ligação e o seu modelo; um comercializador direto oferece em vez disso Testar início de sessão, que inicia sessão no serviço web do comercializador. Um destinatário pode ser editado depois a partir do menu da sua linha (Editar): o nome, os endereços ou o endereço e o modelo do webhook, e se a resolução também é enviada (Enviar também a resolução); só o seu tipo é fixo. Renovar o segredo de assinatura emite um novo segredo de webhook, mostrado uma única vez como na criação. Um destinatário desativado após falhas de entrega repetidas (etiqueta Desativado) é novamente ligado com Reativar. O destinatário de um comercializador direto é gerido em Organização ▸ Comercializadores diretos; no separador Destinatários oferece apenas Testar início de sessão e o seu interruptor de ativo. Na tabela de regras cada destinatário aparece como um chip; ao passar o rato vê o nome do destinatário e o modelo com que envia (um destinatário de e-mail sem modelo: Texto integrado).

E-mail

Uma lista de endereços de e-mail. Cada alerta e a sua resolução chegam como um e-mail.

Webhook

Um endereço HTTPS mais um modelo: o endereço recebe um POST por cada alerta e a sua resolução, com a forma que lhe dá o modelo do destinatário — o método, os cabeçalhos e o corpo. O destinatário recebe um dos modelos de webhook da sua organização — o diálogo lista-os, ao criar o destinatário e ao editá-lo; se ainda não existir nenhum, crie primeiro um em Modelos. Os exemplos aí cobrem Microsoft Teams, Slack e Discord, além do seu próprio JSON, XML e CSV: o exemplo JSON genérico (envelope assinado) — o alerta completo em JSON, veja abaixo — é a base para sistemas de tickets e para a sua própria automatização; Cartão do Microsoft Teams, Mensagem do Slack e Embed do Discord são mensagens já prontas para um webhook de entrada desses serviços, cujo endereço é então o endereço do destinatário (Slack hooks.slack.com/services/…, Discord discord.com/api/webhooks/…, Teams Workflows *.environment.api.powerplatform.com ou *.logic.azure.com — consulte Ligar o Microsoft Teams para saber como criar um). Um webhook do Teams Workflows recusa um cabeçalho Authorization — não adicione nenhum a um modelo para o Teams.

Ao criar um destinatário webhook, o seu segredo de assinatura é mostrado uma única vez. Cada pedido é assinado: traz o cabeçalho X-Mirox-Signature: sha256=<hex> — o HMAC-SHA256 do corpo bruto do pedido com esse segredo — mais X-Mirox-Timestamp e um X-Mirox-Delivery-Id único, juntamente com os cabeçalhos próprios do modelo, seja qual for o endereço. Verifique a assinatura antes de confiar num pedido e use o id de entrega para ignorar uma entrega repetida. Os serviços de chat como Teams, Slack e Discord simplesmente ignoram os cabeçalhos X-Mirox-*.

O corpo do modelo já pronto JSON genérico (envelope assinado):

{
  "version": "1",
  "status": "firing",
  "event_id": "1216448682925686786",
  "rule_uid": "A1B2C3D4E5F6",
  "rule_name": "Inverter without power",
  "rule_version": 3,
  "priority": "high",
  "park_uid": "0A1B2C3D4E5F",
  "park_name": "Plant North",
  "instance_key": "inverter_id=7",
  "labels": { "inverter_id": "7" },
  "component": "Inverter 7",
  "metric": "AC power per inverter",
  "value": 0.0,
  "unit": "W",
  "op": "lt",
  "threshold": 10.0,
  "condition_since": 1791200400,
  "title": "[FIRING] Inverter without power — Plant North (Inverter 7)",
  "body": "Inverter 7 delivers only 0 W (limit 10 W)",
  "link": "https://service.mirox.io/#/alertmanager?tab=alerts&alert=1216448682925686786",
  "sent_at": "2026-10-06T09:05:12+00:00"
}

status é firing ou resolved; uma resolução repete o alerta com o último valor avaliado. condition_since é um carimbo de data/hora Unix. Podem ser acrescentados campos em versões posteriores — ignore o que não conhecer. event_id é uma cadeia de caracteres — o identificador é mais longo do que um número JavaScript consegue representar com exatidão.

Após repetidas falhas de entrega, um destinatário é desativado e marcado como Desativado; verifique o endereço e, depois, reative-o com Reativar no menu da sua linha.

Que endereços a Mirox chama

A Mirox liga-se a um endereço de webhook apenas por HTTPS na porta 443, e apenas se o endereço corresponder a um endereço IP público. Outras portas (como 8443), http:// sem cifragem e endereços privados ou internos (10.x, 172.16–31.x, 192.168.x, localhost e semelhantes) são recusados. Se o seu endpoint escuta noutra porta ou só é acessível dentro da sua rede, coloque à frente um proxy inverso acessível publicamente na porta 443 — ou contacte o nosso suporte se isso não for possível.

Comercializador direto

Um comercializador direto configura-se uma única vez em Organização ▸ Comercializadores diretos Abrir no Mirox: um nome, o protocolo que fala — hoje a interface BWE de indisponibilidades; Pedir outro protocolo envia-nos o nome da norma que o seu comercializador usa —, os endereços do serviço web e de início de sessão, as credenciais emitidas pelo comercializador e as horas de antecedência com que quer receber uma indisponibilidade (2 por omissão, de 1 a 48). Cada linha termina com um menu …: Editar, Testar início de sessão, Destinatário no Gestor de alertas e Eliminar. Testar início de sessão inicia sessão no comercializador e mostra quantas centrais ele atribuiu à sua conta; nunca comunica uma indisponibilidade. Uma central eólica escolhe o comercializador através do qual vende na sua página Indisponibilidade — consulte Indisponibilidade e Comercializador Direto.

Que endereços a Mirox chama

A Mirox liga-se aos endereços do serviço web e de início de sessão do comercializador apenas por HTTPS na porta 443, e apenas se corresponderem a um endereço IP público. Outras portas (como 8443), http:// sem cifragem e endereços privados ou internos são recusados. Se o serviço do seu comercializador só for acessível noutra porta, peça-lhe um endereço na porta 443 — ou contacte o nosso suporte.

O comercializador torna-se automaticamente um único destinatário no Gestor de alertas, com o seu nome. Não pode ser criado a partir de Novo destinatário (esse diálogo só oferece webhook e e-mail) e nunca existe duas vezes; renomear ou desativar o comercializador reflete-se no destinatário, eliminar o comercializador remove-o, e configurá-lo de novo traz o destinatário de volta. No separador Destinatários a linha é só de leitura — Gerido em Organização ▸ Comercializadores diretos — exceto Testar início de sessão e o seu interruptor de ativo, ambos reservados a Administradores e Moderadores. Não tem modelo: o protocolo dita o que o comercializador recebe.

A regra comunica a indisponibilidade. Numa regra que vigia uma a uma as turbinas de uma central eólica (avaliada em cada componente de uma métrica de turbina), o separador Notificação oferece o interruptor Comunicar indisponibilidades. Com ele ligado, cada alerta de turbina ativo da regra é uma indisponibilidade dessa turbina desde o momento em que abre: um início, comunicado com as horas de antecedência; uma prorrogação cerca de cada metade dessas horas enquanto o alerta continuar ativo; e o fim, encurtado para o fim real, quando se resolve. Junto ao interruptor escolhe o motivo da indisponibilidade — Manutenção, Ordem administrativa, Operador de rede ou Comercializador direto — e a potência restante: Paragem total (0 kW) ou o valor medido, o valor de potência do alerta limitado à potência nominal da turbina, para uma regra sobre uma métrica de potência. Use Operador de rede e Comercializador direto apenas quando a origem da limitação for certa — contam como limitações compensadas na liquidação; os outros dois reduzem a disponibilidade da turbina. As horas de antecedência são as do comercializador da central quando a regra lhe comunica, caso contrário 2. O interruptor fica forçado e mostrado bloqueado enquanto o destinatário do comercializador estiver associado; uma regra avaliada sobre o total da central não o oferece e nunca é comunicada. Também uma central que outra organização partilha consigo por cooperação pode ser comunicada: cada organização comunica com as suas próprias regras e o seu próprio comercializador direto, independentemente do proprietário da central — a regra designa o comercializador pelo seu destinatário.

Cada destinatário da regra recebe os três momentos — início, prorrogação e fim — e nada mais: o seu próprio destinatário de e-mail ou webhook recebe-os renderizados pelo seu modelo com as variáveis outage.* (ou como texto integrado sem modelo), e o destinatário do comercializador recebe-os através do seu protocolo, enviados pelo agente da central. Uma regra que comunica indisponibilidades não envia ainda aos seus destinatários as mensagens habituais de disparo e resolução; as pessoas da sua organização são notificadas como sempre, e um teste de alertas nunca comunica uma indisponibilidade.

É assim que testa primeiro e muda depois: construa a regra com o seu próprio destinatário de e-mail ou webhook e veja início, prorrogação e fim chegarem à sua caixa de correio ou ao seu endpoint — exatamente o que o comercializador receberia. Quando estiver satisfeito, abra o separador Notificação da regra, retire o seu destinatário (ou mantenha-o) e adicione o destinatário do comercializador. Nada mais muda — a regra, o motivo, a potência restante e as horas de antecedência mantêm-se; a partir da passagem seguinte, a central comunica ao comercializador cada indisponibilidade aberta, desde o seu início original.

Que centrais chegam ao comercializador decorre das centrais: uma central comunica através do comercializador associado na sua página Indisponibilidade, pelo que o destinatário do comercializador comunica exatamente as centrais da regra associadas a ele. Para uma central associada a outro comercializador ou a nenhum, a indisponibilidade é registada no registo da central e enviada aos seus próprios destinatários, mas a nenhum comercializador — o editor de regras indica essas centrais no separador Notificação. Também diz quando o agente de uma central ainda precisa de uma atualização para as comunicações de indisponibilidade: até lá os destinatários da regra recebem o próprio alerta, como numa regra normal.

Os modelos do sistema para turbinas vêm com o interruptor ligado e associam o destinatário do seu comercializador quando os adota — consulte Exemplos. Na central, as indisponibilidades aparecem no registo Indisponibilidade como Comunicada por alarme, e o cartão Comunicado em direto por alarme no separador Comercializador direto da central lista cada regra que comunica a central — regra, motivo, potência restante, horas de antecedência e se chega ao comercializador — com a etiqueta Inativa para uma regra desativada.

O que foi entregue

Os detalhes de um alerta listam as suas Entregas: uma linha por destinatário e momento — disparo ou resolução numa regra normal, início, prorrogação ou fim numa comunicação de indisponibilidade — com a hora e se foi enviada, falhou (com o erro) ou foi ignorada, e porquê: um silenciamento, o destinatário desativado, resoluções não desejadas, a comunicação de indisponibilidade no lugar da mensagem de alerta ou — numa resolução — que o próprio alerta nunca chegou ao destinatário. Quando uma regra abre muitos alertas de uma vez (uma regra sobre cada uma de centenas de strings ao anoitecer), as suas notificações e mensagens a destinatários pausam após os quatro primeiros numa hora, durante 30 minutos, e as pessoas recebem em vez disso um resumo; um alerta que nunca foi enviado a um destinatário também não lhe envia uma resolução. No destinatário do comercializador a linha mostra o que a central comunicou e a janela que cobre. Quando um destinatário falha, a sua organização recebe o evento Destinatário com falhas, dirigido aos Admins e Moderadores e aos autores das regras que usam o destinatário; após dez entregas falhadas seguidas o destinatário é desativado (Destinatário desativado), e o evento fecha-se por si só assim que uma entrega volta a ter sucesso — corrija a causa e depois Reative o destinatário a partir do menu da sua linha. O destinatário do comercializador comunica da mesma forma o estado da ligação ao comercializador.

Modelos

Um modelo define exatamente o que um destinatário envia, para que cada sistema receba o formato que espera: num webhook o método (POST, PUT ou PATCH), seus próprios cabeçalhos e o corpo em JSON, XML, CSV, HTML, texto simples ou dados de formulário; num e-mail o assunto e o texto (texto simples ou seu próprio HTML). O destinatário de um comercializador direto não tem modelo — o seu protocolo dita a comunicação; o que uma regra que comunica indisponibilidades envia aos seus destinatários de e-mail e webhook é definido pelos modelos deles, com as variáveis outage.*. Você escreve texto fixo e insere variáveis do alerta, da regra, da usina e do componente. Um modelo é reutilizável: vários destinatários podem usar o mesmo, e uma alteração vale para todos de uma vez.

Abra Gestor de alertas ▸ Destinatários Abrir no Mirox: abaixo dos destinatários estão seus modelos e os exemplos para começar. Usar exemplo copia um para sua organização; Novo modelo começa vazio. Os modelos de webhook já prontos — o JSON genérico (envelope assinado) e as mensagens de chat para Microsoft Teams, Slack e Discord — iniciam-se a partir dos exemplos como qualquer outro; o diálogo do destinatário lista apenas os modelos da sua organização. O modelo abre no editor: à esquerda as configurações, os cabeçalhos e o corpo, no meio a lista de variáveis — um clique insere a variável no cursor — e à direita a pré-visualização ao vivo: a requisição ou o e-mail exatamente como seria enviado, com o alerta de exemplo ou um dos seus alertas recentes, com todos os erros e avisos. Depois escolha o modelo para um destinatário — ao criá-lo ou com o botão de modelo na sua linha. Um destinatário webhook envia sempre com um modelo; um destinatário de e-mail sem modelo envia o texto integrado.

A moldura de e-mail Mirox é uma escolha sua. Um modelo de e-mail de texto tem o interruptor Enviar dentro da moldura de e-mail Mirox (ligado por defeito): ligado, o seu texto é colocado no e-mail Mirox — cabeçalho, um botão para o alerta, rodapé e «mirox |» à frente do assunto; desligado, assunto e texto saem exatamente como gerados, sem nada acrescentado. Um modelo HTML é sempre enviado tal como está. A pré-visualização é sempre o e-mail tal como chega — com a moldura mostra o e-mail emoldurado completo — e oferece, ao lado do alerta de exemplo e dos seus alertas recentes, mais três fontes: uma comunicação de indisponibilidade de exemplo no início, na prorrogação e no fim, para verificar um modelo de uma regra que comunica indisponibilidades com todos os campos preenchidos. Sob a pré-visualização uma nota diz se o grupo de indisponibilidade mostrado foi comunicado pelo gémeo digital ou derivado do alerta, e que campos ficam vazios nesse caso.

Os modelos são criados, duplicados, alterados e eliminados por Administradores, Moderadores e pelas duas funções de Gestor de ativos; todos os membros podem vê-los. Um modelo marcado como Privado só é alterado pelo seu criador, por um Administrador ou por um Moderador — consulte Privado. Um modelo usado por um destinatário não pode ser excluído — escolha antes outro para esse destinatário.

A linguagem dos modelos

EscrevaSignificado
Variável: {{plant.name}}o valor, p. ex. o nome da usina
Filtro: {{alert.since|date:"DD.MM.YYYY HH:mm"}}o valor, formatado
Seção: {{#alert.firing}}…{{/alert.firing}}a parte entre elas só quando o valor existe — numa lista, uma vez por item
Seção invertida: {{^component.name}}…{{/component.name}}a parte entre elas só quando o valor está vazio
Comentário: {{! … }}nada — uma nota para você
Chaves literais: \{{{{ como texto

Dentro de uma seção de lista estão disponíveis {{@index}} (a partir de 0), {{@number}} (a partir de 1), {{@first}} e {{@last}} — por exemplo {{^@last}},{{/@last}} coloca uma vírgula entre os itens. Uma variável inexistente fica vazia e a pré-visualização a mostra como aviso. Nada é executado num modelo; ele só produz texto.

Variáveis

VariávelSignificado
{{alert.id}}ID do alerta (texto)
{{alert.status}}firing (disparado) ou resolved (resolvido)
{{alert.firing}}Verdadeiro enquanto o alerta está disparado (use como seção)
{{alert.resolved}}Verdadeiro no aviso de resolução
{{alert.level}}Nível: very_low, low, normal, high, very_high, critical
{{alert.title}}O título pronto de uma linha
{{alert.text}}A mensagem pronta de uma linha
{{alert.summary}}O resumo da própria regra, se houver
{{alert.value}}O valor avaliado (o último na resolução)
{{alert.value_label}}O valor com unidade, como no Mirox
{{alert.value_kw}}O valor em kW — só para uma métrica de potência (W, kW, MW)
{{alert.unit}}A unidade da métrica
{{alert.threshold}}O limite da regra
{{alert.threshold_label}}O limite com unidade
{{alert.threshold_kw}}O limite em kW — só para uma métrica de potência
{{alert.op}}Comparação: gt, ge, lt, le, eq, ne
{{alert.op_symbol}}A comparação como símbolo
{{alert.since}}Desde quando a condição vale
{{alert.until}}Quando o alerta foi resolvido (vazio enquanto disparado)
{{alert.duration_s}}Segundos do início ao fim (ou até agora)
{{alert.close_reason}}Motivo da resolução: condition, rule_disabled, …
{{alert.silenced}}Verdadeiro quando um silêncio se aplicou
{{alert.link}}Link absoluto para o alerta no Mirox
{{alert.instance_key}}A instância do alerta (rótulos)
{{rule.uid}}ID da regra
{{rule.name}}Nome da regra
{{rule.description}}Descrição da regra
{{rule.version}}Versão da regra
{{rule.window_s}}Janela da regra em segundos
{{rule.for_s}}Quanto tempo a condição deve valer, em segundos
{{rule.metric.name}}Nome da métrica
{{rule.metric.unit}}Unidade da métrica
{{plant.uid}}ID da usina
{{plant.name}}Nome da usina
{{plant.type}}Tipo: solar, wind, battery
{{plant.timezone}}Fuso horário da usina (padrão para datas)
{{plant.peak_power_kw}}Potência de pico instalada em kWp
{{plant.grid_limit_kw}}Limite de conexão à rede em kW, se definido
{{plant.inverter_limit_kw}}Limite de potência dos inversores em kW, se definido
{{plant.latitude}}Latitude
{{plant.longitude}}Longitude
{{plant.portfolio.uid}}ID do portfólio
{{plant.portfolio.name}}Nome do portfólio
{{plant.address.street}}Rua (linha 1)
{{plant.address.street2}}Linha 2 do endereço
{{plant.address.zip}}CEP
{{plant.address.city}}Cidade
{{plant.address.state}}Estado / região
{{plant.address.country}}País
{{plant.grid_operator}}Operador da rede, se informado
{{plant.project_company}}Empresa do projeto, se informada
{{plant.market_zone}}Zona de mercado, se informada
{{plant.commissioning_date}}Data de comissionamento, se informada
{{component.name}}Nome do componente (vazio em regras da usina)
{{component.id}}ID do componente no Mirox, se conhecido
{{component.kind}}Tipo de componente (inverter, string, …)
{{component.labels}}Os rótulos do componente como objeto
{{component.labels_list}}Os rótulos como lista de {name, value} para uma seção
{{organization.uid}}ID da organização
{{organization.name}}Nome da organização
{{delivery.id}}ID único desta entrega
{{delivery.receiver}}Nome do destinatário
{{delivery.test}}Verdadeiro num envio de teste
{{now}}O momento do envio

Cada entrega transporta o grupo outage, e ele nunca está vazio. Num alerta normal é derivado do próprio alerta: a unidade é o componente do alerta (uma turbina), begin é o primeiro momento em que a condição se verificou, end a resolução, o motivo e a potência restante vêm das definições de indisponibilidade da regra — e outage.reported é falso. Numa regra que comunica indisponibilidades o gémeo digital da central assume e comunica a indisponibilidade: uma janela antecipada, prorrogada enquanto o alerta continua ativo, terminada na resolução — só então reported, renewed, reported_until, horizon_hours, marketer.name e register_link são preenchidos; num alerta normal ficam vazios ou falsos. {{#outage.reported}}…{{/outage.reported}} distingue os dois casos num só modelo. O número de série, a chave de instalação e a potência nominal são dados mestre da central e ficam vazios onde nada foi registado. O editor de regras avisa quando um modelo dos seus destinatários lê um campo que só uma indisponibilidade comunicada preenche numa regra que não comunica:

VariávelSignificado
{{outage.reported}}Verdadeiro quando o gémeo digital da central comunicou este momento como indisponibilidade (regra com comunicação); falso quando o grupo deriva apenas do alerta
{{outage.moment}}O que esta entrega anuncia: start (alerta disparado), renewal (janela comunicada prorrogada — só indisponibilidades comunicadas) ou end (alerta resolvido)
{{outage.started}}, {{outage.renewed}}, {{outage.ended}}Verdadeiro nesse momento (use como secções)
{{outage.begin}}Início da indisponibilidade
{{outage.end}}O fim real depois de o alerta ser resolvido (vazio antes)
{{outage.reported_until}}Fim da janela comunicada até agora — prorrogada antes de expirar (só indisponibilidades comunicadas; vazio num alerta normal)
{{outage.horizon_hours}}Com quantas horas de antecedência a indisponibilidade é comunicada (só indisponibilidades comunicadas; vazio num alerta normal)
{{outage.reason}}Código do motivo: ADMINISTRATIVE, MAINTENANCE, GRID, MARKET
{{outage.reason_label}}O motivo por palavras (inglês)
{{outage.available_power_kw}}Potência restante da turbina em kW (0 = paragem total)
{{outage.comment}}O comentário da comunicação (o nome da regra)
{{outage.marketer.name}}O comercializador direto a que a regra comunica pelo seu destinatário comercializador (vazio num alerta normal ou num ensaio sem comercializador)
{{outage.unit.name}}, {{outage.unit.id}}Nome e ID da turbina
{{outage.unit.serialnumber}}, {{outage.unit.manufacturer_id}}, {{outage.unit.plant_key}}Número de série, ID do fabricante e chave de instalação dos dados mestre, se informados
{{outage.unit.rated_kw}}Potência nominal da turbina em kW
{{outage.register_link}}Link para o registo de indisponibilidades da central no Mirox

As datas aparecem no fuso horário da usina, salvo se o filtro date indicar outro. A usina não tem campo para um número MaStR nem para uma localização de mercado — escreva esses identificadores como texto fixo no modelo.

Os filtros seguem a variável após | e podem ser encadeados, por exemplo {{alert.value|kw|number:1:de}}:

FiltroSignificado
date:"DD.MM.YYYY HH:mm":"Europe/Berlin"Data e hora: iso (padrão), unix, unix_ms, rfc2822 ou um padrão de YYYY YY MM DD HH mm ss Z ZZ. O fuso é opcional; sem ele vale o da usina.
number:1:deUm número como texto com as casas decimais indicadas (padrão 2) e os separadores de en, de, fr, es, it, pt ou plain.
round:1Arredonda e continua um número (em JSON sem aspas).
kwDivide por 1.000 ou 1.000.000 (W em kW ou MW).
upperMaiúsculas, minúsculas, sem espaços ao redor.
truncate:120No máximo n caracteres.
default:"—"Este texto se o valor estiver vazio.
yesno:"yes":"no"Um texto se houver valor, outro se estiver vazio.
jsonO valor como texto JSON, incluindo objetos e listas.

Formatos e escape

O tipo de conteúdo do modelo decide como um valor é inserido, para que um nome de usina com aspas ou um «&» nunca quebre o resultado:

  • JSON — dentro de uma string ("plant": "{{plant.name}}") o valor é escapado como texto; fora dela ("value": {{alert.value}}) vira um valor JSON: um número continua número, texto recebe aspas, um valor vazio vira null, objetos e listas são escritos como JSON.
  • XML e HTML — <, >, & e aspas são escapados.
  • CSV — um campo vai entre aspas quando contém o separador, uma aspa ou uma quebra de linha; num campo que o modelo já coloca entre aspas, as aspas são duplicadas. O separador é o que seu modelo usa (vírgula, ponto e vírgula, tabulação).
  • Dados de formulário — os valores são codificados como URL.
  • Texto simples — como está.

Valores de cabeçalho e o assunto do e-mail nunca contêm quebra de linha. O modelo é verificado ao salvar: deve estar completo (cada seção fechada, cada filtro conhecido), ter no máximo 64 KiB e, para JSON e XML, o resultado com o alerta de exemplo deve ser válido. Cabeçalhos: no máximo 30, apenas nomes padrão. Content-Type segue o formato; Content-Length, Host e os cabeçalhos X-Mirox-* são definidos pelo Mirox e não podem ser substituídos. Todo pedido webhook continua assinado: X-Mirox-Signature é o HMAC-SHA256 exatamente do corpo que seu modelo produziu.

Exemplos

Cada exemplo é um ponto de partida que você copia e adapta:

  • JSON genérico (envelope assinado) — O envelope de alerta documentado do Mirox — base para sistemas de tickets.
  • Cartão do Microsoft Teams — Um Adaptive Card para um webhook do Teams Workflows.
  • Mensagem do Slack — Mensagem Block Kit para um webhook de entrada do Slack.
  • Embed do Discord — Um embed colorido para um webhook de canal do Discord.
  • Documento XML — O alerta como documento XML.
  • Linha CSV — Um cabeçalho e uma linha por alerta, separados por vírgulas.
  • E-mail de texto — Um e-mail de texto compacto com os dados principais, na moldura de e-mail Mirox (desligue a moldura para enviar só o texto).
  • E-mail HTML — Seu próprio e-mail HTML com tabela de dados.
  • Aviso a um comercializador direto sem a interface BWE (CSV) — Uma linha CSV em alemão por comunicação — início, prorrogação ou fim da indisponibilidade de uma turbina — com a identidade da turbina, a janela, a potência restante e o motivo da regra; para um destinatário webhook, a adaptar à especificação do comercializador.
  • Aviso a um comercializador direto sem a interface BWE (e-mail) — A mesma comunicação como e-mail em alemão, para um destinatário de e-mail — adapte-o ao que o comercializador exige.

Inicie os exemplos de webhook como qualquer outro e escolha depois a cópia para um destinatário — o diálogo do destinatário lista apenas os modelos da sua organização.

Os dois avisos de indisponibilidade (em alemão) são modelos para uma regra que comunica indisponibilidades: renderizam o grupo outage — o momento, o nome, ID, número de série e chave de instalação da turbina, início, fim e a janela comunicada até agora, potência nominal e restante, motivo e comentário. Servem um comercializador sem a interface BWE, alcançado por um destinatário webhook ou de e-mail, e a sua própria caixa de correio enquanto ensaia uma regra antes de associar o destinatário do comercializador. Não há formato obrigatório para esse aviso; adapte colunas e texto ao que o seu comercializador direto exige e preencha o número MaStR e a localização de mercado como texto fixo.

Um modelo para um sistema de tickets que espera XML:

<ticket priority="{{alert.level}}">
  <title>{{alert.title}}</title>
  <site id="{{plant.uid}}">{{plant.name}}</site>
  {{#component.name}}<asset>{{component.name}}</asset>{{/component.name}}
  <opened>{{alert.since|date:"iso"}}</opened>
  <link>{{alert.link}}</link>
</ticket>

Testar os alertas

Um teste mostra todo o percurso de um alerta numa das suas centrais — sem esperar por um problema real e sem tocar nos dados da central. Abra Gestor de alertas ▸ Visão geral e clique em Testar alertas Abrir no Mirox; depois escolha a central, o nível do alerta de teste (até Crítico) e, opcionalmente, destinatários.

A plataforma escreve então um sinal de teste fixo para essa central: calmo durante 5 minutos, acima do limiar durante 15 minutos e calmo de novo. O agente da central avalia-o como qualquer uma das suas regras, por isso:

  1. cerca de 5–10 minutos após o início abre-se o alerta de teste, no nível escolhido;
  2. só a pessoa que iniciou o teste é notificada — na app, por push e por e-mail, segundo as suas próprias definições — e os destinatários escolhidos também o recebem; mais ninguém na organização é avisado;
  3. cerca de 15 minutos depois resolve-se sozinho, com o seu aviso de resolução.

A página acompanha o teste passo a passo e indica quem o iniciou. Um teste termina sozinho após cerca de 30 minutos, ou antes com Parar; o seu alerta fica no histórico. Os testes nunca aparecem entre as suas regras e os dados de teste só são escritos enquanto um teste está ativo. Os testes são iniciados por Admins e Moderadores; podem decorrer até três em simultâneo.

Páginas Relacionadas

  • Visão geral do Gestor de alertas
  • Regras de Alerta
  • Definições de Notificação
Prev
Regras de Alerta
Next
Exemplos
© 2026 Mirox Verwaltungs GmbH. Todos os direitos reservados. | Política de Privacidade