2.8 KiB
| layout | title | description | date | sidebar | comments | sharing | footer | logo | ha_category | ha_release |
|---|---|---|---|---|---|---|---|---|---|---|
| page | Twilio | Instructions on how to add Twilio notifications to Home Assistant. | 2016-05-14 14:14 | true | false | true | true | twilio.png | Hub | 0.40 |
The twilio component enables the sending of notifications via SMS and the creation of calls with Twilio.
A 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.
{% linkable_title Configuration %}
To use this notification component in your installation, add the following to your configuration.yaml file:
# Example configuration.yaml entry
twilio:
account_sid: ACCOUNT_SID_FROM_TWILIO
auth_token: AUTH_TOKEN_FROM_TWILIO
{% configuration %}
account_sid:
description: "Your Twilio Account SID which can be found in your console. It starts with the letters AC."
required: true
type: string
auth_token:
description: "Your Twilio AUTH TOKEN which can be found in your console. It should be directly under where you found the account_sid."
required: true
type: string
{% endconfiguration %}
{% linkable_title Usage %}
After configuring the base Twilio component, add and configure either or both of the twilio SMS and twilio Phone components to utilize the notification functionality.
To be able to receive events from Twilio, your Home Assistant instance needs to be accessible from the web (Hass.io instructions) and you need to have the base_url configured for the HTTP component (docs).
To set it up, go to the integrations page in the configuration screen and find Twilio. Click on configure. Follow the instructions on the screen to configure Twilio.
You will get a URL of the following format: https://<home-assistant-domain>/api/webhook/9940e99a26fae4dcf6fe0a478124b6b58b578ea4c55c9a584beb1c9f5057bb91. To generate inbound events, you have to configure your webhooks with Twilio
Events coming in from Twilio will be available as events in Home Assistant and are fired as twilio_data_received. The data specified by Twilio will be available as the event data. You can use this event to trigger automations.
You can then consume that information with the following automation:
automation:
trigger:
platform: event
event_type: twilio_data_received
event_data:
action: call_service
action:
service: light.turn_on
entity_id: light.office