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]

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]

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]

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]

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)

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]

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]

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]

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áveiscom tagline:<id>e métodoip_did - [ ] Funcional (linha SIP): subscriber criado em
Roteamento → Avançado → Usuários SIPcomusername@dominioda linha; DID primary criado se usuário era fixo - [ ] Funcional: reload
addresssem 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 ' |
usuário SIP reutilizado | escolher outro username |
| 409 "DID |
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> |