Roteiro: Triagem inicial de chamada com falha (passo zero)¶
Perfil necessário: admin ou viewer Menus usados: Operação (Logs, CDR, Chamadas Ativas), Sistema (Configuração) Risco: baixo (leitura) Rollback: não aplicável
Quando usar¶
Cliente reporta "chamada não sai"/"chamada cai"/"sem áudio" e você ainda não sabe a categoria do problema. Este é o passo zero: 15 minutos de triagem que direcionam para o roteiro certo.
Triagem¶
1. A chamada chegou?¶
Operação → Chamadas Ativas (em curso) e CDR (encerradas).
- Nem em CDR nem em Ativas → nem chegou à plataforma: verificar Registros SIP (endpoint registra?) e Firewall (IP liberado?). → noc-registros-sip
2. Chegou e rejeitou dentro da plataforma?¶
CDR com código 4xx/5xx e endpoint origem = plataforma:
- 401/403/407 → autenticação/origem: Registros SIP e Endereços Confiáveis
- 404 → DID/linha não resolve: commercial-did-portabilidade e vínculo de linha
- 486/487 → destino ocupou/cancelou: problema do lado destino
- 488/415 → codecs/media: → media-diagnostico
3. Saiu e falhou no carrier?¶
CDR com rota preenchida + código de falha EGRESS:
- Ver tronco em quarentena: → carrier-trunk
- CLI wire format: rejeição 403/487 pelo carrier costuma ser CLI/PAI inválido
4. Completou mas sem áudio?¶
200 OK + duração + reclamação de áudio → media-diagnostico (passo 3: fluxo SIP estágio MEDIA).
5. Suspeita de mudança recente?¶
Sistema → Configuração: flags recentemente alteradas (feature flags podem desviar comportamento); Sistema → Logs para correlacionar timestamp da falha com eventos do OpenSIPS.
Árvore de decisão rápida¶
Chamada existe?
├─ Não → Registros SIP / Firewall / Endereço Confiável
├─ Rejeitada na plataforma (4xx interna)
│ ├─ 401/403/407 → autenticação/origem
│ ├─ 404 → DID/linha
│ └─ 488/415 → codecs
├─ Saiu e falhou → tronco/CLI (carrier)
├─ 200 + sem áudio → mídia (RTPEngine/RTP)
└─ 200 com áudio mas cliente reclama → auditoria de fluxo SIP
Validação¶
- [ ] Categoria do problema identificada e roteiro alvo escolhido
- [ ] Evidência coletada (Call-ID, código, rota, timestamps)
- [ ] Ticket atualizado com a triagem
Erros comuns¶
| Sintoma | Causa provável | Correção |
|---|---|---|
| Nada em CDR/Ativas | origem bloqueada antes do SIP | firewall/endereço confiável |
| 403 em massa de um cliente | IP do cliente fora da lista de origem | atualizar endereço confiável + reload |
| Falha só para um destino | rota/carrier específico | roteiro carrier |