Ir para o conteúdo

Roteiro: Criar DID com portabilidade, caller-id e dígitos inbound (DidFormDialog completo)

Perfil necessário: admin Menus usados: Comercial Risco: médio (dígitos inbound errados quebram o roteamento de entrada; DID portado mal classificado roteia para o destino errado) Rollback: editar o DID corrigindo os campos, ou excluir o DID; não há reload dedicado — o routing inbound resolve por banco em memória recarregável via reload geral quando regras derivadas mudarem

Pré-requisitos

  • [ ] Número E.164 disponível (dígitos, começando em 55 ou 0, 10–15 dígitos, sem +)
  • [ ] Linha destino já criada quando o DID vai atribuído (ver commercial-criar-linha.md)
  • [ ] Operadora de portabilidade cadastrada quando o status é Portado para fora
  • [ ] Tipo de serviço decidido (Padrão, 0800, 0300)

Passo a passo

1. Abrir a criação de DID

Caminho: Comercial → DIDs Clique: [Novo DID]

Listagem de DIDs com o botão Novo DID destacado

Resultado esperado: dialog Novo DID com campos de número, filtro de linhas, portabilidade, flags e dígitos inbound. Aberto pelo detalhe do cliente, o filtro de linhas já vem travado no cliente.

2. Informar o número e a linha

Caminho: dialog Novo DID Clique: campo [Número E.164 da plataforma]

Dialog Novo DID com o campo Número E.164 destacado

Preencha:

Campo Obrig. Formato/exemplo Efeito
Número E.164 da plataforma * sim 554933332222 (só dígitos, sem +) número do inventário; backend aceita apenas dígitos iniciando em 55 ou 0
Filtrar linhas por cliente não seletor por cliente atalho de UI para achar a linha; o dono do DID é derivado da linha
Linha não seletor #<id> - <tipo> (<cliente>) linha dona do DID
Status não Disponível (default), Atribuído, Reservado, Portado para fora habilitação/inventário

Regras aplicadas pelo dialog e pelo backend: DID vinculado a linha deve ficar como Atribuído; Atribuído exige linha; marcar linha volta status de Disponível/Reservado para Atribuído automaticamente.

3. Portabilidade (portado dentro/fora e operadora)

Caminho: dialog Novo DID Clique: campo [Portado para dentro em]

Dialog Novo DID com o campo Portado para dentro em destacado

Preencha:

Campo Obrig. Formato/exemplo Efeito
Portado para dentro em não data/hora (dd/mm/aa hh:mm) auditoria de DIDs recebidos por portabilidade
Portado para fora em não data/hora; habilitado só com status Portado para fora data da saída da planta
Operadora atual não operadora; habilitado só com status Portado para fora carrier atual quando o número saiu da planta local

Resultado esperado: mudar o status para Portado para fora libera os dois campos; voltar o status limpa data e operadora automaticamente.

4. Tipo de serviço e flags de caller-id/outbound

Caminho: dialog Novo DID Clique: seletor [Tipo de serviço]

Dialog Novo DID com o seletor Tipo de serviço destacado

Preencha:

Campo Obrig. Formato/exemplo Efeito
Tipo de serviço não Padrão (default), 0800, 0300 0800/0300 habilitam elegibilidade de tarifação reversa conforme o plano da linha
Primary — CallerID default da linha (só um por linha) não toggle; exige linha atribuída DID vira o CLI default; criar como primary rebaixa o primary anterior da mesma linha
Permitir como caller-id apresentado não toggle, default ligado DID pode ser apresentado como CLI em saída
Permitir chamadas saintes não toggle, default ligado DID pode originar chamadas saindo da linha

5. Dígitos entregues no inbound e salvar

Caminho: dialog Novo DID → Dígitos entregues no inbound Clique: [Criar]

Dialog Novo DID com o seletor Dígitos entregues no inbound e o botão Criar destacados

Preencha:

Campo Obrig. Formato/exemplo Efeito
Dígitos entregues no inbound * sim na criação Completo (CC + CN + N8/N9) (0), 10 (CN + N8), 11 (0 + CN + N8), 8 (N8), 4 (N4) quantos dígitos do DID entram no user-part do SIP URI de destino; default operacional é 10 (CN + N8)

Resultado esperado: toast DID criado, dialog fecha, DID listado com cliente/linha, flags (Primário/CLI/Outbound), portabilidade, serviço, dígitos inbound e status.

Validação

  • [ ] Visual: DID na listagem com linha vinculada e Tag de dígitos correta (10 (CN+N8), Completo etc.)
  • [ ] Funcional: chamada de entrada do carrier para o DID cai na linha certa; user-part do URI de destino no CDR/fluxo SIP tem a quantidade de dígitos configurada
  • [ ] Funcional: chamada sainte da linha apresenta o DID marcado como Primary (quando houver)

Erros comuns

Sintoma Causa provável Correção
"O número deve ter entre 10 e 15 dígitos" / "Apenas dígitos são permitidos" E.164 com +, letras ou tamanho errado digitar só dígitos, sem +, iniciando em 55 ou 0
"DIDs com status Atribuído precisam de linha" status Atribuído sem linha escolher a Linha ou voltar para Disponível
"DIDs vinculados a uma linha devem ficar como Atribuído" linha escolhida com status Disponível/Reservado o dialog muda o status sozinho; se falhar, ajuste manualmente
"is_primary exige linha atribuída" toggle Primary sem linha atribuir a linha antes de marcar Primary
409 "DID já cadastrado" E.164 duplicado conferir inventário e usar o DID existente
Chamada inbound não cai na linha dígitos inbound divergentes do formato que o carrier entrega comparar o user-part recebido no CDR com a opção escolhida e ajustar

Tabela de referência rápida

Botão Onde O que faz
[Novo DID] toolbar de DIDs (ou detalhe do cliente → aba DIDs) abre o dialog
[Criar] rodapé do dialog salva via POST /dids
[Salvar] rodapé do dialog em edição salva via PUT /dids/<id> (E.164 fica travado em edição)