ha-sip-notifier/README.md

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

sip_server: "sip.yourprovider.com"
sip_user: "your_username"
sip_password: "your_password"
default_duration: 30

Twilio example:

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

service: sip_notifier.send_notification
data:
  destination: "+15551234567"
  audio_url: "https://example.com/alert.mp3"
  duration: 30

Text-to-Speech

service: sip_notifier.send_notification
data:
  destination: "+15551234567"
  message: "Emergency! Water leak detected!"
  duration: 40

Example Automation

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