twilio integration 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.
To use this notification integration in your installation, add the following to your
# Example configuration.yaml entry twilio: account_sid: ACCOUNT_SID_FROM_TWILIO auth_token: AUTH_TOKEN_FROM_TWILIO
To be able to receive events from Twilio, your Home Assistant instance needs to be accessible from the web and you need to have the external URL configured in Home Assistant.
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.
Here is an example:
automation: trigger: platform: event event_type: twilio_data_received event_data: From: '+1XXXXXXXXXXX' To: '+1YYYYYYYYYYY' CallStatus: ringing Direction: inbound action: service: cover.open_cover target: entity_id: cover.garage_door
The above opens the garage door when the number
+1YYYYYYYYYYY (considering that
+1YYYYYYYYYYY is one of your numbers registered in Twilio).