115 lines
2.2 KiB
Markdown
115 lines
2.2 KiB
Markdown
# SIP Voice Notifier for Home Assistant
|
|
|
|
Send voice notifications via SIP phone calls from Home Assistant.
|
|
|
|
## Features
|
|
|
|
- 📞 Place SIP calls from automations
|
|
- 🔊 Play audio from HTTP/HTTPS URLs (MP3, WAV, etc.)
|
|
- 🗣️ Text-to-speech support
|
|
- ⚡ One-step installation (add-on includes integration)
|
|
- 🔧 Configurable call duration
|
|
|
|
## Installation
|
|
|
|
### 1. Add this repository to Home Assistant
|
|
|
|
Settings → Add-ons → Add-on Store → ⋮ (menu) → Repositories
|
|
|
|
Add URL:
|
|
```
|
|
https://git.aymerick.fr/openclaw-bot/ha-sip-notifier
|
|
```
|
|
|
|
### 2. Install the "SIP Voice Notifier" add-on
|
|
|
|
Find it in the add-on store and click Install.
|
|
|
|
### 3. Configure
|
|
|
|
Settings → Add-ons → SIP Voice Notifier → Configuration
|
|
|
|
```yaml
|
|
sip_server: "sip.yourprovider.com"
|
|
sip_user: "your_username"
|
|
sip_password: "your_password"
|
|
default_duration: 30
|
|
```
|
|
|
|
**Twilio example:**
|
|
```yaml
|
|
sip_server: "ACXXXXX.pstn.twilio.com"
|
|
sip_user: "ACXXXXX"
|
|
sip_password: "your_auth_token"
|
|
default_duration: 30
|
|
```
|
|
|
|
### 4. Start the add-on
|
|
|
|
Click Start. The service `sip_notifier.send_notification` will be automatically available!
|
|
|
|
### 5. Restart Home Assistant (if needed)
|
|
|
|
Settings → System → Restart
|
|
|
|
## Usage
|
|
|
|
### Play Audio from URL
|
|
|
|
```yaml
|
|
service: sip_notifier.send_notification
|
|
data:
|
|
destination: "+15551234567"
|
|
audio_url: "https://example.com/alert.mp3"
|
|
duration: 30
|
|
```
|
|
|
|
### Text-to-Speech
|
|
|
|
```yaml
|
|
service: sip_notifier.send_notification
|
|
data:
|
|
destination: "+15551234567"
|
|
message: "Emergency! Water leak detected!"
|
|
duration: 40
|
|
```
|
|
|
|
## Example Automation
|
|
|
|
```yaml
|
|
automation:
|
|
- alias: "Water Leak Alert"
|
|
trigger:
|
|
platform: state
|
|
entity_id: binary_sensor.water_leak
|
|
to: "on"
|
|
action:
|
|
service: sip_notifier.send_notification
|
|
data:
|
|
destination: "+15551234567"
|
|
message: "EMERGENCY! Water leak detected in basement!"
|
|
duration: 45
|
|
```
|
|
|
|
## SIP Providers
|
|
|
|
### Twilio
|
|
- Cost: ~$0.013/min
|
|
- Easy setup, reliable
|
|
|
|
### VoIP.ms
|
|
- Cost: ~$0.009/min
|
|
- Canadian provider, good value
|
|
|
|
## Documentation
|
|
|
|
Full documentation available in the add-on README.
|
|
|
|
## Support
|
|
|
|
Issues and questions: https://git.aymerick.fr/openclaw-bot/ha-sip-notifier/issues
|
|
|
|
## License
|
|
|
|
MIT
|