|
|
| Line 1: |
Line 1: |
| − | {{Top}}
| + | <big>'''We're moving!''' Please visit http://docs2.hubitat.com for the latest documentation.</big> |
| | | | |
| − | ===<big>Description</big>===
| + | <big> |
| − | | + | This document is available at: http://docs2.hubitat.com/devices/twilio-notification |
| − | <big>Twilio allows you to send SMS messages from your Hubitat Elevation hub based on Rule Machine rules and Hubitat Elevation app notification settings.</big>
| + | </big> |
| − | | |
| − | ===<big>Setup overview</big>===
| |
| − | | |
| − | #<big>Visit twilio.com to obtain a user account</big>
| |
| − | #<big>This provide you with an '''Account SID''' and '''Auth Token''' (a string of long random letters and numbers), as well as a unique phone number.</big>
| |
| − | #<big>On your Hubitat Elevation hub, create one or more virtual devices and assign Twilio driver to them.</big>
| |
| − | #<big>Paste the two '''Tokens''' you received when creating your Twilio account.</big>
| |
| − | #<big>Select '''Save'''.</big>
| |
| − | #<big>Choose the '''phone number''' to send from and enter the '''phone number''' to send SMS notifications to.</big>
| |
| − | #<big>Press '''Save'''.</big>
| |
| − | #<big>Use the Twilio device(s) in your Rule Machine rules and Hubitat Elevation apps to send SMS notifications.</big>
| |
| − | | |
| − | ===<big>Setup Details</big>===
| |
| − | | |
| − | #<big>Sign up for a Twilio account at twilio.com</big>
| |
| − | #<big>Navigate to https://www.twilio.com/console to retrieve your '''Account SID''' and '''Auth Token'''</big>[[File:TwilioConsole.png|none|thumb|800x800px|link=https://docs.hubitat.com/images/8/8e/TwilioConsole.png
| |
| − | ]]
| |
| − | #<big>Authorize a phone number to send messages to using https://www.twilio.com/console/phone-numbers/verified</big>[[File:TwilioVerifiedNumbers.png|none|thumb|800x800px|link=https://docs.hubitat.com/images/8/8a/TwilioVerifiedNumbers.png
| |
| − | ]]
| |
| − | #<big>On your Hubitat Elevation hub, select '''Devices''' then choose '''Add Virtual Device'''</big>[[File:Add Virtual Device 2.0.png|none|thumb|800x800px|link=https://docs.hubitat.com/images/5/5c/Add_Virtual_Device_2.0.png
| |
| − | ]]
| |
| − | #<big>In '''Device Name''' field, enter the name of the device, (i.e. ''My Twilio Device'') and for the '''Type''' select ''Twilio Notification''</big>
| |
| − | #<big>Press '''Save Device'''</big>[[File:TwilioHubitatNewDevice.png|none|thumb|800x800px|link=https://docs.hubitat.com/images/e/e8/TwilioHubitatNewDevice.png
| |
| − | ]]
| |
| − | #<big>The device details page will open and you will enter the '''Account SID''' and '''Auth Token''' from your Twilio account in the fields as shown below.</big>
| |
| − | #<big>Press '''Save Preferences'''</big>[[File:TwilioHubitatInitialPreferences.png|none|thumb|800x800px|link=https://docs.hubitat.com/images/f/f3/TwilioHubitatInitialPreferences.png
| |
| − | ]]
| |
| − | #<big>The page will reload and you will be given the option to select the '''From Phone Number''' which will be the same as the one listed on your Twilio Dashboard.</big>
| |
| − | #<big>In the '''To Phone Number''' field, enter one of the phone numbers that were authorized to receive SMS messages in '''Step 3'''</big>
| |
| − | #<big>Press '''Save Preferences'''</big>[[File:TwilioHubitatFinalPreferences.png|none|thumb|800x800px|link=https://docs.hubitat.com/images/1/14/TwilioHubitatFinalPreferences.png
| |
| − | ]]
| |
| − | #<big>The device is now able to be used by Rule Machine rules and Hubitat Elevation apps to send SMS notifications.</big>
| |
| − | #*<big>'''NOTE''': You may test your setup by entering a message in the text field below the '''Device Notification''' button of the Twillo Device details page. Press the '''Device Notification''' button to sent the test SMS message.</big>[[File:TwilioHubitatSendMessage.png|none|thumb|318x318px|link=https://docs.hubitat.com/images/c/c9/TwilioHubitatSendMessage.png]]
| |
