home-assistant.io/source/_components/twilio_call.markdown
Franck Nijhof 1833c32a2c Cleans up front matter (#9835)
* Sets front matter defaults

* Removes default front matter from section templates/pages

* Removes default front matter from addon pages

* Removes default front matter from integration pages

* Removes default front matter from posts

* Removes default front matter from docs pages

* Removes default front matter from other pages

* Fixes blog category pages
2019-07-11 14:35:08 -07:00

1.9 KiB

title, description, logo, ha_category, ha_release, redirect_from
title description logo ha_category ha_release redirect_from
Twilio Call Instructions on how to add user notifications to Home Assistant. twilio.png
Notifications
0.37
/components/notify.twilio_call/

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 %}

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_call
      data:
        message: 'The sun has set'
        target:
          - +14151234567
          - +15105555555