{"id":19404556,"url":"https://github.com/seven-io/webthings","last_synced_at":"2026-06-13T03:33:00.303Z","repository":{"id":106115338,"uuid":"452644554","full_name":"seven-io/webthings","owner":"seven-io","description":"WebThings addon for sending SMS via seven","archived":false,"fork":false,"pushed_at":"2023-12-15T13:27:38.000Z","size":135,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":3,"default_branch":"master","last_synced_at":"2025-01-07T12:51:18.560Z","etag":null,"topics":["iot","sms","webthings","webthings-adapter"],"latest_commit_sha":null,"homepage":"https://www.seven.io","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/seven-io.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2022-01-27T10:51:38.000Z","updated_at":"2023-02-10T14:42:51.000Z","dependencies_parsed_at":"2023-12-15T14:44:27.807Z","dependency_job_id":null,"html_url":"https://github.com/seven-io/webthings","commit_stats":null,"previous_names":[],"tags_count":2,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/seven-io%2Fwebthings","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/seven-io%2Fwebthings/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/seven-io%2Fwebthings/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/seven-io%2Fwebthings/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/seven-io","download_url":"https://codeload.github.com/seven-io/webthings/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":240581575,"owners_count":19824139,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["iot","sms","webthings","webthings-adapter"],"created_at":"2024-11-10T11:35:28.600Z","updated_at":"2026-06-13T03:33:00.298Z","avatar_url":"https://github.com/seven-io.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cp align=\"center\"\u003e\n  \u003cimg src=\"https://www.seven.io/wp-content/uploads/Logo.svg\" width=\"250\" alt=\"seven logo\" /\u003e\n\u003c/p\u003e\n\n\u003ch1 align=\"center\"\u003eseven SMS for WebThings\u003c/h1\u003e\n\n\u003cp align=\"center\"\u003e\n  Send SMS notifications from your \u003ca href=\"https://webthings.io/\"\u003eWebThings\u003c/a\u003e gateway via the seven gateway.\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"LICENSE\"\u003e\u003cimg src=\"https://img.shields.io/badge/License-MIT-teal.svg\" alt=\"MIT License\" /\u003e\u003c/a\u003e\n  \u003cimg src=\"https://img.shields.io/badge/WebThings-0.10%2B-blue\" alt=\"WebThings 0.10+\" /\u003e\n  \u003cimg src=\"https://img.shields.io/badge/Node.js-20%2B-green\" alt=\"Node.js 20+\" /\u003e\n\u003c/p\u003e\n\n---\n\n## Features\n\n- **Outbound SMS** - Trigger SMS notifications from any WebThings rule or event\n- **Multiple recipients** - Configure a list of phone numbers to be notified\n- **Custom sender ID** - Optional alphanumeric or numeric sender identifier\n- **API key fallback** - Reads `SEVEN_API_KEY` from the environment if not configured\n\n## Prerequisites\n\n- [WebThings Gateway](https://webthings.io/) 0.10.0 or newer\n- A [seven account](https://www.seven.io/) with API key ([How to get your API key](https://help.seven.io/en/api-key-access))\n- Node.js 20+ (only required when building from source)\n\n## Installation\n\n### Option 1: Pre-built release (recommended)\n\n1. Download the latest [release archive](https://github.com/seven-io/webthings/releases/latest).\n2. Extract the contents to `~/.webthings/addons/seven-adapter`:\n   ```bash\n   mkdir -p ~/.webthings/addons/seven-adapter\n   tar -xzf seven-adapter-*.tgz -C ~/.webthings/addons/seven-adapter --strip-components=1\n   ```\n3. Restart the WebThings Gateway and enable the addon under **Settings \u003e Add-ons**.\n\n### Option 2: Build from source\n\n```bash\ngit clone https://github.com/seven-io/webthings.git\ncd webthings\nnpm ci\nnpm run build\n./package.sh\n```\n\nThe resulting `seven-adapter-\u003cversion\u003e.tgz` can be installed as in option 1.\n\n## Configuration\n\nConfigure the addon under **Settings \u003e Add-ons \u003e seven \u003e Configure**:\n\n| Parameter | Type | Required | Description |\n|-----------|------|----------|-------------|\n| `apiKey` | string | yes* | Your seven API key. Falls back to `process.env.SEVEN_API_KEY` if empty. |\n| `from` | string | no | Sender identifier. Max 11 alphanumeric or 16 numeric characters. Country-specific limitations may apply ([details](https://help.seven.io/en/set-sender-id)). |\n| `recipients` | string[] | yes | Phone numbers in E.164 format that will receive notifications. |\n\n\\* required unless `SEVEN_API_KEY` is set in the environment.\n\n### Example\n\n```json\n{\n  \"apiKey\": \"your-seven-api-key\",\n  \"from\": \"WebThings\",\n  \"recipients\": [\"+491701234567\", \"+491709876543\"]\n}\n```\n\n## Usage\n\nOnce 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.\n\n## Development\n\n```bash\nnpm ci          # install dependencies\nnpm run build   # compile TypeScript to dist/\n./package.sh    # produce a release tarball\n```\n\nCI runs the build matrix on Node 20.x, 22.x and 24.x.\n\n## Support\n\nNeed help? Feel free to [contact us](https://www.seven.io/en/company/contact).\n\n## License\n\n[MIT](LICENSE)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fseven-io%2Fwebthings","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fseven-io%2Fwebthings","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fseven-io%2Fwebthings/lists"}