ISY Portal Amazon Echo Integration

From Universal Devices, Inc. Wiki
Revision as of 17:15, 29 June 2016 by Mkohanim (Talk | contribs)

Jump to: navigation, search

Please follow the instructions here to setup Echo to work with your ISY:

Important Information

  • Smart Home API is now on V2 and V1 will be obsolete and non-functional by 08-01-2016. If you are still on V1, please follow the instructions Instructions for Migrating from V1 to V2 below
  • You need to follow the instructions under Instructions for Smart Home API below
  • Amazon Echo Connected API currently only supports on/off devices, thermostats, programs, and scenes
  • For programs, turn on/off <program name>:
    • On: runs the If
    • Off: runs the Else
  • Currently, for door locks, you can either use programs or use Skills (video tutorial below)

Instructions for Migrating from V1 to V2

  • Login to the Echo app
  • Click on the Smart Home menu item on the left navigation bar
  • Look for ISY Optimized for Smart Home and then click on the Disable button
  • Click on Get More Smart Home Skills
  • Search for ISY
  • Click the Enable button next to ISY Optimized for Smart Home V2
  • Click on the Smart Home menu item on the left navigation bar again make sure ISY Optimized for Smart Home V2 shows up under Your Smart Home Skills
  • Click on Forget all devices and groups
  • Click on Discover Devices. This will bring in all the devices you have created a mapping for in your ISY Portal


ISY Portal/MobiLinc Limitations

  • If you already have MobiLinc Connect service, it will have to be deactivated. Please send an email to
  • ISY Portal does work with MobiLinc App using these instructions

Instructions for Accessing ISY Portal

Please make sure you have ISY Portal Installed and Configured first.


Instructions for Smart Home API

  • Make sure you have followed all the steps in In Instructions for Accessing ISY Portal above
  • Log into ISY Portal (my.isy.io), click on My Profile at the top right corner
  • Choose your ISY from Preferred ISY drop down
  • Click on Link this profile to an Amazon account
  • Under Select Tool choose Connectivity | Amazon Echo and enter mappings between your devices, scenes, and programs to their associated and desired spoken names
  • Login to the Echo app
  • Click on the Smart Home menu item on the left navigation bar
  • Under Your Smart Home Skills, click on Get More Smart Home Skills
  • Search for ISY
  • Click the Enable button next to ISY Optimized for Smart Home V2
  • Click on the Smart Home menu item on the left navigation bar again make sure ISY Optimized for Smart Home shows up under Your Smart Home Skills
  • Click on Discover Devices. This will bring in all the devices you have created a mapping for in your ISY Portal
  • Please note that every time you change spoken fields, you must redo the previous step
  • Only the following on/off commands may be used:
    • Discover: “Alexa, discover my devices” - refreshes the devices from the portal
    • Turn On: “Alexa, turn on the kitchen light” - works for devices, scenes, and programs (runs Then)
    • Turn Off: “Alexa, turn off the kitchen light” - works for devices, scenes, and programs (runs Else)
    • Brighten: “Alexa, brighten the kitchen light” - works only for devices
    • Dim: “Alexa, dim the kitchen light” - works only for devices
    • Set: “Alexa, set the kitchen light to 50%” - works only for devices
  • For Thermostats only the following commands may be used:
    • Set [device] temperature to [##] degrees: "Alexa, set bedroom to 75 degrees"
    • Increase the [device] temperature: "Alexa, increase the bedroom temperature"
    • Decrease the [device] temperature: "Alexa, decrease the family room temperature"
    • Turn off [device]: "Alexa, turn off kitchen"
  • Thermostat operation: depending on the current mode, here's what happens when you set the temperature:
    • If the thermostat is already in Heat or Cool, it will simply adjust the corresponding setpoint
    • If the thermostat is in Auto mode, it will adjust the appropriate setpoint in order to reach the desired temperature
    • If the thermostat is set to off, it will adjust itself to heat or cool, and adjust the corresponding setpoint in order to reach the desired temperature

Instructions for using Multiple ISYs with one Echo Accout

  • The device discovery works only with the preferred ISY. So, if you want to control devices from 2 ISYs, you have to set the preferred ISY to the first ISY, run a device discovery, change the preferred ISY to the second ISY, then discover again.
  • Then, all devices from the 2 ISYs will be available in the echo app.
  • Please note that in the echo app, the devices from the first ISY will be shown as "offline". You can ignore this, the device will work. This just means that this particular device was not reported by the last device discovery, which is normal due to the fact that the device discovery works only with one ISY at a time.


Instructions for using Multiple Echos Smart Home

  • Have your echos tied to 2 different amazon accounts.
  • In the ISY Portal:
    • Create a sub-account
    • Add your ISY to this sub-account, and approve access to it in the admin console.
    • Create a user profile in this sub-account for the second echo
    • Link this user profile with your second echo's amazon account.
    • To edit spokens for your second echo, switch to your sub-account first
    • To edit spokens for your first echo, switch to your root account first

Of course, you can have as many echo as you want, with each their own sub-account, user profile and set of spokens.

Also, it is not required to have a primary echo in the primary account. All echos could be managed in sub-accounts only.

For those of you who already had sub-accounts, you will start with the same spokens in each accounts/sub-accounts for all of your echos. When you add/edit/delete your spokens, the change will be applicable to that account only. Including the Delete all.

NOTE: If your account selector is set to [All], you will see all of your ISYs, no matter which account/sub-account they belong to. When an ISY is in several account/sub-accounts, you will see it only once. When you edit your spokens, without explicitly choosing the account, you can't be sure of the context of which account you are working on. You should switch to the intended account first.

Instructions for Alexa Skill

  • You can use Alexa Skills (tell izzy to <do something> <name>) for thermostats, door locks, programs, and lights
  1. Login to the Echo app
  2. From the menu on the left, choose Skills
  3. Search for ISY or izzy
  4. Click on the Enable button