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:

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:

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.