jeans/home-assistant.io
jeans/home-assistant.io
1
0
Fork 0
mirror of https://github.com/home-assistant/home-assistant.io.git synced 2025-07-20 07:46:52 +00:00
Code Issues Packages Projects Releases Wiki Activity

Fix typos and style (#5569)

Browse Source
This commit is contained in:
Fabian Affolter 2018-06-19 10:28:29 +02:00 committed by GitHub
parent 6ff4178179
commit 5391dadfbb
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
1 changed files with 20 additions and 18 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

26
source/_docs/asterisk_mbox.markdown
View File

@ -9,9 +9,10 @@ sharing: true
footer: true footer: true
--- ---
Asterisk Voicemail integration allows Home Assistant to view, listen-to, and delete voicemails from a Asterisk voicemail mailbox. Asterisk Voicemail integration allows Home Assistant to view, listen to and delete voicemails from a Asterisk voicemail mailbox.
There are two components to the integration: There are two components to the integration:
- A server that runs on the Asterisk PBX host and communicates over an open port. - A server that runs on the Asterisk PBX host and communicates over an open port.
- A client which can request inormation from the server. - A client which can request inormation from the server.
@ -20,17 +21,18 @@ Both parts are necessary for Asterisk voicemail integration.
The server installation is documented below. The client is [integrated inside Home Assistant](/components/asterisk_mbox) The server installation is documented below. The client is [integrated inside Home Assistant](/components/asterisk_mbox)
<p class='note'> <p class='note'>
Currently this module can only monitor a single Asterisk PBX mailbox. Multiple mailbox support is planned for the future Currently this module can only monitor a single Asterisk PBX mailbox.
</p> </p>
### {% linkable_title Prerequisites %} ### {% linkable_title Prerequisites %}
Before beginning make sure that you have the following: Before beginning make sure that you have the following:
- A functional Asterisk PBX setup which is using the default `voicemail` application
- Both Home Assistant and Asterisk PBX running on the same LAN (or the same server) - A functional Asterisk PBX setup which is using the default `voicemail` application.
- The Asterisk PBX server has python 3.4 or newer installed - Both Home Assistant and Asterisk PBX running on the same LAN (or the same server).
- Administrator access on the Asterisk PBX (for python module installation) - The Asterisk PBX server has Python 3.5 or newer installed.
- Account Access to the `asterisk` user that runs the Asterisk PBX software - Administrator access on the Asterisk PBX (for python module installation).
- Account access to the `asterisk` user that runs the Asterisk PBX software.
### {% linkable_title Installation %} ### {% linkable_title Installation %}
@ -44,7 +46,7 @@ Before beginning make sure that you have the following:
3. Create a configuration file for the server 3. Create a configuration file for the server
As the `asterisk` user create an `asterisk_mbox.ini` file (You can place this in any directory you choose, but the rommended location is `/etc/asterisk/asterisk_mbox.ini`) As the `asterisk` user create an `asterisk_mbox.ini` file. You can place this in any directory you choose, but the recommended location is `/etc/asterisk/asterisk_mbox.ini`.
```ini ```ini
[default] [default]
@ -57,13 +59,13 @@ Before beginning make sure that you have the following:
``` ```
- **host** (*Optional*): The IP address to listen on for client requests. This defaults to all IP addresses on the server. To listen only locally, choose `127.0.0.1` - **host** (*Optional*): The IP address to listen on for client requests. This defaults to all IP addresses on the server. To listen only locally, choose `127.0.0.1`
- **port** (*Optional*): The port to listen on for client requests. (default: 12345) - **port** (*Optional*): The port to listen on for client requests. Defaults to 12345.
- **password** (*Required*): A password shared between client and server. Use only alpha-numeric characters and spaces - **password** (*Required*): A password shared between client and server. Use only alpha-numeric characters and spaces
- **mbox\_path** (*Required*): The path to the storage location of mailbox files. This is typically `/var/spool/asterisk/voicemail/default/<mailbox>/` - **mbox\_path** (*Required*): The path to the storage location of mailbox files. This is typically `/var/spool/asterisk/voicemail/default/<mailbox>/`
- **cache\_file** (*Required*): A fully-qualified path to a file thht can be written by the server containing transcriptions of voicemails. Example: `/var/spool/asterisk/transcription.cache` - **cache\_file** (*Required*): A fully-qualified path to a file thht can be written by the server containing transcriptions of voicemails. Example: `/var/spool/asterisk/transcription.cache`
- **google\_key** (*Required*): Your 40 character Google API key - **google\_key** (*Required*): Your 40 characters Google API key.
Once complete, ensure this file is only accessible by the asterisk user: Once complete, ensure this file is only accessible by the Asterisk user:
```bash ```bash
$ sudo chown asterisk:asterisk /etc/asterisk/asterisk_mbox.ini $ sudo chown asterisk:asterisk /etc/asterisk/asterisk_mbox.ini
@ -77,7 +79,7 @@ Before beginning make sure that you have the following:
Now complete the [Home Assistant configuration](/components/asterisk_mbox) and verify that Home Assistant can communicate with the server Now complete the [Home Assistant configuration](/components/asterisk_mbox) and verify that Home Assistant can communicate with the server
You can use `Ctrl-C` to terminate the server when done testing You can use `Ctrl-c` to terminate the server when done testing
5. Configure the server to start automatically 5. Configure the server to start automatically