Como Instalar o Asterisk e SIP Core no Home Assistant para Criar um Sistema de Telefonia SIP
Se você deseja transformar seu Home Assistant em uma central telefônica SIP completa, permitindo chamadas entre usuários, interfones, campainhas inteligentes e integrações avançadas, o conjunto Asterisk + SIP Core é atualmente uma das melhores soluções disponíveis.
Neste tutorial vamos instalar o addon Asterisk, configurar os ramais automáticos e integrar tudo ao Home Assistant através do SIP Core.
O que você vai precisar
- Home Assistant OS ou VBOX
- HACS instalado
- Acesso administrativo ao Home Assistant
- Necessário acesso remoto, pois precisará de https:// exemplo: NABUCASA pois o navegador exige isso para habilitar microfone e câmera
Passo 1: Instalar o Addon Asterisk
Primeiramente, adicione o repositório customizado do addon.
Repositório:
https://github.com/TECH7Fox/asterisk-hass-addons
Adicionando o repositório
Acesse:
Configurações → Complementos → Loja de Complementos → Repositórios personalziados
Adicione:
https://github.com/TECH7Fox/asterisk-hass-addons
Após adicionar o repositório, atualize a loja de complementos.
Localize o addon Asterisk e clique em Instalar.
Passo 2: Configurar o Addon Asterisk
Após a instalação, configure o addon conforme abaixo.
Senha AMI
Defina uma senha para o usuário administrador da interface AMI (Asterisk Manager Interface).
Exemplo:
MinhaSenhaAMI123
Adicionar extensões automaticamente
Ative esta opção.
Quando habilitada, o addon cria automaticamente um ramal SIP para cada usuário cadastrado no Home Assistant.
Exemplo:
| Usuário Home Assistant | Ramal |
|---|---|
| ASN Web | 100 |
| User 2 | 101 |
| User 3 | 102 |
Os ramais são gerados automaticamente a partir do número 100.
Adicionar Segredo Automático
Defina uma senha que será utilizada automaticamente em todos os ramais criados.
Exemplo:
MinhaSenhaSIP123
Esta será a senha utilizada pelos aplicativos SIP para realizar o registro.
Suporte de Vídeo
Opcional.
Ative se pretende utilizar chamadas SIP com vídeo.
Registrar Entrada do Ingress
Opcional.
Permite que outros componentes do Home Assistant descubram automaticamente a interface SIP sem necessidade de configuração manual.
Gerar Certificado SSL
Recomendado.
Ativa suporte TLS/WSS para conexões seguras.
Servidor de Caixa Postal
Opcional.
Permite habilitar correio de voz integrado ao Asterisk.
Nível de Registro
Recomendado:
info
Após concluir a configuração, clique em Salvar.
Passo 3: Iniciar o Addon
Clique em Iniciar.
Nos logs você deverá visualizar algo semelhante a:
Asterisk Ready.
Esta mensagem indica que a central SIP foi iniciada corretamente.
Passo 4: Instalar o SIP Core
Com o Asterisk funcionando, agora vamos instalar a integração responsável pela comunicação com o Home Assistant.
Repositório:
https://github.com/TECH7Fox/sipcore-hass-integration
Instalação via HACS
Acesse:
HACS → Integrações → Repositórios Personalizados
Adicione:
https://github.com/TECH7Fox/sipcore-hass-integration
Categoria:
Integration
Após adicionar, instale a integração SIP Core.
Reinicie o Home Assistant.
Passo 5: Configurar o SIP Core
Após reiniciar:
Configurações → Dispositivos e Serviços → Adicionar Integração
Selecione:
SIP Core
A integração irá se conectar automaticamente ao addon Asterisk instalado.
Configurar o SIP Core
Após adicionar a integração, clique em Configurar.
Você terá acesso ao editor YAML da integração na engrenagem de config.
Exemplo simplificado:
auto_answer: true
backup_user:
extension: "100"
ha_username: ASN Web
password: SUA_SENHA_SIP
sip_video: true
users:
- extension: "100"
ha_username: ASN Web
password: SUA_SENHA_SIP
- extension: "101"
ha_username: user 2
password: SUA_SENHA_SIP
Explicação dos principais parâmetros
auto_answer
Permite recursos de atendimento automático em cenários suportados pela integração.
backup_user
Usuário de contingência utilizado pela integração.
sip_video
Ativa suporte a chamadas SIP com vídeo. WEBCAM PC e câmera do tablet.
users
Lista de usuários SIP registrados.
Cada usuário possui:
- extension: número do ramal SIP
- ha_username: usuário do Home Assistant
- password: senha de autenticação SIP
Como funcionam os ramais
Quando a opção “Adicionar extensões automaticamente” está habilitada no Asterisk, cada usuário do Home Assistant recebe um ramal SIP próprio.
Exemplo:
| Usuário | Ramal |
|---|---|
| ASN Web | 100 |
| User 2 | 101 |
| User 3 | 102 |
Esses números poderão ser utilizados para:
- Chamadas entre usuários
- Campainhas SIP
- Interfones
- Aplicativos móveis SIP
- Integrações com automações
Registrando um aplicativo SIP (opcional)
Você pode utilizar aplicativos como:
- Linphone
- Zoiper
- Grandstream Wave
Exemplo de configuração:
Servidor SIP:
IP_DO_HOME_ASSISTANT
Usuário:
100
Senha:
Senha definida em "Adicionar Segredo Automático"
Após registrar o aplicativo, o ramal ficará disponível para chamadas.
Criando um Discador no Dashboard – lovelace
Após instalar o SIP Core, você pode adicionar o cartão SIP ao Lovelace.
Exemplo:
type: custom:sip-contacts-card
open_field: true
extensions:
"100":
name: "ASN (Ramal 100)"
"101":
name: "User 2 (Ramal 101)"
"102":
name: "User 3 (Ramal 102)"
Esse cartão permite realizar chamadas diretamente pelo dashboard do Home Assistant.
Exemplos de uso
Com essa estrutura você pode criar:
Interfone Residencial
Pressiona o botão da porta:
- Ramal 100 toca
- Ramal 101 toca
- Ramal 102 toca
Quem atender primeiro assume a chamada.
Campainha Inteligente
Ao pressionar um botão Zigbee ou ESPHome:
- O Home Assistant dispara uma chamada SIP.
- Todos os celulares registrados recebem a ligação.
Comunicação entre Ambientes
Exemplo:
- Escritório → Ramal 100
- Sala → Ramal 101
- Quarto → Ramal 102
Permitindo comunicação interna semelhante a um PABX profissional.
Conclusão
A combinação Asterisk + SIP Core transforma o Home Assistant em uma central telefônica SIP extremamente poderosa.
Além de chamadas entre usuários, a solução permite criar interfones, campainhas inteligentes, automações avançadas e integração completa com dispositivos móveis, tudo funcionando localmente dentro da sua rede.
