Send SMS notifications from your WebThings gateway via the seven gateway.
- Outbound SMS - Trigger SMS notifications from any WebThings rule or event
- Multiple recipients - Configure a list of phone numbers to be notified
- Custom sender ID - Optional alphanumeric or numeric sender identifier
- API key fallback - Reads
SEVEN_API_KEYfrom the environment if not configured
- WebThings Gateway 0.10.0 or newer
- A seven account with API key (How to get your API key)
- Node.js 20+ (only required when building from source)
- Download the latest release archive.
- Extract the contents to
~/.webthings/addons/seven-adapter:mkdir -p ~/.webthings/addons/seven-adapter tar -xzf seven-adapter-*.tgz -C ~/.webthings/addons/seven-adapter --strip-components=1
- Restart the WebThings Gateway and enable the addon under Settings > Add-ons.
git clone https://github.com/seven-io/webthings.git
cd webthings
npm ci
npm run build
./package.shThe resulting seven-adapter-<version>.tgz can be installed as in option 1.
Configure the addon under Settings > Add-ons > seven > Configure:
| Parameter | Type | Required | Description |
|---|---|---|---|
apiKey |
string | yes* | Your seven API key. Falls back to process.env.SEVEN_API_KEY if empty. |
from |
string | no | Sender identifier. Max 11 alphanumeric or 16 numeric characters. Country-specific limitations may apply (details). |
recipients |
string[] | yes | Phone numbers in E.164 format that will receive notifications. |
* required unless SEVEN_API_KEY is set in the environment.
{
"apiKey": "your-seven-api-key",
"from": "WebThings",
"recipients": ["+491701234567", "+491709876543"]
}Once configured, the addon registers a notifier device. Use it in any WebThings rule by selecting seven as the notification target. The configured recipients will receive an SMS with the rule's notification message.
npm ci # install dependencies
npm run build # compile TypeScript to dist/
./package.sh # produce a release tarballCI runs the build matrix on Node 20.x, 22.x and 24.x.
Need help? Feel free to contact us.