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

- Todos os destinos de produção com Status = active e Atualizado recente.
- No host:
systemctl status rtpengine-daemonejournalctl -u rtpengine-daemon --grep '<call-id>'. - Se houve mudança recente de socket/porta, conferir o
rtpengine_sockdo 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

- 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)

- 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

- 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 tocaannouncements/<code>.wave 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)

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.