Roteiro: Criar endpoint completo (identificação, conexão e atributos)¶
Perfil necessário: admin Menus usados: Roteamento, Plataforma Risco: médio (o endpoint define a origem confiável de tráfego; IP/atributo errados travam o cliente ou abrem chamadas não autorizadas) Rollback: excluir o endpoint (ou editar revertendo os atributos) e recarregar OpenSIPS
Pré-requisitos¶
- [ ] IP (v4/v6) e porta SIP do equipamento do cliente (PBX/gateway/SBC)
- [ ] SIP Profile existente (
Plataforma → Sistema → SIP Profiles) para vincular - [ ] Interfaces de rede conhecidas se for usar Local IP / RTP IP Override (
Segurança e Rede → Rede) - [ ] Decisões de mídia: âncora RTP? SRTP? transcodificação? DTMF?
Passo a passo¶
1. Abrir a listagem de endpoints¶
Caminho: Roteamento → Endpoints
Clique: [Novo Endpoint] (toolbar da listagem)

2. Preencher a identificação do endpoint¶
Preencha (dialog Novo Endpoint):
| Campo | Obrig. | Formato/exemplo | Efeito |
|---|---|---|---|
| Nome | sim | pbx-acme-01 |
identificador único; referência em CDR, grupos e firewall |
| SIP Profile | sim | perfil existente (dropdown) | comportamento SIP/timers no OpenSIPS |
| IP SIP do Endpoint | sim | 203.0.113.10 (IPv4 ou IPv6) |
origem esperada do tráfego; virá como destino SIP |
| Porta SIP | sim | 5060 (1–65535) |
porta de origem do cliente |
| Dead Letter URI | não | sip:trap@dominio:5060 |
destino alternativo quando não há rota possível |
| Forçar ancora RTP | não | booleano | mídia sempre ancorada no rtpengine nas chamadas originadas deste endpoint |
Resultado esperado: campos de identificação prontos; os dois primeiros blocos do dialog preenchidos sem erro de validação.
3. Configurar os atributos do endpoint (grid)¶
Preencha (bloco Atributos — aba Formulário):
| Atributo | Tipo | Efeito / quando usar |
|---|---|---|
| Nome do Endpoint | texto | espelha o Nome; mantido automaticamente ao salvar |
| SIP-I | toggle | transporta ISUP (troca de sinalização PTT/interconexão); liga só se o par really suporta SIP-I |
| SIP-I Versao | texto | perfil ISUP (default BR97); deve casar com a operadora/par |
| SRTP | toggle | mídia criptografada; ligar apenas se o cliente suporta (DTLS/SDES conforme perfil) |
| Ocultar topologia SIP | toggle | remove hops internos (Via/Record-Route) da sinalização exposta ao cliente |
| Local IP (SIP/RTP) | select | IP local do softswitch usado para falar com o endpoint (multi-homed/VLAN por cliente) |
| RTP IP Override | select | IP de mídia diferente do SIP (ex.: mídia por outra interface); vazio = usa Local IP |
| RTPEngine out-iface (alias) | texto | alias da interface de saída de mídia no rtpengine |
| Protocolo SIP Saída | texto | transporte para o destino (udp, tcp, tls) |
| Porta SIP Saída | número | porta de destino da sinalização (default 5060) |
| Converter DTMF | toggle | converte RFC2833 ↔ SIP INFO para interoperabilidade do destino |
| User Phone | toggle | adiciona user=phone no R-URI (pares TDM legados) |
| PAI (P-Asserted-Identity) | toggle | envia PAI com a identidade do chamador (trunks que exigem PAI) |
| Duração Mínima (seg) | número | rejeita chamadas com duração abaixo do valor (antifraude de chamadas curtas) |
| Transcodificação | toggle | roteia mídia por media server para converter codecs incompatíveis |

A aba JSON Avançado permite editar o mesmo objeto como JSON (valida antes de salvar); prefira a aba Formulário no dia a dia.
Clique: [Criar] (footer do dialog)

Resultado esperado: dialog fecha, toast "Endpoint criado", linha nova na listagem com Destino SIP ip:porta, SIP Profile, contagem de Endereços ≥ 1 (o IP do endpoint vira endereço confiável automaticamente) e Status Online/Offline após ~15 s.
Nota: ao salvar, o sistema cria automaticamente o endereço confiável do IP SIP do endpoint (e o remove ao excluir). Regras de firewall do endpoint também são sincronizadas.
Validação¶
- [ ] Visual: endpoint na listagem com Destino SIP correto e Reload
yes→ após reload virano - [ ] Funcional:
opensips-cli -x mi ds_listmostra o destino do grupo do endpoint; chamada de teste entra com origem identificada (CDRsrc_endpoint) - [ ]
Operação → CDRda chamada de teste mostra a origem mapeada para o endpoint
Erros comuns¶
| Sintoma | Causa provável | Correção |
|---|---|---|
| "Informe um IP válido (IPv4/IPv6)" | hostname em IP SIP do Endpoint | cadastrar IP ou corrigir valor (o campo exige IP, não hostname) |
| INVITE do cliente rejeitado (403/407) | IP/porta divergentes do cadastrado | conferir IP/porta; conferir endereço confiável auto-criado |
| Chamadas sem rota caindo em destino errado | Dead Letter URI vazio ou inválido | preencher com URI SIP válida |
| Sem áudio com 200 OK | âncora RTP / iface errada | revisar Local IP / RTP IP Override / RTPEngine out-iface |
| 488/415 no egress | codecs incompatíveis | habilitar Transcodificação ou ajustar codecs do tronco |
| Atributo não faz efeito | reload pendente | executar reload (passo 4) e refazer o teste |
| "Este endpoint possui N trunk(s) vinculado(s)" ao excluir | endpoint usado por troncos de operadora | remover/editar os trunks em Operadoras e Troncos antes |
Impacto operacional¶
- O IP do endpoint é porta de entrada de tráfego: máscara/IP errados autorizam chamadas de terceiros.
- SRTP, SIP-I e topology hiding mudam interoperabilidade — homologue com o par antes de ligar em massa.
- Duração Mínima é camada antifraude; não desabilite sem substituto equivalente.
- O nome do endpoint é referência em CDR/grupos/firewall — não renomeie sem plano.
Referência rápida¶
- Listagem: colunas Nome, Destino SIP, Dead Letter, IP Local, SIP Profile, Endereços, Status, SIP-I, Reload, Atualizado.
- Status e contagem de endereços se atualizam automaticamente (~15 s).
- Busca da toolbar: por nome, IP SIP ou IP local.
- Normalizar RTP (toolbar): normaliza attrs RTP de todos os endpoints e já executa o reload (dispatcher, address, dialplan).