home-assistant.io/source/_components/message_bird.markdown
Franck Nijhof ebca3218c7
🔥Removes linkable_title everywhere (#9772)
* Automatically create linkable headers

* Visually improve position of linkable header chain icon

* Do not auto link  headers on homepage

* Remove linkable_title everywhere

* 🚑 Re-instante linkable_title plugin as NOOP
2019-07-04 19:08:27 +02:00

1.7 KiB

layout, title, description, date, sidebar, comments, sharing, footer, logo, ha_category, ha_release, redirect_from
layout title description date sidebar comments sharing footer logo ha_category ha_release redirect_from
page MessageBird Instructions on how to add user notifications to Home Assistant. 2016-03-15 17:00 true false true true message_bird.png
Notifications
0.16
/components/notify.message_bird/

The MessageBird notification platform sends notifications as SMS messages using MessageBird to your mobile phone.

Setup

Go to https://www.messagebird.com/ to retrieve your API key.

Configuration

To enable MessageBird notifications in your installation, add the following to your configuration.yaml file:

# Example configuration.yaml entry
notify:
  - name: NOTIFIER_NAME
    platform: message_bird
    api_key: YOUR_API_KEY

{% configuration %} api_key: description: Your MessageBird API key. 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 sender: description: Setting the optional parameter sender. This will be the sender of the SMS. It may be either a telephone number (e.g., +4915112345678) or a text with a maximum length of 11 characters. required: false default: HA type: string {% endconfiguration %}

Usage

MessageBird is a notify platform and thus can be controlled by calling the notify service as described here. It will send a notification to the specified mobile phone number(s).

Example service payload

{
  "message": "A message for many people",
  "target": [ "+49123456789", "+43123456789" ]
}