ha-sip-notifier/sip-notifier

SIP Voice Notifier Add-on

Installation Complete!

The add-on is running and listening on port 8099.

Note: This add-on uses host networking mode to ensure proper SIP/UDP connectivity with your provider.

Setup Service in Home Assistant

To use the add-on, add this to your /config/configuration.yaml:

# SIP Voice Notifier Service
script:
  sip_send_notification:
    alias: "SIP Voice Notification"
    description: "Send voice notification via SIP call"
    icon: mdi:phone-voip
    mode: queued
    fields:
      destination:
        name: Destination
        description: "Phone number (e.g., +15551234567)"
        required: true
        example: "+15551234567"
        selector:
          text:
      audio_url:
        name: Audio URL
        description: "HTTP(S) URL to audio file (MP3/WAV)"
        required: false
        example: "https://example.com/alert.mp3"
        selector:
          text:
      message:
        name: Message
        description: "Text message for TTS"
        required: false
        example: "Emergency alert message"
        selector:
          text:
      duration:
        name: Duration
        description: "Call duration in seconds"
        required: false
        default: 30
        example: 30
        selector:
          number:
            min: 5
            max: 300
    sequence:
      - service: rest_command.sip_notification_call
        data:
          destination: "{{ destination }}"
          audio_url: "{{ audio_url if audio_url else '' }}"
          message: "{{ message if message else '' }}"
          duration: "{{ duration | default(30) }}"

rest_command:
  sip_notification_call:
    url: "http://088d3b92-sip-notifier:8099/send_notification"
    method: POST
    content_type: "application/json"
    payload: >-
      {
        "destination": "{{ destination }}"
        {%- if audio_url and audio_url != '' %},
        "audio_url": "{{ audio_url }}"
        {%- endif %}
        {%- if message and message != '' %},
        "message": "{{ message }}"
        {%- endif %},
        "duration": {{ duration | default(30) }}
      }

Restart Home Assistant

After adding to configuration.yaml:

• Settings → System → Restart

Usage

Play Audio from URL

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

Text-to-Speech

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

Example Automation

automation:
  - alias: "Water Leak Emergency Call"
    trigger:
      platform: state
      entity_id: binary_sensor.water_leak
      to: "on"
    action:
      - service: script.sip_send_notification
        data:
          destination: "+15551234567"
          message: "EMERGENCY! Water leak detected in basement!"
          duration: 45

Troubleshooting

Service not found

1. Check you added the script to configuration.yaml
2. Restart Home Assistant
3. Check for syntax errors in configuration.yaml

Call fails

Check add-on logs: Settings → Add-ons → SIP Voice Notifier → Log

Common issues:

• Incorrect SIP credentials
• Phone number format (use international: +1...)
• Network connectivity to SIP server

Configuration

Add-on configuration options:

• sip_server: Your SIP provider's server address
• sip_user: Your SIP username
• sip_password: Your SIP password
• default_duration: Default call duration in seconds (5-300)

SIP Providers

Twilio

sip_server: "ACXXXXX.pstn.twilio.com"
sip_user: "ACXXXXX"
sip_password: "your_auth_token"

VoIP.ms

sip_server: "server.voip.ms"
sip_user: "123456_subaccount"
sip_password: "password"

Support

Issues: https://git.aymerick.fr/Aymerick/ha-sip-notifier/issues