Conectar um tronco Asterisk PJSIP ao IllyVoIP
Entenda registration, auth, endpoint e AOR, restrinja rotas e diferencie falhas de registro e roteamento.
Guia para Asterisk gerenciado diretamente com res_pjsip, não chan_sip antigo. Se FreePBX ou interface gerar configuração, use-a em vez de editar arquivos gerados; veja nosso guia FreePBX. Confira versão instalada e documentação correspondente.
Antes de começar
Usamos linha com senha. Em SIP Lines obtenha usuário, senha SIP, servidor, porta destino e transporte. Não use login do portal. Não troque autenticação IP sem conferir dispositivos dependentes.
Precisa de acesso administrador, backup privado e ramal interno funcional. Uma linha SIP IllyVoIP liga PBX e IllyVoIP; ramal liga telefone ao PBX. São contas diferentes.
Comece com ramal e destino controlados. Não migre o escritório inteiro de uma vez. Se já houver chamadas, mantenha a rota antiga até concluir o teste.
1. Construa objetos relacionados
Registro é só parte do tronco PJSIP. Use nomes claros como illy-auth, illy-registration, illy-aor e illy-endpoint. São vínculos de objetos, não credenciais. Os arquivos dependem dos includes e gerenciamento atuais.
| Campo | Valor |
|---|---|
| auth | type=auth; auth_type=userpass; username/password da linha |
| registration | outbound_auth aponta para auth; server_uri é a URI do servidor; client_uri identifica o usuário ali |
| aor | contact estático aponta para a URI SIP IllyVoIP de saída |
| endpoint | aors aponta para aor; outbound_auth para auth; context identifica dialplan de entrada restrito |
| transport | Referencie o transporte configurado; não crie outro listener no endereço/porta ocupado |
| identify | Associe apenas origens SIP aprovadas quando identificar endpoint por IP |
2. Vincule autenticação nos dois pontos
Insira usuário/senha em auth e referencie de registration e endpoint de saída. Registro pode funcionar e chamadas falharem se só registration tiver credenciais. O formato é sip:SIP_USERNAME@SIP_SERVER em client_uri e sip:SIP_SERVER em server_uri com porta/transporte necessário. Substitua os rótulos pelos dados reais.
Mantenha transporte salvo necessidade. Algumas alterações exigem mais que reload. Não reinicie PBX funcional por um objeto incorreto. Faça backup e siga implantação da versão instalada.
3. Separe entrada do contexto de saída
Crie contexto como from-illyvoip, enviando só identificadores esperados a ramal, grupo ou IVR conhecido. Não inclua contexto interno/externo irrestrito. Para IP obtenha origens aprovadas; hostname registrar não comprova todas as origens.
Antes da regra DID, observe a chamada controlada. Pode chegar um identificador de contato do registro em vez do número. Combine o observado esperado, não uma regra geral que disque números externos arbitrários.
4. Rota de teste estreita
No contexto exclusivo do ramal teste, combine o destino exato e envie pelo endpoint. Formato: PJSIP/NUMBER@illy-endpoint. NUMBER é o destino normalizado. Não coloque isso em contexto público de entrada. Após sucesso amplie só aos padrões/ramais necessários.
5. Inspecione antes de mudar novamente
Na CLI leia pjsip show registrations, pjsip show endpoints e pjsip show aors. Confira objetos e contato AOR. Registro não testa dialplan de saída. Endpoint ausente é configuração/carregamento, não automaticamente senha recusada.
Para logs de um teste, administrador coleta trace privado curto e desliga logger depois. Pode conter números e autenticação. Compare destino/resposta com o registro do portal antes de mudar timers, NAT ou codecs globais.
Áudio, caller ID e segurança
Transporte e criptografia de mídia são separados. Combine modo da linha/PBX; RTP, SDES-SRTP e DTLS-SRTP não são intercambiáveis. Não mude transporte, codecs e rede juntos, pois perderá a causa da correção ou falha.
Use somente um caller ID permitido pela conta. Digitá-lo não verifica. Não deixe entrada anônima alcançar rotas públicas de saída nem desligue firewall. Peça origens atuais ao suporte em vez de adivinhar a lista.
Validação antes da equipe
- Confira registro do tronco separadamente do ramal teste.
- Ligue do ramal e confirme tronco usado. Confira saldo/tarifa: pode cobrar.
- Confira áudio nos dois sentidos e número mostrado. Teste teclas num menu autorizado.
- Na entrada, roteie um número IllyVoIP ativo para a linha PBX, ligue externamente e confira destino interno.
- Confirme que ramal sem permissão não usa a rota; amplie depois.
Registre horário, fuso, ramal, rota e referência pública. Envie com modelo/versão ao suporte em falhas. O guia de códigos SIP ajuda a explicar. Não publique senha ou logs sem limpeza.
Guia baseado em documentação oficial e portal, não certificação real de todas as versões. Emergências e equipamentos especiais exigem configuração/verificação separadas.