Ir para o conteúdo

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

RTPEngine com botão Novo RTPEngine destacado

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

Media servers com botão Novo Media Server destacado

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]

CDR

Confira o estágio MEDIA:

  • Sem MEDIA com 200 OK → RTPEngine não alocou (checar passo 1 e firewall de RTP).
  • MEDIA unilateral → NAT/firewall no destino; conferir atributos de âncora no endpoint.

Live calls para ver chamadas em curso

4. Anúncios (quando o sintoma é "não toca o anúncio")

Caminho: Plataforma → Infraestrutura → Anúncios

Anúncios com botão Novo Anúncio destacado

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

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]

Reload

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.