Connecting the Xiaomi button to Alice via the gateway: full instructions with pictures and tips

Xiaomi's smart buttons are compact devices that turn ordinary actions into automated scenarios. But their real power is revealed when integrated with Yandex's Alice voice assistant. With the Mi Home Gateway, you can link the physical press of a button to voice commands, creating convenient smart home control chains. For example, a single tap can turn on the lights, start the kettle at the same time and tell Alice you're coming home.

But the connection process often raises questions: how to add a button to the Mi Home ecosystem, configure a gateway to interact with Alice and avoid typical errors? In this article, we will analyze the step-by-step instructions based on the latest updates from 2026, and also consider alternative integration methods for devices without official support, focusing on solving problems with synchronization and customizing scenarios.

What Xiaomi buttons are compatible with Alice through the gateway

Not all Xiaomi smart buttons can work directly with Alice, but the main requirement is support for the Zigbee protocol and compatibility with the Mi Home Gateway (or its counterparts, for example, the Aqara Hub).

• 🔘 Xiaomi Mi Smart Button (round, model) WXKG01LM) — Basic version with one action (single/double/long press).
• 🔘 Xiaomi Mi Wireless Switch (square, model) WXKG11LM) — Supports up to 3 different commands (press, hold, double press).
• 🔘 Aqara Mini Switch (model) WXKG12LM) — compact version with magnetic base and advanced scenarios.
• 🔘 Xiaomi Mi Cube (model) MFKZQ01LM) — cube with 6 sides and gesture support (shaking, turning).

Important: buttons without Zigbee support (such as the Bluetooth version) will not connect to the gateway and thus to Alice.

Also consider the gateway version:

- Mi Home Gateway 3 (model) ZNDMWG03LM) — Supports up to 128 devices, including buttons.

- Aqara Hub M2 — Alternative with advanced automation capabilities.

Gateways of the first version (ZNDMWG02LM) They may not support new button models.

Preparation: What will be needed to connect

Before you start setting up, make sure you have everything you need:

• 📱 Smartphone with installed application Mi Home (version no lower) 6.0.100 for Android/iOS).
• 🌐 Stable Internet connection (Wi-Fi 2.4 GHz – gateway does not work with 5 GHz!).
• 🔌 Mi Home Gateway or Aqara Hub connected to the outlet and network.
• 🔘 Xiaomi smart button (charged if it’s a battery model).
• 🗣️ Yandex account with Alice tied and Yandex app installed (to customize skills).

Critical: The gateway must be tied to the same region in the Mi Home as the button. If you bought the devices in different countries (e.g., the gateway from China and the button from Europe), they may not be able to link.

1. Open Mi Home → Profile → Settings → Region.
2. Choose China (China) or Russia (Russia) depending on the firmware of the devices.
3. Restart the app.

If you don’t have a gateway, but you have a Xiaomi Mi Box or a Mi TV. TV With Google Assistant, you can try an alternative way to integrate through the IFTTT However, this method requires additional skills and does not guarantee stable work with Alice.

Step-by-step instruction: connecting the button to the gateway

So we start by adding a button to the Mi Home ecosystem, and this is a must-do phase, and Alice won't see the device without it.

1. Activate the Gateway's pairing mode: Open Mi Home and select your gateway from the device list. → Add the device. Click Add the Zigbee device and wait for the beep (gateway says Ready to add").
2. Connect the button: Press and hold the button on the device (usually 5-10 seconds) until the indicator blinks. In Mi Home, select the device type: Smart button or Wireless Switch (depending on the model). Wait for the process to be completed (gateway sound and device added message).
3. Set up actions: After adding, open the button card in Mi Home. Set up actions for each type of press (single, double, long). → Turn on the lights. Double press. → Activate the scenario “Leaving".

If no button is added:

Check the distance to the lock (maximum 10 meters without obstacles).

Make sure the battery is not discharged (in some models, the indicator does not show a low charge).

Reset the gateway (turn off power for 30 seconds).

Connection with Alice: setting up the skill "Smart home"

Now that the button is connected to the gateway, you need to link it to Alice, and this uses Yandex's official smart home skill.

1. Skill activation: Open the Yandex app on your smartphone. Go to the Services → Smart home. → Add a device. Select Mi Home (Xiaomi) from the list of supported systems. Sign in to your Mi Home account (use the same data as you use the app).
2. Device Synchronization: Once logged in, Yandex will automatically scan the devices associated with your Mi Home account. Find your button (it can be displayed as Wireless Switch or Smart Button) in the list. Click Add to Alice and confirm access.
3. Testing: Tell Alice, "Alice, turn on the smart home" or "Alice, show me my devices." Make sure the button is displayed in the list and responds to commands.

⚠️ Note: If the button does not appear in the list of Yandex devices, check: - Is the gateway tied to the same Mi Home account as the button. - Is the gateway firmware updated (the version at least lower in Mi Home should be) 1.4.1_176 gateway 3). - Are you using it? VPN or proxy – this can block synchronization with Yandex servers.

Once you've added it successfully, you can set up voice scripts, like:

- "Alice, activate the movie mode" → The button sends a command to turn off the lights and turn on the TV.

- "Alice, I'm leaving" → The button starts the "Gone" script (turns off all sockets, activates security).

Creation of automated scenarios

Just plugging a button into Alice is just the beginning, and the real magic starts when you link her to other devices through scripts.

Method 1: Scripts in Mi Home

In the Mi Home application, you can create a chain of actions that will start when you press the button:

1. Open Mi Home → Profile → Automation → Add.
2. Choose If → The device → [Your button] and specify the type of press (e.g., "Double press").
3. In the To section add action: 💡 Turn on/off the lights (Yeelight or Philips Hue). 🔌 Control of the socket (Xiaomi Smart Plug). 🚪 Activate the door sensor (Aqara Door Sensor).

Save the script and test it by pressing the button.

Method 2: Voice commands through Alice

In the Yandex application, you can create routines (sequences of commands) that will be launched by voice or through a button:

1. Open Yandex. → Services → Smart home. → routines.
2. Click Create a routine and select the trigger: Voice command (e.g., "Alice, good morning"). Device → Select your button and type of press.
3. Add action: 📢 Play music on the column. ☕ Turn on the kettle (Redmond or Xiaomi Viomi). 📱 Send notification to the phone.

⚠️ Note: If the script doesn’t work, check: – Are there any conflicts between the scripts in Mi Home and Yandex (for example, the same button press is assigned to different actions). – Are all devices in the script connected to the same Mi Home account. - Is the limit of devices in the gateway exceeded (maximum 30–50 devices per hub, depending on the model).

For advanced users: if standard features are not enough, you can use Home Assistant with the Xiaomi Mi Home plugin.This will allow you to create complex automations with conditions (for example, "if the button is pressed And the temperature is below 20".°C, then...").

💡

If the button is delayed, try moving the gateway closer to the router or using the Mesh network (for example, through additional Aqara gateways).

Common mistakes and their solution

Even with the correct following of the instructions, problems can arise, and we have collected typical errors and ways to fix them:

If none of these methods worked, try resetting the button:

For Mi Smart Button: Hold the button for 20 seconds until the beep.

For Mi Wireless Switch: Press and hold until the indicator flashes (about 10 seconds).

After resetting, repeat the connection process from scratch.

Alternative ways to connect without a gateway

What if you don’t have a Mi Home Gateway but a Xiaomi button? There are several workarounds, although they require additional devices or skills:

• 🌐 Home Assistant: Install Home Assistant on Raspberry Pi or NAS. Connect the button via the Xiaomi Miio plugin (for Bluetooth versions) or Zigbee2MQTT (for Zigbee devices with USB-adapter CC2531). Integrate Alice with the Yandex Smart Home component.
• 🔄 Through IFTTT (Bluetooth buttons: Create an applet in IFTTT With the Xiaomi Button trigger, select Webhooks as the action to send a request to Yandex Smart Home (required) API-key).
• 📱 Through Tasker (Android): Use the AutoNotification plugin to intercept notifications from the button. Set up a task in Tasker, which will send a command to Alice via HTTP-request.

⚠️ Warning: Alternative methods may violate Yandex’s security policy (e.g., using unofficial methods) API). This can lead to account blocking, and we recommend that you resort to them only if there is no official support.

For Bluetooth buttons (such as the Xiaomi Mi Bluetooth Button), there is no formal integration with Alice, in which case the only reliable way is to buy a gateway or switch to the Zigbee version of the device.

FAQ: Frequent questions about connecting Xiaomi button to Alice

💡

For stable button operation with Alice, use the Mi Home Gateway 3 or Aqara Hub gateway. M2, Update your firmware to the latest version and configure scripts in one application (either in Mi Home or Yandex) to avoid conflicts.