home-assistant.io/source/_components/notify.twilio_call.markdown

2.0 KiB

layout title description date sidebar comments sharing footer logo ha_category ha_release
page Twilio Call Instructions on how to add user notifications to Home Assistant. 2017-01-27 00:09 true false true true twilio.png Notifications 0.37

The twilio_call notification platform enables sending notifications via Voice, powered by Twilio. Passed message will be read by Text-To-Speech service.

The requirement is that you have setup Twilio.

To use this notification platform in your installation, add the following to your configuration.yaml file:

# Example configuration.yaml entry
notify:
  - name: NOTIFIER_NAME
    platform: twilio_call
    from_number: E164_PHONE_NUMBER

{% configuration %} from_number: description: "An E.164 formatted phone number, like +14151234567. See Twilio's guide to formatting phone numbers for more information." required: true type: string name: description: Setting the optional parameter name allows multiple notifiers to be created. The notifier will bind to the service notify.NOTIFIER_NAME. required: false default: "notify" type: string {% endconfiguration %}

{% linkable_title Usage %}

Twilio is a notify platform and thus can be controlled by calling the notify service as described here. It will send a notification to all E.164 phone numbers in the notification target. See the notes above regarding the from_number configuration variable for information about formatting phone numbers.

# Example automation notification entry
automation:
  - alias: The sun has set
    trigger:
      platform: sun
      event: sunset
    action:
      service: notify.twilio_sms
      data:
        message: 'The sun has set'
        target:
          - +14151234567
          - +15105555555