Difference between revisions of "Twilio Notification"

From Hubitat Documentation
Jump to: navigation, search
(Changed formatting to match other Wiki docs)
Line 1: Line 1:
  
−
==Overview:==
+
===Description===
  
−
Twilio will allow you to send SMS messages from your Hubitat Hub.
+
Twilio allows you to send SMS messages from your Hubitat Elevation<sup>®</sup> hub based on Rule Machine<sup>®</sup> rules and Hubitat Elevation app notification settings.
  
−
Visit twilio.com to get an account and that gives you an Account SID and Auth Token (long long random letters and numbers.) and a unique phone number.
+
=== Setup overview ===
  
−
On Hubitat, create one (or more) virtual device(s) and assign it the Twilio driver.
+
# Visit twilio.com to obtain a user account
 +
# 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.
 +
# On your Hubitat Elevation<sup>®</sup> hub, create one or more virtual devices and assign Twilio driver to them.
 +
# Paste the two '''Tokens''' you received when creating your Twilio account.
 +
# Select '''Save'''.
 +
# Choose the '''phone number''' to send from and enter the '''phone number''' to send SMS notifications to.
 +
# Press '''Save'''.
 +
# Use the Twilio device(s) in your Rule Machine<sup>®</sup> rules and Hubitat Elevation<sup>®</sup> apps to send SMS notifications.
  
−
Paste in the two Tokens from creating a Twilio account. Save.
+
===Setup Details===
  
−
Select the Phone number to send from and type the phone number to send to.  Save.
+
# Sign up for a Twilio account at twilio.com
−
 
+
# Navigate to https://www.twilio.com/console to retrieve your '''Account SID''' and '''Auth Token'''[[File:TwilioConsole.png|none|thumb|800x800px]]
−
Use the Twilio device(s) in Rules and Apps to send notifications.
+
# Authorize a phone number to send messages to using https://www.twilio.com/console/phone-numbers/verified[[File:TwilioVerifiedNumbers.png|none|thumb|800x800px]]
−
 
+
# On your Hubitat Elevation® hub, select '''Devices''' then choose '''Add Virtual Device'''[[File:Add Virtual Device 2.0.png|none|thumb|800x800px]]
−
==Details==
+
# In '''Device Name''' field, enter the name of the device, (i.e. ''My Twilio Device'') and for the '''Type''' select ''Twilio Notification''
−
 
+
# Press '''Save Device'''[[File:TwilioHubitatNewDevice.png|none|thumb|800x800px]]
−
1. Sign up for a Twilio account at twilio.com
+
# 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.
−
 
+
# Press '''Save Preferences'''[[File:TwilioHubitatInitialPreferences.png|none|thumb|800x800px]]
−
2. Go to https://www.twilio.com/console to retrieve your Account SID and Auth Token
+
# 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.
−
 
+
# In the '''To Phone Number''' field, enter one of the phone numbers that were authorized to receive SMS messages in '''Step 3'''
−
[[File:TwilioConsole.png|600px]]
+
# Press '''Save Preferences'''[[File:TwilioHubitatFinalPreferences.png|none|thumb|800x800px]]
−
 
+
# The device is now able to be used by Rule Machine<sup>®</sup> rules and Hubitat Elevation<sup>®</sup> apps to send SMS notifications.
−
3. Authorize a phone number to send messages to using https://www.twilio.com/console/phone-numbers/verified
+
#* '''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.[[File:TwilioHubitatSendMessage.png|none|thumb|318x318px]]
−
 
 
−
[[File:TwilioVerifiedNumbers.png|600px]]
 
−
 
 
−
4. In Hubitat Click "Devices" then Click "Add Virtual Device"
 
−
 
 
−
5. In Device Name enter the name of the device, ie "My Twilio Device" for Type select "Twilio Notification" then click "Save Device"
 
−
 
 
−
[[File:TwilioHubitatNewDevice.png|600px]]
 
−
 
 
−
6. The device details page will open and you will enter the Account SID and Auth Token from Twilio into the input boxes and then click "Save Preferences"
 
−
 
 
−
[[File:TwilioHubitatInitialPreferences.png|600px]]
 
−
 
 
−
7. 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 the Twilio Site and you can enter one of the verified phone numbers that were entered on step 3 then click "Save Preferences".
 
−
 
 
−
[[File:TwilioHubitatFinalPreferences.png|600px]]
 
−
 
 
−
8. The device is now able to be used in Apps as a notification device or you can use it manually by entering a message in the Device Notification box and clicking the button.
 
−
 
 
−
[[File:TwilioHubitatSendMessage.png]]
 

Revision as of 22:30, 16 March 2020

Description

Twilio allows you to send SMS messages from your Hubitat Elevation® hub based on Rule Machine® rules and Hubitat Elevation app notification settings.

Setup overview

  1. Visit twilio.com to obtain a user account
  2. 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.
  3. On your Hubitat Elevation® hub, create one or more virtual devices and assign Twilio driver to them.
  4. Paste the two Tokens you received when creating your Twilio account.
  5. Select Save.
  6. Choose the phone number to send from and enter the phone number to send SMS notifications to.
  7. Press Save.
  8. Use the Twilio device(s) in your Rule Machine® rules and Hubitat Elevation® apps to send SMS notifications.

Setup Details

  1. Sign up for a Twilio account at twilio.com
  2. Navigate to https://www.twilio.com/console to retrieve your Account SID and Auth Token
    TwilioConsole.png
  3. Authorize a phone number to send messages to using https://www.twilio.com/console/phone-numbers/verified
    TwilioVerifiedNumbers.png
  4. On your Hubitat Elevation® hub, select Devices then choose Add Virtual Device
    Add Virtual Device 2.0.png
  5. In Device Name field, enter the name of the device, (i.e. My Twilio Device) and for the Type select Twilio Notification
  6. Press Save Device
    TwilioHubitatNewDevice.png
  7. 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.
  8. Press Save Preferences
    TwilioHubitatInitialPreferences.png
  9. 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.
  10. In the To Phone Number field, enter one of the phone numbers that were authorized to receive SMS messages in Step 3
  11. Press Save Preferences
    TwilioHubitatFinalPreferences.png
  12. The device is now able to be used by Rule Machine® rules and Hubitat Elevation® apps to send SMS notifications.
    • 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.
      TwilioHubitatSendMessage.png
Retrieved from "https://docs.hubitat.com/index.php?title=Twilio_Notification&oldid=2839"