Roteiro: Diagnóstico de mídia (RTPEngine, media servers e anúncios)¶
Perfil necessário: admin (ações) / viewer (consulta) Menus usados: Plataforma Risco: médio (reload/restart de mídia afeta chamadas em curso) Rollback: reabilitar destino removido; recarregar/reiniciar conforme componente
Pré-requisitos¶
- [ ] Sintoma conhecido: sem áudio, áudio unilateral, corte, anúncio não toca
- [ ] Call-ID de uma chamada afetada (para o fluxo SIP)
Passo a passo¶
1. Checar destinos RTPEngine¶
Caminho: Plataforma → Infraestrutura → RTPEngine

Clique: [Novo RTPEngine] apenas para adicionar destino novo (host/porta). Para diagnóstico: confira status dos destinos listados (up/down) e estatísticas de chamadas RTP.
Resultado esperado: todos os destinos de produção up; sem queda de pacotes anormal.
2. Checar media servers (FreeSWITCH)¶
Caminho: Plataforma → Infraestrutura → Media Servers

Clique: [Novo Media Server] para registrar novo FreeSWITCH (host, porta ESL, capacidade). Para diagnóstico: status do servidor e chamadas em curso nele.
Resultado esperado: media servers ativos; nenhum com falha de ESL.
3. Abrir o fluxo SIP da chamada afetada¶
Caminho: Operação → CDR → linha da chamada → [Fluxo em janela]

Confira o estágio MEDIA:
- Sem
MEDIAcom 200 OK → RTPEngine não alocou (checar passo 1 e firewall de RTP). MEDIAunilateral → NAT/firewall no destino; conferir atributos de âncora no endpoint.

4. Anúncios (quando o sintoma é "não toca o anúncio")¶
Caminho: Plataforma → Infraestrutura → Anúncios

Preencha (dialog Novo Anúncio — campos principais):
| Campo | Obrig. | Formato/exemplo | Efeito |
|---|---|---|---|
| Código | sim | nocredit |
código lógico do anúncio |
| Padrão R-URI | sim | sip:*an-nocredit@media-server |
URI que o softswitch chama |
| SIP Code (fallback) | sim | numérico, ex. 402 |
código enviado se anúncio falhar |
| SIP Reason (fallback) | sim | Payment Required |
reason do fallback |
| Serviço | não | tts/ivr |
tipo de serviço |
| Texto do Áudio / Áudio | não | texto TTS ou upload | conteúdo |
| Ativo / Descrição | sim/não | booleano/livre | vigência e contexto |
Confira também a configuração TTS (chave de API, voice) no bloco próprio da página quando usar TTS.
5. Dispatcher (quando o destino do anúncio/mídia é dinâmico)¶
Caminho: Plataforma → Infraestrutura → Dispatcher

Confira destinos ativos/estado (probing/available) e, se alterar, recarregue.
6. Recarregar após alterações¶
Caminho: Sistema → OpenSIPS
Clique: [Recarregar todos os módulos]

Validação¶
- [ ] RTPEngine up e alocando (MEDIA no fluxo)
- [ ] Media server ativo (ESL ok)
- [ ] Anúncio toca na chamada de teste; fallback SIP correto quando indisponível
Erros comuns¶
| Sintoma | Causa provável | Correção |
|---|---|---|
| Sem áudio com 200 OK | RTPEngine down ou RTP bloqueado | checar destinos/firewall RTP; re-up destino |
| Áudio unilateral | NAT/âncora RTP errada no endpoint | habilitar âncora RTP; revisar iface |
| Anúncio não toca, chamada cai | R-URI do anúncio errada / media server fora | corrigir URI; subir media server |
| Fallback não envia SIP code | campos fallback vazios | preencher SIP Code/Reason |
| Anúncio TTS mudo | chave de API/voice inválida | revisar bloco TTS |
Impacto operacional¶
- Alterações de mídia afetam chamadas em curso — prefira janelas e valide com chamada real.
- Anúncios são a "voz" da plataforma em falha: fallback SIP errado confunde o cliente.