There are a number of different ways that giving the system the ability to send emails can be useful. This can be used to send the end-user emails based on events or functions of the system. Or it can be used to send the tech emails when the end user is accessing something that may be of concern.
SendGrid Email Notifications
There are never too many ways in how the Automation System can notify the user. This tool allows the system to send the user emails of events occurring in the automation system, such as a compatible alarm system noticing an intruder.
This tool can also report how many emails are sent from the automation system the current day and how many emails are sent from the SendGrid account.
SendGrid Tool is a tool that allows the Automation System to send emails in macros. The SendGrid Tool uses the SendGrid service and requires a SendGrid account. One account can be used on multiple Automation Systems.
End User Emails
This can be implemented in so many ways that could be helpful. Anything the user wants to know happens with the system can be sent in an email. This is also nice because it gives the customer a timestamp that can be referred back to later. Emails can allow the user to have more information sent to them in an unobtrusive way.
Think about having the ability for the system to send the tech an email when the user access the controls for their IP resettable power device. This gives the tech the opportunity to call the client and find out what they are having trouble with. Thats customer service at its best.
Dash App Documentation Overview
This page will guide you through the installation, configuration, and programming of the specified Dash App. You can navigate to various sections of the documentation by using the menu to the left. New information is always being added to Dash’s Documentation so be sure to check back often to discover new ways to utilize your apps!
My > IP Database > AUX > Dash Apps > SendGrid Email Notifications
Dash – SendGrid Email Notifications.csd
Dash OS Update History
Whenever an update is available for a Dash App, a log of the major changes in the version will be provided below. This does not necessarily reflect every change that was made as some minor changes may have been made that are undocumented, but it should reflect any changes that affect the operation of the Dash App.
Download & Import the Dash App
In order for the Dash App to become recognized by the URC Programming Software we will need to import the provided TCM File into the Software. Once this has been done properly the Dash App should show up in the “Add Other Devices” programming step in the “Accelerator Location” provided on the overview tab.
In your Programming Software locate the “Import TCM Files” button in the File tab of the top menu toolbar. Click it to open the Windows File Browsing window. Browse to the TCM file you wish to import and select it.
Based on the Dash App / Module you are importing, a dialog similar to the below will appear. This window indicates what interfaces are supported by the TCM File you selected. System Plugins may only show “Driver” and “Base Station Files” when no User Interface is provided by the module.
After Importing your TCM File it is always safe to quickly restart your Accelerator Software to make sure your changes are properly made. While this isn’t required every time, it is a good step to make sure everything is changed as needed.
Confirm that the Dash App was successfully imported. You can do this by navigating to the driver where the Dash App is installed (see Overview Tab) and making sure a checkbox is provided for “8. Select 2-Way Modules for Network Remotes / Keypads”
Non URC Network Setup
Network Setup is a step that is required regardless of if the module is communicating with a physical device. This step will go over how your Network Setup should be configured for this Dash App. You will generally find the Dash App under “Network Setup > Non URC Device” in your URC Program.
This Dash App does not require that a specific IP Address is setup for it to operate. However, it should be assigned an “Instance ID.” When a module does not require a specific IP Address be setup, you can assign any IP Address to the Dash App that is unique from any other device in the list.
Your IP Address will be used as an “Instance ID” which will separate it from any other Dash Apps or URC Modules you have setup. This ID is helpful when you want to create jumps to the Dash App / Module in multiple rooms / areas of your programming.
In the example below we have added two Dash Apps, “System Monitor” and “Time Tools.” Each has been given a unique value “0.0.0.1” and “0.0.0.2.” If they were assigned the same value the Dash App would result in an error and would not start up properly.
Step 11. 3rd Party 2-Way Settings
Properly configuring the Dash App Parameters in your Automation Programming Software is important in order to make the App work as you want it to. These Parameters will be used each time the App starts up to configure how the App will operate. Below we will go over each available parameter.
Here we will need to enter our credentials from our SendGrid account.
api_name – the username for the sendgrid account
api_key – the password for the sendgrid account
Dash App Feature Tour / Walkthroughs
Welcome to the Dash App Feature Tour! This page will go over the features available to you when using the Dash App within your Dash OS-powered systems. These tours may include specific programming guides, file examples, drivers, or simply detailed explanations of the features listed on the Product Description tab. Use the tabs to the left to select a feature that you would like to learn more about! Enjoy!
Sending An Email
Emails are sent from macros using TCL Commands. All Parameters for this command are required.
To Email – Recipient Email Address
To Name – Name of the Recipient
From Email – Sender’s Email Address
From Name – Name of the sender
Subject – The Email’s subject
Text – The body of the email
Get A Count For Daily Emails Sent
The module supports two different counters for sent emails. “Number of daily emails sent from this controller” and “Number of daily emails sent from account”.
“Number of daily emails sent from this controller” is counted locally within the base station. The value can be saved to a URC Integer Variable.
“Number of daily emails sent from account” is based on the official statistics from SendGrid. The return value can be saved to a URC Integer Variable. This count will be updated with a few minute delay.