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

layout, title, description, date, sidebar, comments, sharing, footer, logo, ha_category, ha_release

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

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

This component is just an adaptation from the Twilio SMS notification platform and won't exist without it.

Free trial account is available at Twilio website providing free calls to verified phone numbers. Calls are limited to 10 minutes and will play a short trial message before your message runs.

Upgraded accounts have no limitation.

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
    account_sid: ACCOUNT_SID_FROM_TWILIO
    auth_token: AUTH_TOKEN_FROM_TWILIO
    from_number: E164_PHONE_NUMBER

Configuration variables:

• account_sid (Required): Your Twilio Account SID which can be found in your console. It starts with the letters AC.
• auth_token (Required): Your Twilio Account SID which can be found in your console. It should be directly under where you found the account_sid.
• from_number (Required): An E.164 formatted phone number, like +14151234567. See Twilio's guide to formatting phone numbers for more information.
• name (Optional): Setting the optional parameter name allows multiple notifiers to be created. The default value is notify. The notifier will bind to the service notify.NOTIFIER_NAME.

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