Module: Phone Bandwidth

From Yombo
Jump to: navigation, search
Quick Facts
Links
Documentation
Repository
Issue tracker
Module Details
Created 2018-02-04 10:21:22 GMT
Developer Details
Prod Branch master
Prod Updated 2018-10-26 08:16:37
Prod Version 454f196766bd1d4693ec
Dev Updated 2018-02-02 22:59:03
Dev Version None

Allows Yombo gateway to communicate with phones using bandwidth.com. It can route notification alerts to phones as either SMS or MMS. It can optionally receive SMS message for controlling devices.

bandwidth.com

This modules uses bandwidth.com to handle sending and receiving SMS/MMS, a valid and paid account is required for this to work. Bandwidth.com is cheaper than Twilio and offers the same service level for our needs.

Master gateway only

This module will only work on the master / primary gateway. Installing this module on a non-master gateway will not cause problems, the module will not fully load and start.

Setup

Quick outline of steps:

  1. Add the phone module to your gateway.
  2. Create an account at bandwidth.com
  3. Select a phone number to associate to your account.
  4. Add funds to your account.
  5. Add this module to your gateway.
    • When adding this module, you'll need to enter the phone number and account credentails. This information is used to communicate with bandwidth.com. The account information will be encrypted and only available locally within the gateway.
  6. Restart the gateway
  7. Open the web configuration tool for the gateway.
  8. Goto 'Module Settings' and select 'Phone'.
  9. Add a new phone, ensuring the phone number is entered in the variables section.
  10. Goto 'Module Settings' and select 'Phone' again.
  11. Edit the notification targets for any new phones you added.
  12. Goto 'Module Settings' and select 'Phone Bandwidth'.
  13. Endable sending and/or receiving for any phones you wish to activate using bandwidth.com.
    • Optionally (highly recommended), supply a pin code that need to be included when sending commands to your gateway.
    • A pin is recommended since SMS to/from phone numbers can be spoofed and the system has no way to ensure the sender if really from the designated phone.


This page was last edited on 26 October 2018.