Difference between revisions of "Twilio Notification"

From Hubitat Documentation
Jump to: navigation, search
(Changed formatting to match other Wiki docs)
Line 1: Line 1:
 +
{{Top}}
  
===Description===
+
===<big>Description</big>===
  
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.
+
<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>
  
=== Setup overview ===
+
===<big>Setup overview</big>===
  
# Visit twilio.com to obtain a user account
+
#<big>Visit twilio.com to obtain a user account</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>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>
# On your Hubitat Elevation<sup>®</sup> hub, create one or more virtual devices and assign Twilio driver to them.
+
#<big>On your Hubitat Elevation hub, create one or more virtual devices and assign Twilio driver to them.</big>
# Paste the two '''Tokens''' you received when creating your Twilio account.
+
#<big>Paste the two '''Tokens''' you received when creating your Twilio account.</big>
# Select '''Save'''.
+
#<big>Select '''Save'''.</big>
# Choose the '''phone number''' to send from and enter the '''phone number''' to send SMS notifications to.
+
#<big>Choose the '''phone number''' to send from and enter the '''phone number''' to send SMS notifications to.</big>
# Press '''Save'''.
+
#<big>Press '''Save'''.</big>
# Use the Twilio device(s) in your Rule Machine<sup>®</sup> rules and Hubitat Elevation<sup>®</sup> apps to send SMS notifications.
+
#<big>Use the Twilio device(s) in your Rule Machine rules and Hubitat Elevation apps to send SMS notifications.</big>
  
===Setup Details===
+
===<big>Setup Details</big>===
  
# Sign up for a Twilio account at twilio.com
+
#<big>Sign up for a Twilio account at twilio.com</big>
# Navigate to https://www.twilio.com/console to retrieve your '''Account SID''' and '''Auth Token'''[[File:TwilioConsole.png|none|thumb|800x800px]]
+
#<big>Navigate to https://www.twilio.com/console to retrieve your '''Account SID''' and '''Auth Token'''</big>[[File:TwilioConsole.png|none|thumb|800x800px]]
# Authorize a phone number to send messages to using https://www.twilio.com/console/phone-numbers/verified[[File:TwilioVerifiedNumbers.png|none|thumb|800x800px]]
+
#<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]]
# On your Hubitat Elevation® hub, select '''Devices''' then choose '''Add Virtual Device'''[[File:Add Virtual Device 2.0.png|none|thumb|800x800px]]
+
#<big>On your Hubitat Elevation hub, select '''Devices''' then choose '''Add Virtual Device'''</big>[[File:Add Virtual Device 2.0.png|none|thumb|800x800px]]
# In '''Device Name''' field, enter the name of the device, (i.e. ''My Twilio Device'') and for the '''Type''' select ''Twilio Notification''
+
#<big>In '''Device Name''' field, enter the name of the device, (i.e. ''My Twilio Device'') and for the '''Type''' select ''Twilio Notification''</big>
# Press '''Save Device'''[[File:TwilioHubitatNewDevice.png|none|thumb|800x800px]]
+
#<big>Press '''Save Device'''</big>[[File:TwilioHubitatNewDevice.png|none|thumb|800x800px]]
# 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>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>
# Press '''Save Preferences'''[[File:TwilioHubitatInitialPreferences.png|none|thumb|800x800px]]
+
#<big>Press '''Save Preferences'''</big>[[File:TwilioHubitatInitialPreferences.png|none|thumb|800x800px]]
# 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>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>
# In the '''To Phone Number''' field, enter one of the phone numbers that were authorized to receive SMS messages in '''Step 3'''
+
#<big>In the '''To Phone Number''' field, enter one of the phone numbers that were authorized to receive SMS messages in '''Step 3'''</big>
# Press '''Save Preferences'''[[File:TwilioHubitatFinalPreferences.png|none|thumb|800x800px]]
+
#<big>Press '''Save Preferences'''</big>[[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.
+
#<big>The device is now able to be used by Rule Machine rules and Hubitat Elevation apps to send SMS notifications.</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.[[File:TwilioHubitatSendMessage.png|none|thumb|318x318px]]
+
#*<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]]

Revision as of 08:39, 22 March 2021

Go to the top of the page

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