Ir para o conteúdo

Roteiro: Criar endpoint SIP e configurar atributos de mídia

Perfil necessário: admin Menus usados: Roteamento, Sistema Risco: médio (atributos de mídia/segurança afetam áudio e exposição do softswitch) Rollback: editar o endpoint revertendo atributos; recarregar OpenSIPS

Pré-requisitos

  • [ ] IP/porta SIP de origem do equipamento do cliente
  • [ ] Perfil SIP existente (Sistema → SIP Profiles) para vincular
  • [ ] Decisão de mídia: transcodificação? SRTP? âncora RTP?

Passo a passo

1. Abrir a listagem de endpoints

Caminho: Roteamento → Endpoints

Listagem de endpoints com botão Novo Endpoint destacado

2. Criar o endpoint

Clique: [Novo Endpoint]

Preencha (blocos do dialog):

Identificação e sinalização:

Campo Obrig. Formato/exemplo Efeito
Nome sim pbx-acme-01 identificador (aparece no CDR)
SIP Profile sim perfil existente comportamento SIP no OpenSIPS
IP SIP do Endpoint sim 203.0.113.10 origem esperada
Porta SIP sim 5060 porta de origem
Dead Letter URI não sip:trap@media destino sem rota possível
Forçar ancora RTP não booleano mídia sempre via rtpengine

Dialog Novo Endpoint

Atributos (grid de toggles/seletores — principais):

Atributo Efeito
SIP-I + Versão (BR97) ISUP transparente para interconexão
SRTP mídia criptografada
Ocultar topologia SIP remove hops internos do Via/Route
Local IP (SIP/RTP) / RTP IP Override seleção de interface de rede
RTPEngine out-iface alias de interface de saída do media
Protocolo/Porta SIP Saída transporte e porta para o destino
Converter DTMF interoperabilidade RFC2833/sip-info
User Phone / PAI ajustes de identidade apresentada
Duração Mínima (seg) filtro antifraude de chamadas curtas
Transcodificação habilita media server p/ codecs distintos

Clique: [Criar]

Resultado esperado: endpoint na listagem; sem erro de validação.

3. Recarregar OpenSIPS

Caminho: Sistema → OpenSIPS Clique: [Recarregar todos os módulos]

Reload

4. Validar

  • [ ] INVITE do cliente aceito (CDR com src_endpoint = nome do endpoint)
  • [ ] Áudio bidirecional na chamada de teste (MEDIA presente no fluxo SIP)
  • [ ] Sem rejeição de codec (415/488 ausente)

CDR

Erros comuns

Sintoma Causa provável Correção
INVITE do cliente rejeitado (403) IP/porta divergentes do cadastrado corrigir IP/porta do endpoint
Sem áudio com 200 OK âncora RTP/RTP iface incorreta revisar atributos de mídia; checar RTPEngine
488 no EGRESS codecs incompatíveis com destino habilitar transcodificação ou ajustar codecs
Chamadas curtas em massa passando Duração Mínima desabilitada habilitar e definir segundos
Atributo não aplica reload pendente Recarregar todos os módulos

Impacto operacional

  • Ocultar topologia e SRTP mudam interoperabilidade — homologar antes de ligar em massa.
  • Duração Mínima e limites na linha são camada antifraude; não desabilite sem substituto.
  • Nome do endpoint é referência em CDR/filtros — não renomeie em produção sem plano.