RBoy Apps
INSTALLING RENTAL LOCK AUTOMATER
NOTE: You need to use the SmartThings Classic mobile app and NOT the new SmartThings mobile app.
  1. Click on the Rental Lock Automater Smart App, it will open a new window with the code, select all (Ctrl+A) and copy the code (Ctrl+C)
  2. Login to your SmartThings IDE at https://graph.api.smartthings.com (create a login if you don't have one AND don't forget to opt-in for the developer account). To verify that you're logged into the correct location, after logging into the above link, click on "My Locations" and then click on the name of the location where you want to install the SmartApp. Note: You may be asked to log into your account again when you click on your location, if so login again.
  3. Click on "My SmartApps
  4. Click on "+New SmartApp" on the top right 
  5. Click "From Code
  6. Paste the code (Ctrl + V) into the editor and click "Create
  7. Click "Publish" and then "For me" on the top right
  8. To install the SmartApp, open your SmartThings Classic App on your phone, click on the Automation icon at the bottom bar right corner of the main screen. Now click on the "SmartApps" tab on the top right of the screen. Scroll down to the bottom and click on "+Add a SmartApp". Then scroll down to the bottom and click on "My Apps" section and click it. (NOTE: if you don't see "My Apps" please contact SmartThings support, if you don't see the SmartApp in "My Apps", then you may have installed the code on the wrong 'Shard', please check step 2 again)
  9. Scroll down the "My Apps" section until you see the new Rental Lock Automater SmartApp you just created and click on it on install it. You're done! To open/configure the app in future follow step 10.
  10. After installing the SmartApp, configure/open it by clicking on the "Automations" icon  and then click on "SmartApps" on your phone. NOTE: Clicking on the SmartApp in the "My Apps" section will install a NEW instance of the SmartApp instead of opening the existing installation.
  11. After opening the app:
    • Select the locks you want to use across all properties/units
    • Click on Manage properties
    • Set the number of units/properties connected to the hub
      • Click on each unit, enter the name, iCalendar URL's and select the locks for the unit (you can share common locks among units only within the same app, locks should not be shared across multiple instances of the app). Click Done/Save
      • Scroll down and configure the remaining settings like advance activation, automatic code generation options, SMS, notification etc. Click Done/Save
    • If additional users are required, change the number of users
    • Click on Manage users to review/change individual user settings. You can extend check out/in dates/times for automatically generated renters here and also configure manual users (e.g. owners, cleaners etc). Click Done/Save
    • Set the notifications options. Click Done/Save
    • Code programming should start within a minute or so. See the RLA FAQ's page for tips and answers to common questions

FOR UPDATING EXISTING SMARTAPP WITH A NEWER VERSION OF THE CODE:
  • Click on the Rental Lock Automater Smart App, it will open a new window with the code, click on the browser refresh button (to flush the cache), select all (Ctrl+A) and copy the code (Ctrl+C)
  • Login to your SmartThings IDE at https://graph.api.smartthings.com. To verify that you're logged into the correct location, after logging into the above link, click on "My Locations" and then click on the name of the location where you want to install the SmartApp. Note: You may be asked to log into your account again when you click on your location, if so login again.
  • Click on "My SmartApps"
  • Click on the SmartApp you want to update in the SmartThings IDE
  • Select all (Ctrl+A) and delete the old code, Paste (Ctrl+V) the new code
  • Click on "Save"
  • Click  on "Publish" and then "For Me", if you don't so this the update won't work
  • IMPORTANT, DON'T SKIP THIS STEP: Open the SmartApp on your phone by clicking on the "Automations" icon  and then click on "SmartApps" on on your phone. Open the Rental Lock Automater SmartApp you just updated, check/update your settings and tap "Save". If you don't do this last step the SmartApp may not work.