ZOOM – WhatsApp AI v20261113

Overview

With ZOOM WhatsApp AI residents talk to their home on WhatsApp, writing the way they would talk to a person:

• "Turn off everything in the living room and set the bedroom AC to 22"
• "Is the front door locked?" or "What's the temperature on the balcony?"
• "Turn on the Movie scene" or "Close the bedroom shades"
• "Open the gate" (the assistant asks for a YES first)

An artificial intelligence assistant understands the request, picks the right items in the home and the controller carries it out. Residents talk to ZOOM's official WhatsApp number: no SIM card in the home, no account on another service and no router ports to open.

The home can also send alerts to the residents through the same number (alarm, door left open, water leak) from Composer programming.

Prerequisites

• Control4 controller on OS 3.0 or later with internet access.
• Each resident's phone with WhatsApp.
• Active message plan (the first year comes with the license; see Message plan).

Installation

1. Add the ZOOM – WhatsApp AI driver to the project.
2. Enter the key in License Key (the driver has a 30-day trial, with up to 100 messages per month).
3. In Authorized Phones, enter the residents as Name: phone, separated by semicolons. Example: John: +1 305 555-1234; Mary: +1 305 555-7777. Brazilian numbers may omit the 55.
4. Choose what the assistant can use in Lights, Shades, Thermostats, Relays, Locks, Sensors and Rooms. The assistant only sees and controls what is selected.
5. Optionally give the home a name in House Name and set up custom commands.
6. Check that Connection Status shows Connected and how many items Devices Available lists.
7. Ask each resident to activate their phone.

Activating a resident's phone

When Authorized Phones is saved, each new resident gets a ZOOM invitation on WhatsApp with an Activate button. They tap it once: the assistant replies to confirm, and from then on the phone controls the home. The Send Activation Invites action sends the invitation again to anyone who has not activated yet.

If the invitation does not arrive, there are two other ways. The Activation Link property has a link to send to the resident by any means: it opens ZOOM's WhatsApp with the activation message ready to send. Or the resident writes the Activation Code message (for example activate 482913) to ZOOM's WhatsApp number, +55 51 98537-0863.

• Phones Status shows who has activated (✓) and who is still pending.
• Only phones listed in Authorized Phones can activate. Removing a number from the list cuts access right away.
• The New Activation Code action creates a new code (the old one stops working; phones already activated stay active).

What residents can ask

Several requests can go in one message. The assistant replies in the language the resident wrote in and does not chat about other topics. It also understands voice messages: the reply starts with what it understood, so the resident can check it.

Scheduling over WhatsApp

Residents can also ask for things to happen later:

• "Turn off the bedroom AC in 1 hour" or "At 10 pm turn off the living room lights"
• "Every Monday at 7 am open the shades" or "Turn on the porch light at sunset"
• "What is scheduled?" and "Cancel the porch schedule"

With ZOOM Universal Scheduler in the project, bind this driver's Scheduler connection to the Scheduler's WhatsApp AI connection (it binds automatically when both are in the project). Schedules requested over WhatsApp show up on the Scheduler screen in Navigator, with the name of who asked, and can repeat (days of the week) or follow sunrise and sunset. One-time ones leave the list after they run. Cancelling over WhatsApp deletes the ones created over WhatsApp; the ones created on the screen or by the integrator are only turned off.

Without the Scheduler, the assistant only accepts one-time requests ("in 30 minutes", "tomorrow at 7 am"), up to 7 days ahead. To repeat or use the sun, it explains that Universal Scheduler is needed. If the controller is off at that time, the request does not run and is recorded in the history.

Scheduling a gate, relay or lock also asks for YES when scheduling. When it runs, the driver uses the items allowed here: if an item is no longer allowed, the action does not run and is recorded.

History and alerts of what was done

Everything done over WhatsApp is recorded with the name of who asked, to answer questions like "who opened the gate?" or "why did the light turn on by itself?":

• The Show History action shows the last 100 actions in the Lua tab: commands, schedules created and cancelled, scheduled actions executed or not executed, and one-time requests waiting.
• In Universal Scheduler, the history shows who created, changed, cancelled or turned off each schedule, from the screen or over WhatsApp.
• With Universal Notifier, these actions become notifications: gate, relay and lock as alerts; other commands and schedules as information (to receive them, set Send Notifications to All Events).

Security and confirmations

• Only registered and activated phones can talk to the home.
• The assistant only sees the items the integrator allowed.
• Opening a gate, triggering a relay and unlocking a lock only happen after the resident replies YES (valid for 3 minutes). The Confirm Before property can also include thermostats or turn confirmation off.

Custom commands

Use Custom Command 1 to 8 to name actions you program in Composer, such as Open pedestrian gate, Start irrigation or Away mode. When a resident asks for one, the driver fires the matching Custom Command N event and stores the name in the LAST_CUSTOM_COMMAND variable. With Custom Commands Confirmation set to Yes, these commands also ask for YES.

Alerts from programming

The Send Message command sends an alert over WhatsApp. In To, use All for every activated resident or the registered name of one resident. Use it for alarms, a door left open, water leaks, the doorbell and so on.

Alerts keep arriving even when the month's message limit runs out (with a small margin), so residents are not left without security alerts.

Universal Notifier

Bind the Notifier connection to ZOOM Universal Notifier (free driver). It works both ways:

• ZOOM driver alerts through the official number: in the Notifier, choose ZOOM WhatsApp AI in WhatsApp Service. Locks, alarms and other ZOOM drivers then alert the activated residents through this number, with no third-party account or key. Leave the Notifier's WhatsApp Numbers empty to send to everyone, or enter resident names or numbers. These alerts count toward the message plan.
• WhatsApp AI notices to the integrator: actions done over WhatsApp (see History), plan expiring or expired, monthly limit and service offline (after 10 minutes) go to the Notifier, which sends them through the channels chosen there (push, e-mail, etc.). These notices are not sent to residents over WhatsApp. The Send Notifications property chooses what goes out: everything, alerts only or nothing.

Message plan

The driver uses ZOOM's WhatsApp and artificial intelligence service. The license includes 12 months of service with up to 300 messages per month per home (about 10 a day, counting replies and alerts). After that, the service is renewed yearly with ZOOM: the renewal extends the license validity and the home picks it up by itself within 12 hours, with no reinstall or project changes.

• Monthly Usage shows this month's usage and Plan Valid Until the plan's expiry date.
• Residents get a notice when usage passes 80%, 90% and 95%, and the driver fires the Quota Warning and Quota Exceeded events.
• 30 and 7 days before the plan expires, Plan Valid Until shows how many days are left and the driver fires the Plan Expiring event; on expiry, Plan Expired.
• Once the limit is reached or the plan expires, the assistant stops answering requests, but home alerts keep going for a while.

Properties

Actions

Commands, events and variables

Command: Send Message (To, Message).

Connections: Notifier (ZOOM Universal Notifier) and Scheduler (ZOOM Universal Scheduler).

Events: Message Received, Command Executed, Quota Warning, Quota Exceeded, Plan Expiring, Plan Expired, Scheduled Action Executed, Service Online, Service Offline, Custom Command 1–8.

Variables: LAST_MESSAGE, LAST_SENDER, LAST_ACTION, LAST_CUSTOM_COMMAND, RELAY_ONLINE, MONTHLY_USAGE.

Troubleshooting

Licensing

• 720-hour (30-day) trial; remaining time in License Status.
• After purchasing a license, enter the key in License Key.

What the license controls

Support and Updates

• Site: www.zoomdigitalhome.com.br
• Support: drivers@zoomdigitalhome.com.br

Release Notes