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
55ou0, 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]

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]

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]

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]

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]

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),Completoetc.) - [ ] 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) |