Asterisk is a free and open source framework for building communications applications. Asterisk powers IP PBX systems, VoIP gateways, conference servers, and is used by SMBs, enterprises, call centers, carriers and governments worldwide.
Follow these steps to get the add-on installed on your system:
-
Click here:
-
Scroll down the page to find the new repository, and click in the new add-on named Asterisk.
-
Click in the INSTALL button.
- The certificate to your registered domain should already be created via the Duck DNS or Let's Encrypt add-on or another method. Make sure that the certificate files exist in the
/ssl/
directory. - Check the add-on configuration by going to the Configuration tab. You need to at least fill the AMI Password and the Auto add secret (if you leave Auto add extensions enabled).
- Start the add-on by clicking in the START button.
Note: Remember to restart the add-on when the configuration is changed.
Set's the password for the Asterisk Manager Interface, to connect to the Asterisk integration.
Enables video support for the auto generated extensions.
Creates a extension for every person registered in Home Assistant. They will have their number and username auto-generated starting from 100, with the callerid
set to the person's name.
The secret for the auto generated extensions.
Enables/disables the generation of a self-signed certificate for use with the SSL interfaces (WSS and TLS).
The certificate file to use for SSL in your /ssl/
folder, when generate_ssl_cert
is disabled.
The key file to use for SSL in your /ssl/
folder, when generate_ssl_cert
is disabled.
Enables the mailbox server to send voicemails to the Asterisk mailbox integration.
The port used by the mailbox server.
The password for the mailbox server.
Which extension to get the voicemails from.
The API Key for speech-to-text. You can get a key here. Google says it's free, but requires a billing account.
The log level to configure Asterisk to use. To know more about the existing presets, check logger.conf
.
Configuring the Asterisk integration
- Host:
localhost
- Port:
5038
- Username:
admin
- Password: whatever you set in the AMI Password configuration
Configuring the SIP.js card
- Host:
localhost
- Port:
8089
- Video:
false
Video is not working at the moment, this will be fixed soon. For now you could use the camera entity instead.
And add a extension. To see which extension every person has, you can look at /config/asterisk/sip_default.conf
.
For more information, visit the SIP-HASS docs.
If you are having problems with the add-on, try deleting the asterisk
folder located at /config/
and restart the add-on. This will make sure you have the latest configuration files.