# \[APP\]\[PRO\] WhatsApp Bot - Control your home with a WhatsApp message **URL:** \ **Category:** Apps\ **Created:** [March 2, 2026, 9:05pm UTC](https://community.homey.app/t/app-pro-whatsapp-bot-control-your-home-with-a-whatsapp-message/151974 "2026-03-02T21:05:34Z")\ **Posts on this page:** 18\ **Page:** 1
**Author:** ![s\_dimaio](https://sea1.discourse-cdn.com/flex025/user_avatar/community.homey.app/s_dimaio/32/78995_2.png) [@s\_dimaio](https://community.homey.app/u/s_dimaio)\ **Post date:** [March 2, 2026, 9:05pm UTC](https://community.homey.app/t/app-pro-whatsapp-bot-control-your-home-with-a-whatsapp-message/151974/1 "2026-03-02T21:05:34Z")
Hi everyone, **WhatsApp Bot** is an app that allows your Homey Pro to communicate with a dedicated WhatsApp bot using the official **Meta WhatsApp Cloud API**. This integration enables you to control your smart home by sending and receiving messages directly within your WhatsApp chat. > **[WhatsApp Bot | Homey](https://homey.app/en-gb/app/com.dimapp.wabot/WhatsApp-Bot/)** > > Control your home with a WhatsApp message. > **TIP:** By pairing this app with [**Gemini AI**](https://homey.app/a/com.dimapp.geminiai/), you can unlock **Natural Language control** for your entire home via WhatsApp. Simply route your incoming messages to Gemini AI in your flows to experience a truly intelligent chat interface. * * * ## **đŸ“© Interactive Messaging with Homey** The app is built around two core Flow cards that turn WhatsApp into a powerful interface for your smart home. ### **đŸ“€ Send WhatsApp Message (Action)** Stay informed about your home in real-time. Whether it’s a security alert or a simple household reminder, Homey can now “text” you directly. - **Security:** “Presence detected in the garage while you’re away!” - **Appliances:** “The laundry is ready! đŸ§ș” - **Notifications:** “Energy consumption is exceeding 3kW, please turn something off.” ### **đŸ“„ Message Received (Trigger)** Control your home by simply sending a **text** or a **vocal** message to your bot. - **Remote Execution:** Text “Lock everything” to arm your security system and turn off all lights. - **Status Inquiry:** Say “Is the oven on?” to get an instant reply. - **Conversational Flows:** Use the incoming message text as a variable to trigger complex logic or search for information. * * * ## **⚙ Professional Setup (Meta Cloud API)** Unlike unofficial solutions, this app relies on the **official Meta Developer Portal**. This ensures your messages are delivered instantly and securely. 1. **Direct Connection:** You connect directly to Meta. No middle-man servers, no data sniffing. 2. **Permanent Access:** No more QR code scanning every few weeks. Once configured with a Permanent Access Token, it works forever. 3. **Setup Guide Included:** I know Meta’s portal can be daunting, so I’ve built a **step-by-step Setup Guide** directly inside the app settings to walk you through the process. * * * **Download it now on the Homey App Store!** I’d love to hear your feedback, see your flows, and help with any questions. Simone Test version: [https://homey.app/it-it/app/com.dimapp.wabot/WhatsApp-Bot/test/](https://homey.app/it-it/app/com.dimapp.wabot/WhatsApp-Bot/test/) ---
**Author:** ![s\_dimaio](https://sea1.discourse-cdn.com/flex025/user_avatar/community.homey.app/s_dimaio/32/78995_2.png) [@s\_dimaio](https://community.homey.app/u/s_dimaio)\ **Post date:** [March 2, 2026, 9:06pm UTC](https://community.homey.app/t/app-pro-whatsapp-bot-control-your-home-with-a-whatsapp-message/151974/2 "2026-03-02T21:06:14Z")
# Configuration Guide: Meta WhatsApp Cloud API This guide will walk you through the process of creating and configuring your Meta App to integrate WhatsApp with Homey Pro. * * * ## **1. Create the Meta App for Developers** 1. Go to [Meta for Developers](https://developers.facebook.com/) and log in with your Facebook account. 2. Click on **“My Apps”** in the top right corner and press the **“Create App”** button. 3. In the **“Use Cases”** section, select **“Connect with customers through WhatsApp”**. 4. Link the app to a **Business Portfolio**. If you don’t have one, follow the free guided wizard to create it. 5. Once the creation is complete, you will be redirected to the Dashboard of your new app. * * * ## **2. WhatsApp Configuration and Phone Number ID** 1. In the left menu, select **“Use Cases”** and click **“Customize”** in the WhatsApp box. ![guide_part1](https://us1.discourse-cdn.com/flex025/uploads/athom/original/3X/0/a/0a1251e33dd8e0062d8f5983a1cc8df13106fce5.png) 2. Go to the **“API Setup”** menu on the left. 3. Take note of the **“Phone Number ID”** value (you will need it in the Homey settings). * * * ## **3. Obtaining a Permanent Access Token** To avoid having to update the token every 24 hours, you need to create a System User: 1. Go to [Meta Business Settings](https://business.facebook.com/settings). 2. In the left menu, open the **Users** section and choose **System users**. 3. Click **“Add”** , choose a name (e.g., `HomeyBot`), select the **“Admin”** role, and click **“Create system user”**. 4. Click **“Assign assets”** , select your App, enable **“Full control”** , and save. 5. Click **“Generate token”** , select your App, and in the permissions list, you must check: - `whatsapp_business_messaging` - `whatsapp_business_management` 6. Copy the generated Token and keep it safe (it will only be shown once). * * * ## **4. Configuration on Homey** Open the WhatsApp Bot app settings on Homey and enter: - **Access Token** : The permanent token generated in step 3. - **Phone Number ID** : The ID obtained in step 2. - **Verify Token** : A string of your choice without spaces (e.g., `my_secret_token`). **Note: it is strictly case-sensitive** (using only lowercase letters is recommended to avoid mobile auto-capitalization issues). This string will be used both to verify the Homey app within the Meta portal and for the initial bot registration (it is the secret code required by the bot). - **Save the settings** and take note of the **Webhook URL** that appears. * * * ## **5. Webhook Configuration on Meta** 1. Go back to the Meta Developer Portal, in the WhatsApp menu select **“Configuration”**. 2. Click **“Edit”** next to Webhook: 3. Click **“Verify and Save”**. 4. Under the **“Webhook fields”** section activate (Subscribe) the **`messages`** field. * * * ## **6. First Activation (Sending a Test Message)** To activate communication, Meta requires an initial manual send: 1. Go to **“API Setup”** on the Meta portal. 2. In the top right, generate a **Temporary access token** (expires after 24 hours, only needed now). 3. In “Step 1: Select phone numbers”, select your phone number in the “To” field. 4. In “Step 2: Send messages with API”, click **“Send message”**. 5. You will receive a “Hello World” message on WhatsApp. Now the bot is active, but to use it, you must first register. 6. Send a message to the bot with the text `/register [secret_code]` where `secret_code` is the Verify Token you chose in step 4. 7. The bot will reply with a welcome message and will be ready to use. * * * **Note:** For daily use, Homey will use the Permanent Access Token configured in step 3, so you won’t have to worry about expirations. ---
**Author:** ![Caesar](https://sea1.discourse-cdn.com/flex025/user_avatar/community.homey.app/caesar/32/88727_2.png) [@Caesar](https://community.homey.app/u/Caesar)\ **Post date:** [March 4, 2026, 9:35pm UTC](https://community.homey.app/t/app-pro-whatsapp-bot-control-your-home-with-a-whatsapp-message/151974/3 "2026-03-04T21:35:01Z")
How do I add contacts in the address book? eg my personal number, my wife, kids, etc.. ---
**Author:** ![s\_dimaio](https://sea1.discourse-cdn.com/flex025/user_avatar/community.homey.app/s_dimaio/32/78995_2.png) [@s\_dimaio](https://community.homey.app/u/s_dimaio)\ **Post date:** [March 4, 2026, 9:46pm UTC](https://community.homey.app/t/app-pro-whatsapp-bot-control-your-home-with-a-whatsapp-message/151974/4 "2026-03-04T21:46:53Z")
Ciao Caesar, You must repeat step six of the guide for each new user. Essentially, in Meta for developer you must add the number of the person you want to add to the “to” field and then send them the test message. Once that person receives the test message, he must respond with: > /register [your\_token] where [your\_token] is the **Verify Token** chosen in step 4. From that moment, he will be able to use the bot, and the phone number will appear in the users section of the app settings. ---
**Author:** ![Caesar](https://sea1.discourse-cdn.com/flex025/user_avatar/community.homey.app/caesar/32/88727_2.png) [@Caesar](https://community.homey.app/u/Caesar)\ **Post date:** [March 4, 2026, 10:36pm UTC](https://community.homey.app/t/app-pro-whatsapp-bot-control-your-home-with-a-whatsapp-message/151974/5 "2026-03-04T22:36:31Z")
My meta web interface is a bit different than described: 1. Section is called “API Testing” 2. Temp token is generated as described 3. **2. Select a ‘From’ phone number** is kept as is (random US number) 4. **3. Add a recipient phone number** I added my personal number 5. **4. Turn on webhook listening** I tested with both On and Off 6. **5. Choose a type of message to send** I chose “Plain Text” 7. **6. Send messages with the API** sends me the text “Welcome to Jasper’s Market, your local grocery store providing farm-fresh produce and high-quality goods!” 8. I respond in the chat “/register” “/register handshake” “/register [handshake]” but all three responses don’t register in the app ---
**Author:** ![s\_dimaio](https://sea1.discourse-cdn.com/flex025/user_avatar/community.homey.app/s_dimaio/32/78995_2.png) [@s\_dimaio](https://community.homey.app/u/s_dimaio)\ **Post date:** [March 4, 2026, 10:51pm UTC](https://community.homey.app/t/app-pro-whatsapp-bot-control-your-home-with-a-whatsapp-message/151974/6 "2026-03-04T22:51:59Z")
Send me a diagnostic report after sent the comand /register handshake so to take a look ---
**Author:** ![s\_dimaio](https://sea1.discourse-cdn.com/flex025/user_avatar/community.homey.app/s_dimaio/32/78995_2.png) [@s\_dimaio](https://community.homey.app/u/s_dimaio)\ **Post date:** [March 10, 2026, 9:52pm UTC](https://community.homey.app/t/app-pro-whatsapp-bot-control-your-home-with-a-whatsapp-message/151974/7 "2026-03-10T21:52:53Z")
In the latest version, I’ve added **full support for Voice Messaging** : now you can send audio messages and the bot will transcribe them using Groq’s Whisper API. **You’ll find all the instructions for configuring the Groq API in the app settings**. ---
**Author:** ![Jaap\_p](https://sea1.discourse-cdn.com/flex025/user_avatar/community.homey.app/jaap_p/32/169003_2.png) [@Jaap\_p](https://community.homey.app/u/Jaap_p)\ **Post date:** [July 27, 2026, 11:32pm UTC](https://community.homey.app/t/app-pro-whatsapp-bot-control-your-home-with-a-whatsapp-message/151974/8 "2026-07-27T23:32:02Z")
```auto ``` Hello, I’ve tried everything, but the bot isn’t responding to: /register [my token] . ---
**Author:** ![4x4\_Pete](https://sea1.discourse-cdn.com/flex025/user_avatar/community.homey.app/4x4_pete/32/113286_2.png) [@4x4\_Pete](https://community.homey.app/u/4x4_Pete)\ **Post date:** [July 28, 2026, 2:03am UTC](https://community.homey.app/t/app-pro-whatsapp-bot-control-your-home-with-a-whatsapp-message/151974/9 "2026-07-28T02:03:30Z")
Hi @s_dimaio Italian is a beautiful language and I love it 😍 - But unfortunately do not understand it 😬 Could you pls provide an englisch version of app and app page and link to it by leaving the „/it-it“ part out of the url (= non language specific link)? ---
**Author:** ![s\_dimaio](https://sea1.discourse-cdn.com/flex025/user_avatar/community.homey.app/s_dimaio/32/78995_2.png) [@s\_dimaio](https://community.homey.app/u/s_dimaio)\ **Post date:** [July 28, 2026, 8:13pm UTC](https://community.homey.app/t/app-pro-whatsapp-bot-control-your-home-with-a-whatsapp-message/151974/10 "2026-07-28T20:13:15Z")
> [@4x4\_Pete](#): > > Could you pls provide an englisch version of app and app page and link to it by leaving the „/it-it“ part out of the url (= non language specific link)? Done! > [@Jaap\_p](#): > > Hello, > I’ve tried everything, but the bot isn’t responding to: /register [my token] . send me a diagnostic report so I can take a look ---
**Author:** ![Javier\_Rengel](https://sea1.discourse-cdn.com/flex025/user_avatar/community.homey.app/javier_rengel/32/120982_2.png) [@Javier\_Rengel](https://community.homey.app/u/Javier_Rengel)\ **Post date:** [August 25, 2026, 11:14pm UTC](https://community.homey.app/t/app-pro-whatsapp-bot-control-your-home-with-a-whatsapp-message/151974/11 "2026-08-25T23:14:29Z")
Hi Simone, I’m having trouble getting incoming WhatsApp messages to trigger the Homey WhatsApp Bot app. Meta Cloud API is configured and the webhook is verified successfully. The `messages` webhook field is subscribed, and Meta successfully sends the webhook test. However, when I send a real WhatsApp message to the Meta test number, Homey receives nothing and the `whatsapp_message_received` Flow trigger is not triggered. I also sent `/register CasaHomey2026` from my WhatsApp number, but I receive no response. Diagnostic report code: **021ca0dd-54eb-4633-b66c-61d2657a518** Phone Number ID: **1268867009645327** Could you please check the diagnostic report and let me know what is wrong? Thank you! ---
**Author:** ![Mark\_Sharples](https://sea1.discourse-cdn.com/flex025/user_avatar/community.homey.app/mark_sharples/32/120715_2.png) [@Mark\_Sharples](https://community.homey.app/u/Mark_Sharples)\ **Post date:** [October 3, 2026, 12:31am UTC](https://community.homey.app/t/app-pro-whatsapp-bot-control-your-home-with-a-whatsapp-message/151974/13 "2026-10-03T00:31:40Z")
I’m having the same issues as others , as it won’t register the bot/user Please could you check the diag report 5b617c6c-607f-4cc7-9f89-35957bf4c18b ---
**Author:** ![Mark\_Sharples](https://sea1.discourse-cdn.com/flex025/user_avatar/community.homey.app/mark_sharples/32/120715_2.png) [@Mark\_Sharples](https://community.homey.app/u/Mark_Sharples)\ **Post date:** [October 3, 2026, 3:38am UTC](https://community.homey.app/t/app-pro-whatsapp-bot-control-your-home-with-a-whatsapp-message/151974/14 "2026-10-03T03:38:11Z")
did you manage to resolve this ? I had similar issues as you and have found out the repair/fix for it and I can immediately see your problem from your message you posted here ---
**Author:** ![s\_dimaio](https://sea1.discourse-cdn.com/flex025/user_avatar/community.homey.app/s_dimaio/32/78995_2.png) [@s\_dimaio](https://community.homey.app/u/s_dimaio)\ **Post date:** [October 4, 2026, 10:51am UTC](https://community.homey.app/t/app-pro-whatsapp-bot-control-your-home-with-a-whatsapp-message/151974/15 "2026-10-04T10:51:57Z")
ciao @Mark_Sharples! Looking at the logs, your Homey app is working properly and can successfully send messages out. However, **Homey is not receiving any incoming webhook events at all** from Meta (there are zero `[POST] /webhook` entries logged). When you send `/register`, Homey should log the incoming message immediately. Since nothing appears in the logs, **Meta is not delivering incoming WhatsApp messages to your Homey**. To solve this, please check these two key steps in the [Meta for Developers](https://developers.facebook.com/) portal: * * * ### 1. Ensure the `messages` Webhook Field is Subscribed (Most Common) Even if your Webhook Callback URL is verified, Meta will **not** forward incoming messages unless you explicitly subscribe to them: 1. In your Meta App, go to **Use Cases** → **WhatsApp** → **Configuration**. 2. Scroll to the **Webhook fields** section and click **Manage**. 3. Find the **`messages`** row and ensure you click **Subscribe**. _(If it’s not subscribed, Meta silently ignores all incoming WhatsApp messages)._ * * * ### 2. If you are using Meta’s Test Phone Number (Sandbox): In Sandbox mode, Meta has strict restrictions and **will not allow you to start a chat with the test bot out of the blue** : 1. **Verify your number** : Go to **WhatsApp** → **API Setup**. In **Step 1 (Select phone numbers)** under the **“To”** dropdown, make sure your personal phone number is added and verified via SMS. 2. **Initiate the chat from Meta (Hello World)**: You cannot text the test number first. You must generate a temporary token in **API Setup** and click **“Send message”** (Step 2) from the portal to send the _“Hello World”_ welcome message to your phone. 3. **Reply to that chat** : Once you receive the _“Hello World”_ message on your WhatsApp app, reply **directly in that exact chat thread** with: ```plaintext /register [YourVerifyToken] ``` _(Replace `[YourVerifyToken]` with the exact Verify Token you saved in your Homey app settings. Do not add extra words like “Handshake”)._ Once either the webhook subscription is fixed or the chat session is properly initiated from Meta, your `/register` command will reach Homey immediately and complete your registration ---
**Author:** ![Mark\_Sharples](https://sea1.discourse-cdn.com/flex025/user_avatar/community.homey.app/mark_sharples/32/120715_2.png) [@Mark\_Sharples](https://community.homey.app/u/Mark_Sharples)\ **Post date:** [October 4, 2026, 11:19am UTC](https://community.homey.app/t/app-pro-whatsapp-bot-control-your-home-with-a-whatsapp-message/151974/16 "2026-10-04T11:19:27Z")
Thank you for the response , it is very much appreciated. I did find out the issue and by looking at some of the questions in this thread others , have and are having the same problem that I did . The error is in your wording in the instructions that you supply regarding the verify token. You mention , no spaces and numbers when creating the verify token , which is 100% accurate however on modern devices such as phones or tablets , the first letter is normally capitalised automatically . This was my issue . The first letter of my token was a capital letter , and WhatsApp wouldn’t recognise it . Please could you add to your instructions for other new users that Capital Letters should also not be included when creating the verify token . Thanks again for all your hard work , the app,works beautifully now . Mark ---
**Author:** ![s\_dimaio](https://sea1.discourse-cdn.com/flex025/user_avatar/community.homey.app/s_dimaio/32/78995_2.png) [@s\_dimaio](https://community.homey.app/u/s_dimaio)\ **Post date:** [October 4, 2026, 7:31pm UTC](https://community.homey.app/t/app-pro-whatsapp-bot-control-your-home-with-a-whatsapp-message/151974/17 "2026-10-04T19:31:50Z")
Actually, the token should be case-sensitive: if you save it in the Homey app using uppercase letters, then you must use those same uppercase letters when registering via `/register`. Was that not the case for you? ---
**Author:** ![Mark\_Sharples](https://sea1.discourse-cdn.com/flex025/user_avatar/community.homey.app/mark_sharples/32/120715_2.png) [@Mark\_Sharples](https://community.homey.app/u/Mark_Sharples)\ **Post date:** [October 4, 2026, 10:45pm UTC](https://community.homey.app/t/app-pro-whatsapp-bot-control-your-home-with-a-whatsapp-message/151974/18 "2026-10-04T22:45:17Z")
No it worked perfect fine after after changing the first letter from a capital , I tried many times , even changed the verify token completely, I double checked for white spaces etc , but never got a response back from the WhatsApp message until I changed the capital . I tried also with my wife’s phone same issue , Both phones got immediate responses without the capital . ---
**Author:** ![s\_dimaio](https://sea1.discourse-cdn.com/flex025/user_avatar/community.homey.app/s_dimaio/32/78995_2.png) [@s\_dimaio](https://community.homey.app/u/s_dimaio)\ **Post date:** [October 5, 2026, 8:21pm UTC](https://community.homey.app/t/app-pro-whatsapp-bot-control-your-home-with-a-whatsapp-message/151974/19 "2026-10-05T20:21:02Z")
Thanks for pointing that out. I’ve updated the instructions on the first page and within the app!