mirror of
https://github.com/home-assistant/home-assistant.io.git
synced 2025-05-11 13:38:59 +00:00
44 lines
1.5 KiB
Markdown
44 lines
1.5 KiB
Markdown
---
|
|
layout: page
|
|
title: "Free Mobile"
|
|
description: "Instructions how to add user notifications to Home Assistant."
|
|
date: 2016-01-12 08:36
|
|
sidebar: true
|
|
comments: false
|
|
sharing: true
|
|
footer: true
|
|
logo: free_mobile.png
|
|
ha_category: Notifications
|
|
ha_release: 0.11
|
|
---
|
|
|
|
The `free_mobile` platform is using the French mobile operator [Free Mobile](http://mobile.free.fr/) to send SMS to your own cell phone.
|
|
|
|
Before doing anything, you have to activate the SMS API option in your Free Mobile account (In "Gérer mon compte -> Mes Options"). Activating this option will automatically generate a token which is required in your configuration.
|
|
|
|
<p class='img'>
|
|
<img src='/images/components/free_mobile/token.png' />
|
|
</p>
|
|
|
|
This API only send classic SMS and only on the cell phone of the account owner. So you only have to provide a text message in your payload.
|
|
|
|
<p class='note warning'>
|
|
If you disable and re-enable the SMS API option, please be sure to update your token in your configuration.
|
|
</p>
|
|
|
|
To enable SMS notifications in your installation, add the following to your `configuration.yaml` file:
|
|
|
|
```yaml
|
|
# Example configuration.yaml entry
|
|
notify:
|
|
- name: NOTIFIER_NAME
|
|
platform: free_mobile
|
|
username: YOUR_ACCOUNT_ID
|
|
access_token: TOKEN
|
|
```
|
|
|
|
Configuration variables:
|
|
|
|
- **username** (*Required*): This is the id given by FreeMobile to access to your online account.
|
|
- **access_token** (*Required*): You can get this token by activating the SMS API in your online account.
|