2024.11.3
Home ▸ Integrations ▸

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.

Configuration

To use this notification platform in your installation, add the following to your configuration.yamlThe configuration.yaml file is the main configuration file for Home Assistant. It lists the integrations to be loaded and their specific configurations. In some cases, the configuration needs to be edited manually directly in the configuration.yaml file. Most integrations can be configured in the UI. [Learn more] file:

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

Configuration Variables

Looking for your configuration file?
from_number string Required

An E.164 formatted phone number, like +14151234567. See Twilio’s guide to formatting phone numbers for more information.

name string (Optional, default: notify)

Setting the optional parameter name allows multiple notifiers to be created. The notifier will bind to the notify.NOTIFIER_NAME action.

Usage

Twilio is a notification platform and thus can be controlled by calling the notify action 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"
    triggers:
      - trigger: sun
        event: sunset
    actions:
      - action: notify.twilio_call
        data:
          message: "The sun has set"
          target:
            - +14151234567
            - +15105555555