Ir para o conteúdo

Roteiro: Diagnóstico de mídia — sem áudio, unilateral e anúncio que não toca

Perfil necessário: viewer (diagnóstico) | admin (correções) Menus usados: Operação, Plataforma, Sistema Risco: baixo (roteiro de triagem; alterações só ao final, com correção direcionada) Rollback: reverter apenas o ajuste aplicado na seção correspondente (status de destino, MS ativo, anúncio) e recarregar o módulo afetado.

Pré-requisitos

  • [ ] Call-ID de uma chamada afetada (CDR ou relato do cliente)
  • [ ] Acesso de viewer ao admin; acesso de shell ao host para journalctl/MI quando necessário

Mapa rápido: sintoma → página

Sintoma Primeira página a checar Depois
Chamada conecta (200 OK) sem áudio Infraestrutura → RTPEngine (status dos destinos) CDR → Fluxo em janela (estágio MEDIA)
Áudio em um só sentido (unilateral) Fluxo em janela do CDR (MEDIA offer/answer) RTPEngine + firewall RTP
Negação sem voz do anúncio (só code/reason) Infraestrutura → Anúncios (ativo + áudio) Media Servers (Ativo) → Dispatcher (set 900)
Anúncio toca tom de reordem Anúncios (arquivo de áudio do código) volume freeswitch/sounds/announcements
TTS falha ao gerar Anúncios → Configurações TTS (chave de API) endpoint/modelo Minimax
Perfil não toca áudio em nenhuma negação Tratamento de bloqueio do perfil (Saída) Comercial → Políticas → Saída → perfil
Todas as chamadas sem mídia (não só negações) systemctl status rtpengine-daemon + firewall RTPEngine

Passo a passo

1. Abrir o fluxo SIP da chamada (estágio MEDIA)

Caminho: Operação → CDR → localizar a chamada → [Fluxo em janela] (ou Carregar Logs para logs inline)

O endpoint GET /api/dashboard/sip-flow/{callid} combina call_log, journals do OpenSIPS/RTPEngine e o CDR no contrato sip-flow.v1. Os eventos de mídia aparecem no estágio MEDIA:

  • media.offer result=ok / media.answer result=ok (engine=rtpengine): oferta e resposta SDP ancoradas com sucesso.
  • media.offer result=error: RTPEngine não conseguiu alocar a sessão — siga o passo 2.
  • media.treatment_skipped (Tratamento de áudio ignorado…): negação sem áudio por chamada já cancelada ou falha global 6xx — comportamento esperado, não é defeito.
  • msoutbound: audio | code=... ruri=sip:*an-<code>@... (nos logs OpenSIPS): tratamento de áudio relayado ao media server.

Leitura por sintoma:

Achado no fluxo Interpretação Ir para
Sem eventos MEDIA com 200 OK RTP não ancorado (daemon parado/firewall) passo 2
media.offer result=error RTPEngine rejeitou o offer passo 2
offer/answer OK, mas sem áudio RTP bloqueado entre as pontas (NAT/firewall) passo 2 + firewall
Falha (FAIL) com code do anúncio e sem INVITE ao MS modo signaling no perfil, MS indisponível ou anúncio inativo passos 3–4
INVITE com *an-<code> ao MS e depois timeout MS fora/sem resposta passo 3

2. Checar os destinos RTPEngine

Caminho: Plataforma → Infraestrutura → RTPEngine

RTPEngine com o botão Novo RTPEngine destacado

  • Todos os destinos de produção com Status = active e Atualizado recente.
  • No host: systemctl status rtpengine-daemon e journalctl -u rtpengine-daemon --grep '<call-id>'.
  • Se houve mudança recente de socket/porta, conferir o rtpengine_sock do CFG instalado (/etc/opensips/opensips.cfg).

Correção típica: destino inactive/maintenance → voltar para active; daemon parado → subir o serviço. Ver detalhes em media-rtpengine.md.

3. Checar media servers e dispatcher (causa do "anúncio não toca")

Caminho: Plataforma → Infraestrutura → Media Servers

Media Servers com o botão Novo Media Server destacado

  • Ao menos um MS com Ativo = Sim. Se nenhum estiver ativo, toda negação em modo áudio cai no fallback SIP do anúncio (code/reason) — o caller recebe o code sem ouvir voz.
  • No host: docker compose ps freeswitch, docker compose exec freeswitch fs_cli -x status.

Caminho: Plataforma → Infraestrutura → Dispatcher → localizar o set do MS (padrão 900, attrs = media_server=1)

Dispatcher com o botão Novo Dispatcher destacado

  • Destino do MS presente, Estado = Ativo, Probe = Ligado (saúde via OPTIONS).
  • Se a entrada sumiu ou divergiu: re-sincronizar salvando o MS na página Media Servers (não editar o set 900 à mão).
  • Estado real na memória: opensips-cli -x mi ds_list.

Correção típica: MS Inativo → reativar; destino ausente → salvar o MS de novo; qualquer mudança → Sistema → OpenSIPS → Recarregar todos os módulos (cartão Dispatcher para ds_reload).

4. Checar o anúncio específico

Caminho: Plataforma → Infraestrutura → Anúncios de Mídia

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

  • Linha do código esperado (ex. nocredit) com Ativo = Sim e ícone de áudio habilitado (arquivo existe).
  • Botão de alto-falante da linha: ouvir o prompt (deve tocar voz, não silêncio/tom).
  • Configurações TTS (se o áudio nasce de TTS): card verde "API configurada"; conferir modelo/voz.
  • No host: freeswitch/sounds/announcements/<code>.* presente no volume montado no container; o dialplan do MS toca announcements/<code>.wav e cai em tom de reordem quando o arquivo não existe.
  • Cache: o OpenSIPS guarda o anúncio resolvido por 300s — mudanças podem levar ~5 min sem restart.

Correção típica: anúncio inativo → ativar; sem áudio → gerar TTS (media-announcements.md); tom de reordem → enviar/gerar o arquivo do código.

5. Checar o modo de tratamento do perfil (quando nenhuma negação toca áudio)

Se o fluxo mostra FAIL com code/reason direto (sem INVITE ao MS) para todas as negações de um cliente, o perfil da linha provavelmente está em signaling:

  • Caminho: Comercial → Políticas → Saída → botão [Editar] (lápis) do perfil → dialog Editar Perfil → campo Tratamento de bloqueio.
  • Áudio (via media-server) (audio): negação desviada ao MS para tocar o anúncio e encerrar; Somente sinalização SIP (signaling): o SW responde direto com o code/reason do anúncio (default seguro).
  • A consulta do modo é cacheada pelo OpenSIPS (120s) — alternar o perfil exige janela para valer nas chamadas novas.

6. Aplicar correção e recarregar

Caminho: Sistema → OpenSIPS Clique: [Recarregar todos os módulos] (ou cartão Dispatcher para mudanças do dispatcher)

Reload OpenSIPS com o botão Recarregar todos os módulos destacado

Resultado esperado: card verde; repetir a chamada de teste e conferir o estágio MEDIA no fluxo.

Validação

  • [ ] Fluxo da nova chamada de teste com media.offer/answer result=ok (quando o sintoma era sem áudio/unilateral)
  • [ ] Negação de teste toca o anúncio (quando o sintoma era "não toca") e encerra normalmente
  • [ ] Fallback SIP confirmado com o MS fora: caller recebe o code/reason cadastrado
  • [ ] RTPEngine: destinos active; Dispatcher set do MS: destino Ativo com probe
  • [ ] CDR da chamada com outcome de tratamento coerente (ex. nocredit → 402 Payment Required)

Erros comuns

Sintoma Causa provável Correção
Sem eventos MEDIA no fluxo com 200 OK RTP não ancorado: daemon parado ou enable_rtp_relay/modo de mídia do perfil Subir rtpengine-daemon; conferir perfil (anchor)
Áudio unilateral NAT/firewall no destino ou âncora desativada Conferir firewall RTP (16384–32768/udp MS, faixa do rtpengine); force_anchor do perfil
media.offer result=error RTPEngine recusou o offer (sem socket/overload) Passo 2; journal do rtpengine
Negação sem voz, code certo MS inativo ou dispatcher set 900 sem destino Passo 3; reativar MS; recarregar
Negação sem voz, code errado (503) Código do anúncio inexistente/inativo Passo 4; ativar/criar o anúncio
Anúncio toca tom de reordem Arquivo <code> ausente no volume do MS Gerar TTS ou enviar áudio
Anúncio antigo toca após edição Cache de anúncios do OpenSIPS (300s) Aguardar ~5 min ou reiniciar em janela
Perfil nunca toca áudio Tratamento de bloqueio = Somente sinalização SIP no perfil Passo 5; alternar para Áudio (via media-server)
media.treatment_skipped no fluxo Chamada cancelada ou falha 6xx antes do tratamento Comportamento esperado — não corrigir
Mudança no dispatcher não surte efeito ds_reload não executado Sistema → OpenSIPS → Recarregar todos os módulos

Impacto operacional

  • Triagem começa no fluxo SIP (MEDIA) e depois confere as três páginas de infraestrutura — evitar alterações em cadeia sem evidência do estágio.
  • Mudanças de mídia afetam chamadas novas; chamadas em curso mantêm a sessão já ancorada.
  • Anúncios são a "voz" da plataforma em falha: antes de editar code/reason, simular com chamada de teste e conferir o CDR.