This document provides details on how you can set up your Twilio account.
Configuration Guide
The Teldio Edge Gateway is able to send SMS Text Messages as alarms via hosted text messaging services. Teldio’s recommended SMS service is Twilio.
SMS Integration Overview
Requirements:
- Active Twilio Account
- Internet connection for Teldio Edge Gateway
Costs (USD):
- Latest Prices: https://www.twilio.com/sms/pricing/us
- Dedicated Phone number: $1.00/month
- Text Message: $0.0075/message
- 100 Text messages a month will cost $1.00 for the number and $0.75 for the text messages for a total of $1.75.
- Initial trial account receives a credit of $14. During the trial period, every recipient’s number must be verified before receiving messages.
Twilio Account Set up
The Teldio Edge Gateway uses Twilio’s ‘Programmable SMS’ offering to send alarms as SMS messages. The following section walks you through setting up your own Twilio account.
- Go to https://www.twilio.com/try-twilio to set up an account and start a trial.
- A verification email will be sent to the entered email. Click on the link in the email to confirm the email address.
- As a second verification step, Twilio will ask you to enter in a cell phone number to receive a verification code. Enter in your cell phone number and click on ‘Verify’. Make sure to check the box at the bottom of the section to opt out of receiving onboarding support. Once you receive the text message with the code, enter it in to continue.
- At this point Twilio will ask you a series of questions to personalize your account.
- Select ‘Business’ under “Which best describes you?”
- Select ‘Direct Brand’ under “What kind of business?”
- Select ‘Business Owner or director’ under “How would you describe your role?”
- Select 'With 3rd party integration' under “How do you want to build with Twilio?”
- Select 'Notifications' under "What do you want to build with Twilio?"
- Select 'SMS' under "Which Channel are you interested in?"
- Finish by clicking the blue 'Let's go' button as shown above.
- Select ‘Business’ under “Which best describes you?”
- You will now be taken to a page to connect to 3rd-party applications. On this page, click the option to ‘Get a trial phone number’.
- You will be assigned a random number. Your new number will appear in your Account Info as “My Twilio phone Number”. This is the number from which the alarms will be sent.
- Once a number is selected, you will be presented with an Account SID and will be able to access your Auth Token. The Account SID, Auth Token, and Twilio phone number will be displayed under the Account Info. Save these values to a secure location.
- In the Trial account, you will be able to add up to two verified phone numbers to send SMS messages to without having to go through the Toll-free verification process or the A2P 10 DLC registration process. When you are ready to upgrade from the trial account, you will need to complete the aforementioned processes in order send SMS to non-verified US numbers. Please check the Appendix section of this document for links to these processes.
- To complete your Twilio Set up, click on ‘Upgrade’ next to the Trial balance at the top of the screen’.
You will be required to enter your main address, tax information, preferred account balance, automatic balance top-up, and payment method.
Adding Twilio to the Teldio Edge Gateway
The saved Twilio Account SID and Auth Token must be added to the Teldio Edge Gateway to finalize the SMS integration. You can enter in this information to the Teldio Edge Gateway by accessing the Modules section of the gateway and entering in the SID and Token values in the respective fields.
Appendix
Twilio U.S. A2P 10DLC Registration Guide
Click the link above to go to the document for help with completing U.S. A2P 10DLC Registration.
Twilio Toll-Free Verification Process Guide
Click the link above to go to the document for help with completing the Twilio Toll-Free verification.
Twilio Add an Emergency Address to Twilio Number Guide
Click the link above to go to the document for help with Adding an emergency address to a Twilio number.
For any questions, please contact Teldio Support at support@teldio.com.