homebridge-twilio

homebridge-twilio

Homebridge plugin to make phone calls from a server using a static message. This plugin uses Twilio api, which is a paid service at a fair price - www.Twilio.com.

Very good use for homekit alarms and sensor, you can set an automation to call your phone if your alarm is triggered, there is a water leak or smoke detected.

---

Creating and maintaining Homebridge plugins consume a lot of time and effort, if you would like to share your appreciation, feel free to "Star" or donate.

Click here to review more of my plugins.

---

Twilio configuraions

To use this plugin, you need to signup to their website and get a phone number from their service it will use you in the config as twilioNumber.

Then, create a 'TwiML' from the Runtime menu under 'TwiML Bin', this is an xml format file which include the content of the call you want to make. more information can be found here: https://www.twilio.com/docs/api/twiml. Another option is to store the xml file on your own servers with external access.

XML example:

<?xml version="1.0" encoding="UTF-8"?>
<Response>
  	<Say voice="alice" loop="0" language="en-gb"> The Alarm is Triggered!
  	</Say>
</Response>

The link to your TwilML will be used in the config as xmlUrl.

the accountSid and authToken can be retrieved from https://www.twilio.com/console/account/settings

After you set all of those, you can move forward to installing the plugin on homebridge.

Installation

1. Install homebridge using: npm install -g homebridge
2. Install this plugin using: npm install -g homebridge-twilio
3. Update your configuration file. See sample-config.json in this repository for a sample.

Configuration

Please read carefully Twilio configurations first

Config.json sample:

"accessories": [
       {
           "accessory": "Twilio",
           "name": "Call David",
           "accountSid": "4352435f45f423456d652643dxre",
           "authToken": "RVGH54CG45G5TG354GRT45T45G4G", 
           "xmlUrl": "https://handler.twilio.com/twiml/32JKN23ljknl23rl23",
           "toNumber": "[phone]",
           "twilioNumber": "[phone]",
           "repeatCall": false
       }
   ]

• "repeatCall": true will make a second call if there was no answer from the recipient (voice machines will be marked as "answerd")