Ir para o conteúdo

Roteiro: Criar linha com perfil, plano, limites, entrega e credencial SIP (LineFormDialog completo)

Perfil necessário: admin (criar linha cria subscriber/endereço confiável) Menus usados: Comercial, Sistema Risco: médio (IP autorizado errado autoriza chamadas de terceiros; delivery host errado derruba a entrega) Rollback: editar a linha corrigindo os campos, ou excluir a linha; recarregar OpenSIPS para rever endereços na memória

Pré-requisitos

  • [ ] Cliente já cadastrado (ver commercial-criar-cliente.md)
  • [ ] Perfil de saída existente quando a linha usa um (criado em Comercial → Políticas)
  • [ ] Plano existente quando houver faturamento com franquia
  • [ ] Para Tronco SIP: IP público fixo do PBX do cliente
  • [ ] Para Linha SIP: usuário SIP decidido (fixo BR cria DID automaticamente) e senha definida
  • [ ] Domínio SIP cadastrado quando a linha usa credencial (Sistema → Domínios SIP)

Passo a passo

1. Abrir a criação de linha

Caminho: Comercial → Linhas Clique: [Nova Linha]

Listagem de linhas com o botão Nova Linha destacado

Resultado esperado: dialog Nova Linha com abas Geral (criação só tem Geral), DIDs / DDR, Terminação (Siga-me / Grupo) e Bloqueio de Entrada; as três últimas só existem ao editar uma linha já criada.

2. Escolher cliente e tipo

Caminho: dialog Nova Linha → Geral Clique: seletor [Tipo]

Dialog Nova Linha com o campo Tipo destacado

Preencha:

Campo Obrig. Formato/exemplo Efeito
Cliente * sim (quando aberto por Linhas) seletor por nome dono da linha; vem travado quando aberto pelo detalhe do cliente
Tipo * sim Linha SIP (residential), Tronco SIP (sip_trunk), Transito SIP (transit_sip) muda o restante do formulário

O tipo define o comportamento:

  • Linha SIP — cria subscriber SIP vinculado; credencial obrigatória; DID derivado automaticamente quando o usuário é fixo BR (55DDNNNNNNNN).
  • Tronco SIP — autentica por IPs autorizados; credencial de registro opcional; lista de IPs disponível na criação.
  • Transito SIP — entrega exclusivamente pelo endpoint escolhido; sem credencial, sem IP, sem delivery hosts.

3. Vincular perfil de saída e plano

Caminho: dialog Nova Linha → Geral Clique: seletor [Perfil de Saída]

Dialog Nova Linha com o campo Perfil de Saída destacado

Preencha:

Campo Obrig. Formato/exemplo Efeito
Perfil de Saída não perfil existente (ex.: STFC) política de outbound, normalização do número B e regras de roteamento; ao mudar o perfil após criar, o dialplan da linha é recompilado
Plano (faturamento) não plano existente (ex.: Plano Local) franquias e tarifas que o consumo da linha abate

Resultado esperado: hint do perfil "Define política de outbound, normalização, classificação do número B e regras de roteamento..." visível.

4. Tech prefix, limites e status

Caminho: dialog Nova Linha → Geral Clique: campo [Tech Prefix]

Dialog Nova Linha com os campos de limites Max Concurrent e Max CPS destacados

Preencha:

Campo Obrig. Formato/exemplo Efeito
Tech Prefix não 0, 9, 00 prefixo adicionado ao B-number antes do carrier
Max Concurrent não inteiro ≥ 0, default 10 teto de chamadas simultâneas da linha
Max CPS não inteiro ≥ 0, default 0 teto de chamadas por segundo (antifraude)
Status não Ativo (default), Suspenso, Cancelado habilitação da linha
Dead Letter URI não sip:fallback@dominio:5060 destino alternativo quando a entrega principal falhar
Forçar ancora RTP (rtpengine)... não checkbox mídia ancorada no rtpengine nas chamadas para esta linha

A UI lembra: o CallerID é derivado automaticamente dos DIDs da linha (DID marcado como primary); sem DID, o próprio usuário SIP é usado como CLI.

5. Preencher a credencial SIP (Linha SIP) ou o tronco com IP autorizado (Tronco SIP)

Caminho: dialog Nova Linha → Geral → seção Tronco SIP (ou Linha SIP para residential) Clique: [Adicionar IP] (apenas Tronco SIP)

Dialog Nova Linha, seção Tronco SIP, com o botão Adicionar IP destacado

Preencha (Tronco SIP):

Campo Obrig. Formato/exemplo Efeito
IPs autorizados a enviar chamadas sim p/ tronco só-IP 203.0.113.10, 10.0.0.0/24, 198.51.100.7:5060 cada IP vira endereço confiável (address) com método ip_did ligado à linha
Usuário SIP (opcional) não tronco_cliente preencher só se o tronco vai registrar por digest
Credencial SIP sim se usuário informado Senha ou HA1 / HA1B modo de autenticação do registro
Senha SIP sim com Senha senha forte backend valida: informar senha ou HA1/HA1B, nunca ambos
HA1 / HA1B sim com HA1/HA1B MD5 hex de 32 caracteres digest pré-computado
Domínio SIP * sim com usuário domínio cadastrado realm do registro

Preencha (Linha SIP): Usuário SIP, Credencial SIP, Senha SIP e Domínio SIP são obrigatórios. Se o usuário for fixo BR válido (ex.: 554932222222), um DID E.164 é criado/atribuído como primary automaticamente; móveis e não numéricos não criam DID.

Resultado esperado: linha de IP adicionada com botão de remoção; hint "Cada IP vira endereço confiável com método ip_did. Após criar, edite os endereços com opções avançadas."

6. Hosts de entrega (delivery hosts)

Caminho: dialog Nova Linha → Geral → Hosts de entrega das chamadas Clique: [Adicionar host]

Dialog Nova Linha, seção Hosts de entrega, com o botão Adicionar host destacado

Preencha:

Campo Obrig. Formato/exemplo Efeito
Política (múltiplos hosts) não Failover (tenta em ordem) (default) ou Round-robin (distribui carga) como distribuir entre os hosts
Hosts de entrega não ip.exemplo.com:5060, 192.0.2.10:5065 destinos fixos de entrega da linha; sem esquema (sem sip:)

Vazio = a linha usa o registro SIP (REGISTER/contact) quando existir. Backend rejeita host que aponta para localhost ou para um IP de escuta do próprio OpenSIPS (422 "Host de entrega ... inválido").

7. Salvar a linha

Caminho: dialog Nova Linha Clique: [Criar]

Dialog Nova Linha com o botão Criar destacado no rodapé

Resultado esperado: toast Linha criada, dialog fecha, linha listada com tipo, plano, perfil e status.

8. Recompilar/ajustar e recarregar OpenSIPS

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

Página Reload OpenSIPS com o botão Recarregar todos os módulos destacado

Resultado esperado: "Todos os módulos recarregados". A criação da linha já sincroniza endereços e dialplan no banco; o reload leva o novo address (e dialplan, se a linha tem perfil) para a memória do OpenSIPS.

Validação

  • [ ] Visual: linha listada com Tag do tipo, plano e perfil corretos
  • [ ] Funcional (tronco): endereços da linha visíveis em Roteamento → Avançado → Endereços Confiáveis com tag line:<id> e método ip_did
  • [ ] Funcional (linha SIP): subscriber criado em Roteamento → Avançado → Usuários SIP com username@dominio da linha; DID primary criado se usuário era fixo
  • [ ] Funcional: reload address sem erro; chamada de teste do PBX entra com 200 e CDR na origem esperada
  • [ ] Funcional (linha SIP): registro visível na aba Registros SIP ativos do dialog de edição (ou em Operação → Registros SIP)

Erros comuns

Sintoma Causa provável Correção
422 "sip_username é obrigatório quando sip_password..." tronco com senha/HA1 preenchidos sem usuário informar o Usuário SIP ou limpar a credencial (tronco só-IP)
422 "Informe a senha SIP" / "Informe um MD5 hex de 32 caracteres" credencial incompleta preencher senha OU HA1+HA1B consistentes
422 "endpoint_id é obrigatório..." Transito SIP sem endpoint escolher o Endpoint de entrega
422 "Transito SIP não usa IPs autorizados/credencial/delivery_hosts" campos do tipo errado limpar campos incompatíveis com transit
422 "Host de entrega ... inválido: aponta para localhost/IP de escuta" host de entrega é o próprio softswitch usar o IP do destino real do cliente
409 "Subscriber '@' já existe" usuário SIP reutilizado escolher outro username
409 "DID já está cadastrado" usuário fixo cujo DID derivado já existe usar outro usuário ou reaproveitar o DID existente disponível
Tráfego do tronco cai com 401/407 IP autorizado não sincronizado/recarregado conferir Endereços Confiáveis e rodar o reload address

Tabela de referência rápida

Botão Onde O que faz
[Nova Linha] toolbar de Linhas (ou detalhe do cliente → aba Linhas) abre o dialog
[Adicionar IP] seção Tronco SIP (criação) adiciona campo de IP autorizado
[Adicionar host] seção Hosts de entrega adiciona host de entrega
[Criar] rodapé do dialog salva via POST /lines
[Salvar linha] rodapé do dialog em edição salva via PUT /lines/<id>