ZOOM – WhatsApp AI v20261113
Visão geral
Com o ZOOM WhatsApp AI o morador conversa com a casa pelo WhatsApp, escrevendo do jeito que falaria com uma pessoa:
- "Apaga tudo da sala e liga o ar do quarto em 22"
- "A porta da frente está trancada?" ou "Qual a temperatura da varanda?"
- "Ativa a cena Cinema" ou "Fecha as persianas do quarto"
- "Abre o portão" (o assistente pede um SIM antes)
Um assistente de inteligência artificial entende o pedido, escolhe os itens certos da casa e o controlador executa. Os moradores falam com o número oficial de WhatsApp da ZOOM: não precisa de chip na casa, de conta em outro serviço nem de abrir portas no roteador.
A casa também pode mandar avisos para os moradores pelo mesmo número (alarme, porta aberta, vazamento), pela programação do Composer.
Pré-requisitos
- Controlador Control4 com OS 3.0 ou superior e acesso à internet.
- Celular de cada morador com WhatsApp.
- Plano de mensagens ativo (o primeiro ano já vem com a licença; veja Plano de mensagens).
Instalação
- Adicione o driver ZOOM – WhatsApp AI ao projeto.
- Insira a chave em License Key (o driver tem 30 dias de teste, com até 100 mensagens por mês).
- Em Authorized Phones, cadastre os moradores no formato
Nome: celular, separados por ponto e vírgula. Exemplo:Fabiano: 51 99999-1234; Maria: 51 98888-7777. Números do Brasil podem ir sem o 55. - Escolha o que o assistente pode usar em Lights, Shades, Thermostats, Relays, Locks, Sensors e Rooms. O assistente só vê e só controla o que estiver marcado.
- Se quiser, dê um nome para a casa em House Name e cadastre comandos personalizados.
- Confira em Connection Status se aparece Conectado e em Devices Available quantos itens foram liberados.
- Peça para cada morador ativar o celular.
Ativar o celular do morador
Ao salvar Authorized Phones, cada morador novo recebe no WhatsApp um convite da ZOOM com o botão Ativar. Basta tocar no botão uma única vez: o assistente responde confirmando, e a partir daí o celular controla a casa. A ação Send Activation Invites manda o convite de novo para quem ainda não ativou.
Se o convite não chegar, há outros dois jeitos. A property Activation Link traz um link para mandar ao morador por qualquer meio: ele abre o WhatsApp da ZOOM com a mensagem de ativação pronta, é só enviar. Ou o morador escreve a mensagem da property Activation Code (por exemplo ativar 482913) para o WhatsApp da ZOOM, +55 51 98537-0863.
- Phones Status mostra quem já ativou (✓) e quem ainda falta.
- Só celulares cadastrados em Authorized Phones conseguem ativar. Tirar um número da lista corta o acesso na hora.
- A ação New Activation Code gera um código novo (o antigo deixa de valer; quem já ativou continua ativo).
O que o morador pode pedir
| Item | Exemplos |
|---|---|
| Luzes | acender, apagar, dimerizar ("deixa a sala em 30%"), consultar |
| Persianas e cortinas | abrir, fechar, parar, posição |
| Ar-condicionado e termostatos | ligar em uma temperatura, trocar o modo, desligar, consultar temperatura |
| Portões e relés | abrir, fechar, pulso (com confirmação) |
| Fechaduras | trancar, destrancar (com confirmação), consultar |
| Sensores | consultar ("a janela do quarto está aberta?") |
| Ambientes | desligar, volume, mudo, escolher o que assistir ou ouvir |
| Cenas de iluminação | ativar e desativar as cenas da Iluminação Avançada |
| Comandos personalizados | qualquer coisa que o integrador programar |
Dá para pedir várias coisas na mesma mensagem. O assistente responde no idioma em que o morador escreveu e não conversa sobre outros assuntos. Também entende mensagens de voz: a resposta começa com o que ele entendeu, para o morador conferir.
Agendamentos pelo WhatsApp
O morador também pode pedir para depois:
- "Desliga o ar do quarto daqui a 1 hora" ou "Às 22h apaga as luzes da sala"
- "Toda segunda às 7h abre as persianas" ou "Acende a varanda no pôr do sol"
- "O que está agendado?" e "Cancela o agendamento da varanda"
Com o ZOOM Universal Scheduler no projeto, ligue a conexão Scheduler deste driver à conexão WhatsApp AI do Scheduler (a ligação é automática quando os dois estão no projeto). Os agendamentos pedidos pelo WhatsApp aparecem na tela do Scheduler no Navigator, com o nome de quem pediu, e podem repetir (dias da semana) ou seguir o nascer e o pôr do sol. Os de uma vez só somem da lista depois de rodar. Cancelar pelo WhatsApp apaga os que foram criados pelo WhatsApp; os criados na tela ou pelo integrador só são desligados.
Sem o Scheduler, o assistente aceita só pedidos de uma vez ("daqui a 30 minutos", "amanhã às 7h"), até 7 dias à frente. Para repetir ou usar o sol, ele explica que é preciso o Universal Scheduler. Se o controlador estiver desligado na hora, o pedido não roda e fica registrado no histórico.
Agendar portão, relé ou fechadura também pede SIM na hora de agendar. Na hora de rodar, o driver usa os itens liberados aqui: se um item deixou de ser liberado, a ação não roda e fica registrada.
Histórico e avisos do que foi feito
Tudo o que é feito pelo WhatsApp fica registrado com o nome de quem pediu, para tirar dúvidas como "quem abriu o portão?" ou "por que a luz acendeu sozinha?":
- A ação Show History mostra na aba Lua as últimas 100 ações: comandos, agendamentos criados e cancelados, ações agendadas executadas ou não executadas, e os pedidos de uma vez esperando a hora.
- No Universal Scheduler, o histórico mostra quem criou, mudou, cancelou ou desligou cada agendamento, pela tela ou pelo WhatsApp.
- Com o Universal Notifier, essas ações viram avisos: portão, relé e fechadura como alerta; os demais comandos e agendamentos como informativo (para recebê-los, use Send Notifications em All Events).
Segurança e confirmações
- Só celulares cadastrados e ativados falam com a casa.
- O assistente só enxerga os itens liberados pelo integrador.
- Abrir portão, acionar relé e destrancar fechadura só acontecem depois que o morador responde SIM (vale por 3 minutos). A property Confirm Before também pode incluir os termostatos ou desligar a confirmação.
Comandos personalizados
Use Custom Command 1 a 8 para dar nome a ações que você programa no Composer, como Abrir portão social, Ligar irrigação ou Modo viagem. Quando o morador pedir, o driver dispara o evento Custom Command N correspondente e grava o nome na variável LAST_CUSTOM_COMMAND. Com Custom Commands Confirmation em Yes, esses comandos também pedem SIM.
Avisos pela programação
O comando Send Message manda um aviso pelo WhatsApp. Em To, use All para todos os moradores ativados ou o nome cadastrado de um morador. Use em alarmes, porta esquecida aberta, vazamento, campainha etc.
Avisos continuam chegando mesmo quando o limite de mensagens do mês acaba (com uma pequena margem), para o morador não ficar sem alertas de segurança.
Universal Notifier
Ligue a conexão Notifier ao ZOOM Universal Notifier (driver gratuito). A ligação funciona nos dois sentidos:
- Avisos dos drivers ZOOM pelo número oficial: no Notifier, escolha ZOOM WhatsApp AI em WhatsApp Service. Fechaduras, alarmes e outros drivers ZOOM passam a avisar os moradores ativados por este número, sem conta em outro serviço e sem chave. Deixe WhatsApp Numbers do Notifier vazio para enviar a todos, ou coloque nomes ou números de moradores. Esses avisos contam no plano de mensagens.
- Avisos do WhatsApp AI para o integrador: ações feitas pelo WhatsApp (veja Histórico), plano vencendo ou vencido, limite do mês e serviço fora do ar (depois de 10 minutos) vão para o Notifier, que envia pelos canais escolhidos lá (push, e-mail etc.). Esses avisos não são mandados aos moradores pelo WhatsApp. A property Send Notifications escolhe o que sai: todos, só alertas ou nada.
Plano de mensagens
O driver usa o serviço de WhatsApp e de inteligência artificial da ZOOM. A licença inclui 12 meses de serviço com até 300 mensagens por mês por casa (cerca de 10 por dia, somando respostas e avisos). Depois disso, o serviço é renovado por ano com a ZOOM: a renovação estende a validade da licença e a casa atualiza sozinha em até 12 horas, sem reinstalar nem mexer no projeto.
- Monthly Usage mostra o uso do mês e Plan Valid Until a validade do plano.
- Os moradores recebem um aviso quando o uso passa de 80%, 90% e 95%, e o driver dispara os eventos Quota Warning e Quota Exceeded.
- 30 e 7 dias antes de o plano vencer, Plan Valid Until mostra quantos dias faltam e o driver dispara o evento Plan Expiring; no vencimento, Plan Expired.
- Com o limite atingido ou o plano vencido, o assistente para de responder pedidos, mas os avisos da casa continuam por um tempo.
Propriedades
| Propriedade | Descrição |
|---|---|
| License Key | Chave de licença do driver. |
| License Status | Status da licença. |
| Log Level / Log Mode | Detalhe e destino do log. |
| Send Notifications | O que vai para o Universal Notifier: All Events, Alerts Only ou Off. |
| Language | Idioma das mensagens do driver (o assistente responde no idioma do morador). |
| Connection Status | Conexão com o serviço da ZOOM. |
| Authorized Phones | Moradores que podem usar o assistente: Nome: celular; Nome: celular. |
| Activation Code | Mensagem de ativação, para o morador escrever no WhatsApp da ZOOM (+55 51 98537-0863). |
| Activation Link | Link para mandar ao morador: abre o WhatsApp da ZOOM com a mensagem de ativação pronta. |
| Phones Status | Moradores cadastrados e quem já ativou. |
| Monthly Usage | Mensagens usadas no mês / limite do plano. |
| Plan Valid Until | Validade do plano de mensagens. |
| House Name | Nome da casa usado pelo assistente (opcional). |
| Lights, Shades, Thermostats, Relays, Locks, Sensors, Rooms | Itens que o assistente pode ver e controlar. |
| Lighting Scenes | Show libera as cenas da Iluminação Avançada. |
| Temperature Scale | Celsius ou Fahrenheit. |
| Confirm Before | Quais ações pedem SIM: fechaduras e relés (padrão), também termostatos, ou nunca. |
| Custom Command 1–8 | Nomes dos comandos personalizados. |
| Custom Commands Confirmation | Se os comandos personalizados pedem SIM. |
| Devices Available | Quantidade de itens liberados para o assistente. |
| Relay URL | Deixe em branco. |
Ações
| Ação | Descrição |
|---|---|
| New Activation Code | Gera um código de ativação novo. |
| Send Activation Invites | Manda de novo o convite com o botão Ativar para os moradores que ainda não ativaram. |
| Refresh Devices | Relê os itens, ambientes e cenas do projeto. |
| Send Test Message | Manda uma mensagem de teste para todos os moradores ativados. |
| Reconnect | Reconecta ao serviço da ZOOM. |
| Show Catalog | Mostra na aba Lua os itens que o assistente enxerga. |
| Show History | Mostra na aba Lua o que foi feito pelo WhatsApp e por quem. |
Comandos, eventos e variáveis
Comando: Send Message (To, Message).
Conexões: Notifier (ZOOM Universal Notifier) e Scheduler (ZOOM Universal Scheduler).
Eventos: Message Received, Command Executed, Quota Warning, Quota Exceeded, Plan Expiring, Plan Expired, Scheduled Action Executed, Service Online, Service Offline, Custom Command 1–8.
Variáveis: LAST_MESSAGE, LAST_SENDER, LAST_ACTION, LAST_CUSTOM_COMMAND, RELAY_ONLINE, MONTHLY_USAGE.
Solução de problemas
| Situação | O que fazer |
|---|---|
| O morador manda mensagem e recebe "seu número ainda não está ligado a uma casa" | Confira se o celular está em Authorized Phones e use Send Activation Invites ou mande a ele o Activation Link. |
| "Este número não está autorizado nessa casa" | O número que o morador usa é diferente do cadastrado. Corrija em Authorized Phones. |
| O assistente diz que não encontrou um item | Libere o item na property do tipo dele e rode Refresh Devices. Nomes claros no Composer ajudam o assistente. |
| Connection Status sem conexão | Confira a internet do controlador. O driver tenta de novo sozinho. |
| "Este controlador já está registrado com outra chave" | Acontece ao trocar o controlador. Fale com a ZOOM para liberar a casa. |
| O assistente parou de responder | Veja Monthly Usage e Plan Valid Until. Com o limite atingido, renove ou amplie o plano com a ZOOM. |
Licenciamento
- Período de teste de 720 horas (30 dias); tempo restante em License Status.
- Depois de adquirir a licença, insira a chave em License Key.
O que é controlado pela licença
| Operação | Licença ou teste ativo | Teste expirado |
|---|---|---|
| Conexão com o serviço e ativação dos celulares | OK | OK |
| Pedidos dos moradores pelo WhatsApp | OK | Bloqueado |
| Comando Send Message (avisos) | OK | Bloqueado |
Suporte e Atualizações
- Site: www.zoomdigitalhome.com.br
- Suporte: drivers@zoomdigitalhome.com.br
Release Notes
| Versão | Data | Descrição |
|---|---|---|
| 20261113 | 13/11/2026 | Versão inicial: controle e consulta da casa pelo WhatsApp com inteligência artificial, confirmação para portões e fechaduras, comandos personalizados, mensagens de voz, convite de ativação com um toque, agendamentos pelo WhatsApp (repetidos e pelo nascer e pôr do sol com o Universal Scheduler), histórico de tudo o que foi feito e por quem, avisos pela programação e pelo Universal Notifier, e aviso antes de o plano vencer. Mostra em License Status quando há versão nova do driver. |