O morador controla a casa pelo WhatsApp, com mensagens de texto ou de voz, falando do jeito que fala no dia a dia: "apaga a sala", "coloca o ar do quarto em 23 graus", "toca a rádio Jovem Pan no home theater", "desliga a bomba da piscina daqui a 2 horas", "tem alguma porta aberta?".
Depois de incluir, remover ou renomear aparelhos, ambientes, cenas ou favoritos no projeto, execute a ação Refresh Device List. O driver também lê o projeto de novo sempre que o controlador reinicia.
Não existe frase obrigatória. Os exemplos abaixo mostram o tipo de pedido que funciona. O morador pode mandar áudio em vez de texto, e pode juntar vários pedidos na mesma mensagem ("apaga a sala e fecha a persiana do quarto").
| Tipo | Exemplos |
|---|---|
| Luzes | "acende a sanca da sala", "apaga a cozinha", "deixa o abajur em 30%", "apaga todas as luzes" |
| Cenas de iluminação | "ativa a cena jantar", "ativa boa noite", "Desligar Externas" (nome exato da cena) |
| Macros | "executa sair de casa", "roda a macro chegada" |
| Persianas e cortinas | "fecha as persianas da sala", "abre a cortina da suÃte pela metade" |
| Ar-condicionado | "liga o ar do escritório em 22", "coloca o ar da suÃte no modo frio, ventilação baixa", "desliga todos os ares" |
| Relés (portão, bomba, irrigação) | "abre o portão" (pede confirmação), "liga a bomba da piscina" |
| Música e vÃdeo | "toca Spotify na varanda", "coloca a rádio Antena 1 no gourmet", "liga a Globo na TV da sala", "toca a playlist Jantar" (se for favorito) |
| Volume e reprodução | "aumenta o volume da sala", "volume 30 no home theater", "pausa", "próxima música", "tira do mudo" |
| Desligar ambiente | "desliga o home theater" (só a mÃdia), "desliga tudo no quarto casal" (luzes, ar e mÃdia) |
| Estado atual | "a luz do home theater está acesa?", "como está o ar do quarto?", "tem alguma porta aberta?", "o que está tocando na sala?" |
| Para depois | "desliga o ar do quarto daqui a 1 hora", "apaga a varanda em 20 minutos" |
Morador: apaga a sala e fecha a persiana
WhatsAI: Apaguei Sanca, Pendente (Sala); Fechei Persiana (Sala).
Morador: 🎤 "coloca o ar da suÃte em 23 graus"
WhatsAI: Pronto, o ar da SuÃte está ligado no frio a 23°.
Playlists e músicas de dentro dos serviços de streaming (Deezer, Spotify etc.) só ficam disponÃveis pelo WhatsApp se o morador salvá-las como favoritos no Control4. Rádios, favoritos e canais que aparecem no Navigator ficam disponÃveis automaticamente.
| O morador fala | O que acontece |
|---|---|
| "apaga a sala" | Apaga todas as luzes do ambiente Sala. |
| "desliga a sala", "desliga o home theater" | Desliga só a mÃdia do ambiente (som/TV), igual ao Control4 e à Alexa. |
| "desliga tudo no quarto casal" | Apaga as luzes, desliga o(s) ar(es) e a mÃdia daquele ambiente. |
| "apaga todas as luzes", "desligar todas as luzes da casa" | Ativa a cena definida em All Lights Off Scene; se ela estiver em branco, apaga cada luz da casa. |
| "desliga a casa toda", "desliga tudo na minha casa" | Desliga a casa inteira. Só acontece quando o morador diz claramente que é a casa toda. |
| "desliga tudo" (sem ambiente) | O agente pergunta se é algum ambiente ou a casa toda. |
Nomes de ambiente podem vir abreviados ou em outra ordem: "qt casal", "quarto casal" e "Casal Qt" são o mesmo ambiente.
Quando o nome pedido é exatamente o de uma cena, macro ou ambiente (ex.: a cena "Desligar Externas"), o agente usa esse item, sem tentar interpretar a frase.
O agente consulta o controlador no momento da pergunta e responde com o que o Control4 informa: luz acesa e nÃvel, ar ligado/modo/temperatura, persiana aberta ou fechada, o que está tocando e o volume, e os sensores.
Morador: como estão os sensores?
WhatsAI: A Porta Cozinha está fechada, não há movimento nos sensores e o Quarto marca 20,6° com 66% de umidade.
"Desliga o ar do quarto daqui a 2 horas" fica guardado no controlador e é executado mesmo que o morador não esteja mais conversando. Quando o comando é executado, o morador recebe um aviso. Os comandos pendentes aparecem na propriedade Pending Timers e podem ser cancelados com a ação Cancel Pending Timers.
Por segurança, um comando agendado que vence enquanto o controlador está desligado não é executado quando ele volta.
Para aparelhos sensÃveis o agente pede confirmação antes de agir:
Morador: abre o portão
WhatsAI: Confirma? Abrir Portão Social — responda SIM.
Morador: sim
WhatsAI: Pronto, acionei o Portão Social.
Em Response Language = Auto, o agente responde no idioma em que o morador escreveu (português, inglês, espanhol…). Escolha um idioma para responder sempre nele, mesmo que o morador escreva em outro.
Guest: turn off the living room lights
WhatsAI: Turned off Sanca, Pendente (Sala).
A 4Drivers pode definir um limite de pedidos por dia, semana ou mês para a casa ou para a conta, e um limite diário por telefone. O morador recebe um aviso no WhatsApp ao chegar a 80%, 90% e 95% do limite. Quando o limite é atingido, ele recebe uma mensagem dizendo quando o limite renova, e os pedidos seguintes são ignorados até lá.
O agente entende o projeto pelos nomes do Control4. Nomes claros deixam as respostas mais certeiras:
| Propriedade | Descrição |
|---|---|
| Driver License | Chave de licença 4Drivers deste projeto. Sem chave o driver funciona em modo de teste por 5 dias. |
| License Status | Trial Mode (com o tempo restante), Licensed, Trial Expired, Blocked ou License running in another project. Sem licença válida, comandos e perguntas são recusados e o morador é orientado a falar com o integrador. |
| Token | Chave do projeto, fornecida pela 4Drivers. |
| Connection Status | Situação da conexão com o servidor. |
| Agent Enabled | No bloqueia temporariamente todos os comandos pelo WhatsApp neste projeto. |
| Response Language | Idioma das respostas. Auto responde no idioma do morador. |
| All Lights Off Scene | Nome da cena de iluminação ou macro usada quando o morador pede para apagar todas as luzes da casa (ex.: Tudo Off). Em branco, o agente apaga cada luz. |
| Devices Found | Quantos aparelhos de cada tipo foram encontrados no projeto. |
| Lights, Lighting Scenes, Macros, Blinds, Thermostats, Relays, Room Media, Room Control | Enabled: o morador pode controlar esse tipo e perguntar seu estado. Disabled: o tipo não é oferecido e pedidos sobre ele são recusados. Room Media = escolher fontes, rádios, favoritos e canais; Room Control = volume, mudo, pausa/próxima e desligar a mÃdia do ambiente. |
| Sensors | Sensores de porta, janela, portão, movimento, vazamento e temperatura, incluindo zonas de alarme e sensores de outros fabricantes. Só podem ser consultados. Quando o sensor é genérico, o tipo vem do nome no projeto. Disabled esconde os sensores do agente. |
| Hidden Sources | Fontes de áudio/vÃdeo que não devem ser oferecidas, separadas por vÃrgula (nomes ou IDs). |
| Confirm Relays | Yes (recomendado): relés só operam depois de o morador responder SIM. |
| Confirm Macros | Mesma confirmação para macros. |
| Always Confirm (names) | Nomes de aparelhos que sempre pedem confirmação, separados por vÃrgula. |
| Delay Between Actions (ms) | Intervalo entre os comandos quando uma mensagem controla vários aparelhos. |
| Temperature Scale | Escala usada nos setpoints do ar (Celsius ou Fahrenheit). |
| Pending Timers | Comandos agendados para depois. |
| Driver Version | Versão do driver instalada. |
| Message | Último comando executado e outros avisos. |
| Debug Mode | Print mostra detalhes na janela Lua, para suporte. |
| Ação | Descrição |
|---|---|
| Refresh Device List | Lê o projeto de novo e atualiza a lista oferecida ao agente. |
| Reconnect | Fecha e abre de novo a conexão com o servidor. |
| Cancel Pending Timers | Cancela todos os comandos agendados para depois. |
Exemplos:
| Situação | O que fazer |
|---|---|
| Connection Status: Waiting for token | Preencha a propriedade Token. |
| Invalid token - check the Token property | Copie o Token de novo, exatamente como foi enviado. O driver tenta de novo a cada 2 minutos; use Reconnect para tentar na hora. |
| Blocked by the server | Fale com a 4Drivers. Quando o serviço for liberado, o driver reconecta sozinho em até 1 minuto, ou na hora com Reconnect. |
| Could not connect / No answer from server | Verifique a internet e o DNS do controlador. O driver continua tentando sozinho. |
| Replaced by another connection | O mesmo Token está em uso em outro projeto. Cada projeto precisa do seu Token. |
| O morador recebe "este número não está autorizado" | Peça à 4Drivers para cadastrar o número. |
| O morador recebe "a licença do sistema nesta casa não está ativa" | Confira License Status e a chave em Driver License. |
| O agente diz que um aparelho não existe | Execute Refresh Device List e confira se o tipo está Enabled e se o ambiente não está oculto. |
| Um sensor não aparece ou aparece com o tipo errado | Confira Sensors = Enabled e use o tipo no nome do sensor (ex.: Porta Serviço, Mov Hall). Depois execute Refresh Device List. |
| Uma playlist ou música não é encontrada | Salve a playlist como favorito no Control4 e execute Refresh Device List. |
| "Apagar todas as luzes" não usa a cena certa | Escreva em All Lights Off Scene o nome exato da cena ou macro. |
| Versão | Alterações |
|---|---|
| 1050 | Versão inicial. |