seven SMS for Homebridge

Send SMS from Homebridge automations - perfect for HomeKit alarms (water leak, smoke detection, motion).

---

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