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

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 |

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]

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)

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 topologiaeSRTPmudam interoperabilidade — homologar antes de ligar em massa.Duração Mínimae 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.