Roteiro: Terminação por linha (Siga-me / Grupo) e plano de entrega¶
Perfil necessário: admin Menus usados: Comercial (Linhas / Clientes) Risco: médio (muda para onde as chamadas entrantes da linha são entregues; errar o destino desvia chamadas de cliente) Rollback: desabilitar o plano de terminação na aba Terminação e salvar; ou restaurar o plano anterior
Pré-requisitos¶
- [ ] Linha já criada (a terminação só existe em linha existente — a aba aparece na edição)
- [ ] Destinos de entrega conhecidos (URI SIP, grupo, linha) para cada passo
- [ ] Decisão do formato: encadeamento em cascata (siga-me) vs grupo
Passo a passo¶
1. Abrir a edição da linha¶
Caminho: Comercial → Linhas (ou detalhe do cliente, aba Linhas)
Clique: lápis (Editar) na linha → dialog abre com abas extras de edição

2. Abrir a aba Terminação¶
Clique: aba Terminação (Siga-me / Grupo)
O painel exibe o Plano de terminação da linha, gerenciado pelo LineDeliveryPlanManager.
3. Habilitar o plano¶
Clique: toggle Plano habilitado
Sem isso o plano existe mas não roteia — a linha continua entregando no padrão (DIDs/endpoint).
4. Montar a cascata de passos¶
Clique: [Adicionar passo]. Para cada passo:
| Campo | Obrig. | Exemplo | Efeito |
|---|---|---|---|
| Alvo | sim | URI SIP / grupo / linha | quem recebe a chamada neste passo |
| Destino | sim | sip:2101@dominio |
endereço de entrega |
| Toca (s) | sim | 30 |
timeout do toque antes de avançar |
| Avança quando | sim | sem resposta / ocupado / sempre | condição de avanço ao próximo passo |
- [↑] reordena o passo (cascade: passo 1 falhou → passo 2, etc.)
- [🗑] remove o passo
- Ordem importa: o primeiro passo é o destino primário.
5. Salvar e aplicar¶
Clique: [Salvar plano] — salva e publica o plano para a linha.
Resultado esperado: toast de sucesso e a tabela de passos atualizada.
6. Validar¶
- [ ] Chamada de teste para um DID da linha percorre os passos na ordem esperada (conferir em CDR o destino final de cada tentativa)
- [ ] Timeout de cada passo respeita o "Toca (s)"
- [ ] Desabilitar o plano retorna o comportamento padrão
Erros comuns¶
| Sintoma | Causa provável | Correção |
|---|---|---|
| Chamada não segue o plano | Plano habilitado? | ligar o toggle Plano habilitado e salvar |
| Passos fora de ordem | reordenação não salva | usar [↑] e salvar |
| Timeout muito longo | "Toca (s)" alto no passo 1 | reduzir e salvar |
Impacto operacional¶
- A cascata afeta TODA chamada entrante da linha — teste com número de teste antes do horário de pico.
- Destino inválido em um passo quebra a entrega: valide URIs antes de salvar.