ZoomDH – Universal Notifier v20261023
Visão geral
O ZoomDH Universal Notifier é a central de notificações dos drivers ZoomDH. Fechaduras, alarmes, sensores e outros drivers ZoomDH avisam os seus eventos para ele, e o Notifier envia para os canais escolhidos:
- Push Control4 (app Control4 do cliente)
- WhatsApp (TextMeBot, Whapi.Cloud ou CallMeBot)
- Telegram (bot próprio do cliente)
- Webhook (para Home Assistant, n8n e outros serviços)
Cada notificação tem uma gravidade: Crítico (fechadura travada, equipamento sem comunicação, alarme), Alerta (bateria baixa, porta aberta) ou Informativo (fechadura aberta ou trancada). O cliente escolhe, numa tela no Navigator, o que vai para cada canal. Há também horário de silêncio, pausa e proteção contra avisos repetidos.
O driver é gratuito e um único Notifier atende todos os drivers ZoomDH do projeto.
Pré-requisitos
- Um ou mais drivers ZoomDH com a conexão Notifier (ex.: ZoomDH Tedee Bridge, ZoomDH Yale Connect).
- Para push: agente Push Notification do Control4 no projeto e cliente com o app Control4.
- Para e-mail: agente Email Notification do Control4 configurado no projeto.
- Para WhatsApp: conta em um dos serviços suportados (TextMeBot, Whapi.Cloud ou CallMeBot) e a chave de acesso.
- Para Telegram: um bot criado no Telegram (@BotFather) e o ID das conversas que vão receber.
- Internet no controlador para WhatsApp, Telegram e webhook.
Instalação
- Adicione o driver ZoomDH – Universal Notifier ao projeto no Composer Pro (um por projeto).
- Na aba Connections, ligue a conexão Notifier de cada driver ZoomDH à conexão Notifications do Universal Notifier. Vários drivers podem ser ligados na mesma conexão.
- Nas propriedades, preencha Home Name (aparece no início de cada aviso) e ligue os canais desejados (veja Configurando os canais).
- Rode a ação Send Test Notification para conferir se os canais recebem.
- Habilite a interface no Navigator: selecione o room → aba Navigator → Menu Settings → marque ZoomDH Universal Notifier como Visible na experiência desejada (ex.: Security).
Cada driver ligado aparece na interface, com a lista de eventos que ele pode gerar, alguns segundos depois de ligado. Se não aparecer, rode a ação Refresh Connected Drivers.
Como as notificações são escolhidas
A escolha acontece em dois lugares:
- No próprio driver de origem (ex.: a fechadura). Na tela de ajustes do driver, ou na propriedade Send Notifications, o cliente escolhe se o driver avisa todos os eventos (cada abertura e fechamento), só alertas (padrão: críticos e alertas) ou nada, e pode ligar ou desligar cada evento.
- No Universal Notifier, que decide para quais canais cada evento vai.
No Notifier, cada aviso passa por estas regras, nesta ordem:
| Regra | O que faz |
|---|---|
| Pausa | Com as notificações pausadas nada é enviado, mas tudo fica no histórico. |
| Driver desligado | Um driver pode ser desligado inteiro na tela O que enviar. |
| Não repetir | O mesmo evento do mesmo equipamento não é enviado de novo dentro do tempo escolhido (padrão 10 min). |
| Horário de silêncio | No período escolhido só passam os críticos (se permitido). |
| Canal | Para cada canal vale a escolha feita para aquele evento (sempre ou nunca). Sem escolha (automático), vale a gravidade mínima do canal, definida no Composer. |
Interface no Navigator
Toque no ícone do Notifier no Navigator (touchscreen, app iOS/Android). A tela tem três abas e os idiomas PT / EN / ES.
Na aba O que enviar, um evento desligado no próprio driver de origem aparece com o aviso Desligado no próprio driver: para recebê-lo, ligue-o na tela de ajustes daquele driver.
Configurando os canais
Push Control4
Ligado por padrão. Usa o agente Push Notification do projeto: adicione o agente e os usuários no Composer. Gravidade mínima padrão: alertas e críticos.
Configure o agente Email Notification do Control4 (servidor de envio). No Notifier, ligue Email Enabled e preencha Email Recipients com um ou mais endereços separados por vírgula.
- TextMeBot: crie a conta em textmebot.com, autorize o número que envia e copie a API key.
- Whapi.Cloud: crie um canal em whapi.cloud, conecte o WhatsApp que envia e copie o token.
- CallMeBot: gratuito, mas a chave vale para um número só (o primeiro da lista).
Ligue WhatsApp Enabled, escolha o WhatsApp Service, cole a chave em WhatsApp API Key e preencha WhatsApp Numbers com DDI e DDD (ex.: 5551999998888), separados por vírgula. As mensagens saem com alguns segundos de intervalo, como exigem os serviços.
Telegram
Crie um bot com o @BotFather e copie o token para Telegram Bot Token. Cada pessoa (ou grupo) precisa mandar uma mensagem para o bot antes; depois coloque o ID da conversa em Telegram Chat IDs (vários separados por vírgula).
Webhook
Preencha Webhook URL com o endereço que vai receber os avisos. Cada aviso é enviado com casa, gravidade, título, mensagem, origem e data/hora.
Propriedades
| Propriedade | Descrição |
|---|---|
| Driver Information | Mensagens do driver, como falhas de envio de um canal. |
| Log Level / Log Mode | Nível de detalhe e destino do log. |
| Status | Active ou Paused. |
| Connected Drivers | Quantos drivers estão ligados ao Notifier. |
| Last Notification | Data, hora e título do último aviso recebido. |
| Push Agent / Email Agent | OK quando o agente Push Notification ou Email Notification foi encontrado no projeto; Not found quando falta adicionar o agente. |
| Home Name | Nome que aparece no início de cada aviso (ex.: Casa Praia - Fechadura travada). |
| Repeat Suppression (min) | Tempo (0–120 min) em que o mesmo evento do mesmo equipamento não é enviado de novo. 0 desliga. Padrão: 10. |
| Quiet Hours, Quiet Hours Start, Quiet Hours End | Horário de silêncio (formato HH:MM, pode atravessar a meia-noite). |
| Critical During Quiet Hours | Se os críticos são enviados mesmo no horário de silêncio. Padrão: Yes. |
| Push Enabled / Push Minimum Severity | Liga o push do Control4 e a gravidade mínima no modo automático. |
| Email Enabled, Email Recipients, Email Minimum Severity | E-mail: destinatários separados por vírgula. |
| WhatsApp Enabled, WhatsApp Service, WhatsApp API Key, WhatsApp Numbers, WhatsApp Minimum Severity | WhatsApp: serviço, chave e números. |
| Telegram Enabled, Telegram Bot Token, Telegram Chat IDs, Telegram Minimum Severity | Telegram: token do bot e conversas. |
| Webhook Enabled, Webhook URL, Webhook Minimum Severity | Webhook: endereço de destino. |
Gravidade mínima: Critical Only (só críticos), Warning and Critical (alertas e críticos) ou All (tudo). O horário de silêncio e o tempo para não repetir também podem ser mudados pelo cliente na interface.
Ações
| Ação | Descrição |
|---|---|
| Send Test Notification | Envia um aviso de teste (crítico) para todos os canais ligados. |
| Refresh Connected Drivers | Pede de novo a lista de eventos a todos os drivers ligados. |
| Forget Disconnected Drivers | Remove da interface os drivers que não estão mais ligados, junto com as escolhas feitas para eles. |
| Clear History | Apaga o histórico de notificações. |
Comandos, conexões e eventos
Comandos de programação
| Comando | Descrição |
|---|---|
| Send Notification | Envia um aviso próprio da programação, com gravidade (Critical, Warning ou Info), título e mensagem. Aparece na interface como Programação e segue as mesmas regras. |
| Pause Notifications / Resume Notifications | Pausa e retoma os envios (ex.: pausar quando a família está em casa). |
Conexões
| Conexão | Descrição |
|---|---|
| Notifications | Recebe a conexão Notifier dos drivers ZoomDH. Aceita vários drivers. |
Eventos
| Evento | Quando dispara |
|---|---|
| Notification Received | Chegou qualquer aviso (mesmo pausado ou filtrado). |
| Critical Notification | Chegou um aviso crítico. |
Variáveis: LAST_TITLE, LAST_MESSAGE, LAST_SEVERITY e PAUSED, para usar na programação.
Solução de problemas
| Sintoma | O que verificar |
|---|---|
| Driver ligado não aparece em O que enviar | Confira a conexão na aba Connections e rode Refresh Connected Drivers. O driver de origem precisa estar na versão com suporte ao Notifier. |
| Aviso aparece no histórico como Nenhum canal | Nenhum canal ligado aceita aquela gravidade. Baixe a gravidade mínima do canal ou marque sempre no evento. |
| Abertura e fechamento não chegam | Por padrão os drivers avisam só alertas. Na tela de ajustes do driver da fechadura, escolha todos os eventos ou ligue o evento desejado. |
| Push não chega | Confira o agente Push Notification no projeto e se o usuário tem o app Control4 com notificações permitidas. |
| WhatsApp ou Telegram com Falhou nos Ajustes | Confira a chave ou token e os números. No Telegram, a pessoa precisa ter mandado uma mensagem para o bot antes. |
Licenciamento
O ZoomDH Universal Notifier é gratuito para uso com os drivers ZOOM e não precisa de licença própria: ele só envia quando há pelo menos um driver ZOOM licenciado (ou em período de teste) ligado na conexão Notifications. Sem isso, o status mostra "Waiting for a licensed ZOOM driver" e o histórico registra os avisos como "Sem driver ZOOM". Os drivers de origem seguem com a licença própria de cada um. Os serviços de WhatsApp podem cobrar à parte, conforme o plano contratado pelo cliente.
Suporte e Atualizações
- Site: www.zoomdigitalhome.com.br
- Suporte: drivers@zoomdigitalhome.com.br
Release Notes
| Versão | Data | Descrição |
|---|---|---|
| 20261023 | 23/10/2026 | Versão inicial: push Control4, e-mail, WhatsApp, Telegram e webhook; escolha por evento e por canal na interface do Navigator (PT/EN/ES); horário de silêncio, pausa, proteção contra avisos repetidos e histórico. Substitui o driver ZoomDH WhatsApp Message. |