Features

• HomeKit Trigger to SMS - Wire any HomeKit accessory to send an SMS
• Multiple Recipients - Comma-separate phone numbers in the to array
• Flash SMS - Optional flash mode that bypasses the inbox
• Performance Tracking - Optional URL shortening + click tracking
• Foreign ID & Label - Tag messages for downstream tracking

Prerequisites

• Homebridge 1.x
• A seven account with API key (How to get your API key)

Installation

npm i -g homebridge
npm i -g @seven.io/homebridge-sms

Configuration

Add a Sms77Sms accessory to your Homebridge config.json:

{
  "accessories": [
    {
      "accessory":            "Sms77Sms",
      "apiKey":               "InsertSuperSecretApiKey",
      "debug":                false,
      "flash":                false,
      "foreign_id":           null,
      "from":                 "MyBookStore",
      "label":                null,
      "name":                 "SMS to employees on smoke detection",
      "no_reload":            false,
      "performance_tracking": false,
      "text":                 "Emergency: The smoke detection has triggered!",
      "to":                   ["+49876543210", "+490123456789"],
      "ttl":                  null
    }
  ]
}

| Field | Description | |-------|-------------| | accessory | Must be Sms77Sms | | apiKey | Your seven API key | | name | HomeKit accessory name | | text | SMS body | | to | Array of recipient phone numbers | | from | Sender ID. Up to 11 alphanumeric or 16 numeric characters | | flash | Send as flash SMS | | performance_tracking | Enable click tracking | | foreign_id / label | Tag the message for callbacks / analytics | | ttl | Time-to-live in minutes | | debug | Print extra log output |

Usage

The accessory exposes a HomeKit switch. Toggling it on - via Home app, Siri, or any HomeKit automation - sends the configured SMS to every recipient in to.

Support

Need help? Feel free to contact us or open an issue.

License

MIT