# Google Assistant > Symcon documentation · English · generated on 2026-09-26 > Index: https://www.symcon.de/en/llms.txt Source: https://www.symcon.de/en/service/documentation/module-reference/voice-assistents/google-assistant/ _Requires Symcon >= 5.0_ ### Description The Google Assistant module enables the control of devices via Google Assistant. This includes the voice control via Google Home. ### Inclusion in IP-Symcon > **Note:** Using the Google Assistant module requires an active connection to the [Connect Service](connect-control.md), which in turn requires an active subscription. #### Create Google Assistant Instance Using the Google Assistant module requires its installation via the [Module Store](../components/management-console.md). First, the [Module Store](../components/management-console.md) needs to be opened. It can be found in the upper right area. The Google Assistant module can be found by entering "Assistant" into the search field. When opening the found module, the installation of the module can be started in the next dialog by clicking "Install". ![Find Module](https://www.symcon.de/media/pages/service/dokumentation/modulreferenz/sprachassistenten/google-assistant/cc2514fef3-1790424938/assistant-module-en.png) ![Install Module](https://www.symcon.de/media/pages/service/dokumentation/modulreferenz/sprachassistenten/google-assistant/b63a701b25-1790424938/assistant-module-install.png) Afterwards, an add dialog for creating an Google Assistant instance opens. If the instance should be added manually, an [Instance](../concepts.md) of the Google Assistant module needs to be created. This is done by opening the Object Tree. Here, the add button "+" at the bottom right needs to be clicked and [Instance](../concepts.md) selected. ![Add Instance](https://www.symcon.de/media/pages/service/dokumentation/modulreferenz/sprachassistenten/google-assistant/c31bcd1317-1790424938/assistant-add-instance-en.png) In the module list, select the device "Google Assistant" or "Google Home" from the vendor "Google". The location should not be changed. The name can be chosen at will. Finally, confirm with "OK". ![Create Instance](https://www.symcon.de/media/pages/service/dokumentation/modulreferenz/sprachassistenten/google-assistant/74f3263f24-1790424938/assistant-create-instance-en.png) After the creation of the Google Assistant instances, it is opened automatically and can be configured. #### Configure Google Assistant Instance The module offers multiple device types that can be used. Especially the initial setup can be sped up significantly by using the Device Search. Later on, additional devices can easily be added manually. The Device Search is started by clicking the button "Search for Devices" at the top of the instance configuration. ![Open Device Search](https://www.symcon.de/media/pages/service/dokumentation/modulreferenz/sprachassistenten/google-assistant/a07591acf1-1790424938/assistant-search-for-devices-1-en.png) Then, a dialog is opened. After a loading time, found devices that are not yet implemented into Alexa are shown. These instances are seperated by device type. Below each instance, the status variables that are used upon implementation are shown. If an instance should be implemented, the check box at the beginning of the instances row must be checked. By default, the name of the instance is used. If it should be updated, the "Edit" button at the right of the list entry can be clicked. After all desired instances are selected and eventually their names updated, the selection is confirmed by clicking "Add Devices". Then, the selected devices are added to the respective lists in the instance configuration. ![Select Devices](https://www.symcon.de/media/pages/service/dokumentation/modulreferenz/sprachassistenten/google-assistant/3609412c24-1790424938/assistant-search-for-devices-2-en.png) To prepare a device manually, expand its panel and create a new entry in its list by clicking "Add" below the list. ![Add Device](https://www.symcon.de/media/pages/service/dokumentation/modulreferenz/sprachassistenten/google-assistant/c80b865376-1790424938/assistant-add-device-1-en.png) Each entry requires a name, under which the device will be known to Google Assistant. Additional parameters depend on the device type and can be found in the corresponding site of the documentation. After setting all parameters, confirm with "OK". ![Configure Device](https://www.symcon.de/media/pages/service/dokumentation/modulreferenz/sprachassistenten/google-assistant/78dc7779bd-1790424938/assistant-add-device-2-en.png) #### Possible Device Types * [Light (Switch)](amazon-alexa.md) * [Light (Dimmer)](amazon-alexa.md) * [Light (Color)](amazon-alexa.md) * [Light (Expert)](amazon-alexa.md) * [Thermostat](../components/object-presentation.md) * [Shutter](../components/object-presentation.md) * [Generic Switch](amazon-alexa.md) * [Scenes](../components/object-presentation.md) * [Scenes (deactivatable)](amazon-alexa.md) After all devices are configured, confirm the settings by clicking "Apply Changes". ![Apply Changes](https://www.symcon.de/media/pages/service/dokumentation/modulreferenz/sprachassistenten/google-assistant/fcc391b53d-1790424938/assistant-apply-changes-en.png) After applying, it is recommended to check that the column "Status" contains "OK" for all devices. If this is not the case, the column contains an error message that contains further information about the complication. It should also be checked that the label at the top of the instance states "Status: Symcon Connect is OK". Otherwise, the [Connect Service](connect-control.md) needs to be activated. ![Check Status](https://www.symcon.de/media/pages/service/dokumentation/modulreferenz/sprachassistenten/google-assistant/97c3a1d84a-1790424938/assistant-check-en.png) #### Connect IP-Symcon to Google Assistant Finally, IP-Symcon needs to be connected to Google Assistant so the Google Assistant instance can receive requests from Google. The installation is done with the Google Home app. Within the app, select the home control tab at the bottom left and tap on "Add". ![Home Control](https://www.symcon.de/media/pages/service/dokumentation/modulreferenz/sprachassistenten/google-assistant/49d4b25cdb-1790424938/assistant-add-skill-1.png) Tap "Set up device" in the menu. ![Set up device](https://www.symcon.de/media/pages/service/dokumentation/modulreferenz/sprachassistenten/google-assistant/1187a55a21-1790424938/assistant-add-skill-2-en.png) Tap "Have something already set up?". ![Have something already set up](https://www.symcon.de/media/pages/service/dokumentation/modulreferenz/sprachassistenten/google-assistant/1c42500817-1790424938/assistant-add-skill-3-en.png) Tap "Symcon" in the displayed list. ![Connect to IP-Symcon](https://www.symcon.de/media/pages/service/dokumentation/modulreferenz/sprachassistenten/google-assistant/c061652065-1790424938/assistant-connect-1-en.png) Enter the e-mail address, that the IP-Symcon is registered to, in the popup and confirm with "Send verification code". ![Enter E-Mail](https://www.symcon.de/media/pages/service/dokumentation/modulreferenz/sprachassistenten/google-assistant/bd05270fa2-1790424938/assistant-connect-2.png) An e-mail with a code is sent to the provided e-mail address. Enter the code from the e-mail into the popup and confirm with "Verify code". ![Enter Code](https://www.symcon.de/media/pages/service/dokumentation/modulreferenz/sprachassistenten/google-assistant/08f6669352-1790424938/assistant-connect-3.png) After successful confirmation, the prepared devices appear in the Google Home app and can be used. ![Request device update](https://www.symcon.de/media/pages/service/dokumentation/modulreferenz/sprachassistenten/google-assistant/d81236c782-1790424938/assistant-update-devices.png) ## Expert Options Source: https://www.symcon.de/en/service/documentation/module-reference/voice-assistents/google-assistant/expert-options/ _Requires Symcon >= 5.0_ > **Warning:** The Expert Options usually do not need to be adjusted. Handle these options carefully to ensure that the Google Assistant module works as intended. ### Options | Name | Description | | --------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | Emulate Status | If Emulate Status is active, the module does not wait for the update of switched variables. Instead, it returns the new state based on the triggered value. | | Request device update | A device update can be requested from Google with this button, synchronizing the configured devices again with Google Assistant. This is usually done automatically when applying changes. | ## Generic Switch Source: https://www.symcon.de/en/service/documentation/module-reference/voice-assistents/google-assistant/generic-switch/ _Requires Symcon >= 5.0_ ### Description Devices of the type Generic Switch can be switched On or Off. Within Google Assistant, the device is interpreted as a common switch and can be used for different devices. ### Parameter | Name | Description | | --------------- | ------------------------------------------------------------ | | Name | Name that is used to address the device via Google Assistant | | Switch Variable | A triggerable variable of type Boolean | #### Possible Actions | Action | Description | Possible Sentence for Activation | | ---------------- | ------------------------------------- | --------------------------------- | | Switch On or Off | Trigger the variable to True or False | "Ok Google, switch __ on." | #### Device Search An instance must have status variables with the fitting profiles to be detected by the device search. | Variable | Possible Profiles | | --------------- | ----------------- | | Switch Variable | ~Switch | ## Light (Dimmer) Source: https://www.symcon.de/en/service/documentation/module-reference/voice-assistents/google-assistant/light-dimmer/ _Requires Symcon >= 5.0_ ### Description Devices of the type Light (Dimmer) describe lamps that can be dimmed. ### Parameter | Name | Description | | -------- | ------------------------------------------------------------------- | | Name | Name that is used to address the device via Google Assistant | | Variable | A triggerable variable of type Integer or Float that dims the light | #### Possible Actions | Action | Description | Possible Sentence for Activation | | ---------------- | --------------------------------------- | ---------------------------------- | | Switch On or Off | Trigger the variable to 100% or 0% | "Ok Google, switch __ on." | | Dim | Trigger the variable to the given value | "Ok Google, dim __ to 40%." | #### Device Search An instance must have status variables with the fitting profiles to be detected by the device search. | Variable | Possible Profiles | | -------- | -------------------------------------------- | | Variable | ~Intensity.100, ~Intensity.255, ~Intensity.1 | ## Light (Expert) Source: https://www.symcon.de/en/service/documentation/module-reference/voice-assistents/google-assistant/light-expert/ _Requires Symcon >= 5.0_ ### Description Devices of the type Light (Expert) describe lamps whose properties within multiple variables can be switched independently. ### Parameter | Name | Description | | ------------------- | ------------------------------------------------------------------------------------------------------------------ | | Name | Name that is used to address the device via Amazon Alexa | | Switch Variable | A triggerable variable of type Boolean, that switches the light on or off | | Brightness Variable | A triggerable variable of type Integer or Float that dims the light (optional) | | Color Variable | A triggerable Variable of type Integer with the profile ~HexColor, that triggers the color of the light (optional) | > **Note:** If optional variables are not set, Google recognizes that the lamp does not have the corresponding properties. If optional variables are set later on, a device update is required to discover the changed properties. #### Possible Actions | Action | Description | Possible Sentence for Activation | | ---------------- | -------------------------------------------------- | ------------------------------------- | | Switch On or Off | Trigger the Switch Variable to True or False | "Ok Google, switch __ on." | | Dim | Trigger the Brightness Variable to the given value | "Ok Google, dim __ to 40%." | | Switch Color | Trigger the Color Variable to the given color | "Ok Google, switch __ to red." | #### Device Search An instance must have status variables with the fitting profiles to be detected by the device search. To be detected as Expert light, at least the Switch Variable and another variable need to be detected. | Variable | Possible Profiles | | ------------------- | -------------------------------------------- | | Switch Variable | ~Switch | | Brightness Variable | ~Intensity.100, ~Intensity.255, ~Intensity.1 | | Color Variable | ~HexColor | ## Light (Color) Source: https://www.symcon.de/en/service/documentation/module-reference/voice-assistents/google-assistant/light-color/ _Requires Symcon >= 5.0_ ### Description Devices of the type Light (Color) describe lamps, that can be switched to any color. ### Parameter | Name | Description | | -------- | ------------------------------------------------------------------------------------------------------- | | Name | Name that is used to address the device via Google Assistant | | Variable | A triggerable Variable of type Integer with the profile ~HexColor, that triggers the color of the light | #### Possible Actions | Action | Description | Possible Sentence for Activation | | ---------------- | -------------------------------------------------------------- | ------------------------------------- | | Switch On or Off | Trigger the variable to white or black | "Ok Google, switch __ on." | | Dim | Trigger the brightness of the current color to the given value | "Ok Google, dim __ to 40%." | | Switch Color | Trigger the variable to the given color | "Ok Google, switch __ to red." | #### Device Search An instance must have status variables with the fitting profiles to be detected by the device search. | Variable | Possible Profiles | | -------- | ----------------- | | Variable | ~HexColor | ## Light (Switch) Source: https://www.symcon.de/en/service/documentation/module-reference/voice-assistents/google-assistant/light-switch/ _Requires Symcon >= 5.0_ ### Description Devices of the type Light (Switch) describe lamps that can be switched on or off. ### Parameter | Name | Description | | -------- | ------------------------------------------------------------------------- | | Name | Name that is used to address the device via Google Assistant | | Variable | A triggerable variable of type Boolean, that switches the light on or off | #### Possible Actions | Action | Description | Possible Sentence for Activation | | ---------------- | -------------------------------------- | --------------------------------- | | Switch On or Off | Triggers the variable to True or False | "Ok Google, switch __ on." | #### Device Search An instance must have status variables with the fitting profiles to be detected by the device search. | Variable | Possible Profiles | | --------------- | ----------------- | | Switch Variable | ~Switch | ## Shutter Source: https://www.symcon.de/en/service/documentation/module-reference/voice-assistents/google-assistant/shutter/ _Requires Symcon >= 5.0_ ### Description Devices of the type Shutter can be opened and closed. If the device supports percentual opening, this is controllable as well. ### Parameter | Name | Description | | ---------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Name | Name that is used to address the device via Google Assistant | | Shutter Variable | A triggerable variable of type Integer or Float, with the profile ~ShutterMoveStop or ~ShutterMoveStep. Alternatively, a variable can be used that has defined minimum and maximum values from its profile | #### Possible Actions | Action | Description | Possible Sentence for Activation | | ------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ---------------------------------- | | Open | Switch the variable to "Open" if it has a ~ShutterMove profile. Otherwise the variable is switched to the minimal value of the profile. | "Ok Google, open __" | | Close | Switch the variable to "Close" if it has a ~ShutterMove profile. Otherwise the variable is switched to the maximum value of the profile. | "Ok Google, close __" | | Percentual Opening | If the variable has a ~ShutterMove profile, switch it to "Open" if the percentual value is more than 50% and to "Close" otherwise. If the variable has another profile, the variable is switched according to the percentual value. It should be considered that the variable is switched to 0% if it is completely opened and other percentual values are applied analogously. For example, opening by 30% will result in 70% for the variable. | "Ok Google, open __ by 30%" | #### Device Search An instance must have status variables with the fitting profiles to be detected by the device search. | Variable | Possible Profiles | | --------------- | -------------------------------------------------------------------------------- | | Switch Variable | ~ShutterMoveStop, ~ShutterMoveStep, ~Intensity.100, ~Intensity.255, ~Intensity.1 | ## Scenes Source: https://www.symcon.de/en/service/documentation/module-reference/voice-assistents/google-assistant/scenes/ _Requires Symcon >= 5.0_ ### Description Devices of the type Scene can be activated and execute any kind of action. ### Parameter | Name | Description | | ------ | ------------------------------------------------------------ | | Name | Name that is used to address the device via Google Assistant | | Action | An action that is executed on activation of the scene | #### Possible Actions | Action | Description | Possible Sentence for Activation | | -------------- | ------------------ | -------------------------------- | | Activate Scene | Execute the action | "Ok Google, activate __." | #### Device Search This device type is not supported by the device search. ## Scenes (deactivatable) Source: https://www.symcon.de/en/service/documentation/module-reference/voice-assistents/google-assistant/scenes-deactivatable/ _Requires Symcon >= 5.0_ ### Description Devices a the type Scene (deactivatable) can be activated and deactivated and execute any kind of action in the process. ### Parameter | Name | Description | | ----------------- | ------------------------------------------------------------ | | Name | Name that is used to address the device via Google Assistant | | Activate Action | An action that is executed on activation of the scene | | Deactivate Action | An action that is executed on deactivation of the scene | #### Possible Actions | Action | Description | Possible Sentence for Activation | | ---------------- | ----------------------------- | ---------------------------------- | | Activate Scene | Execute the Activate Action | "Ok Google, activate __." | | Deactivate Scene | Execute the Deactivate Action | "Ok Google, deactivate __." | #### Device Search This device type is not supported by the device search. ## Thermostat Source: https://www.symcon.de/en/service/documentation/module-reference/voice-assistents/google-assistant/thermostat/ _Requires Symcon >= 5.0_ ### Description Devices of the type Thermostat can set temperatures. ### Parameter | Name | Description | | ------------------- | ----------------------------------------------------------------------------- | | Name | Name that is used to address the device via Amazon Alexa | | Setpoint | A triggerable variable of type Float that sets the setpoint temperature in °C | | Ambient Temperature | A variable of type Float that contains the ambient temperature in °C | #### Possible Actions | Action | Description | Possible Sentence for Activation | | --------------- | -------------------------------------------------- | ----------------------------------- | | Set Temperature | Trigger the variable toward the given temperature. | "Ok Google, set __ to 22 °C" | #### Device Search This device type is not supported by the device search.