Ring-Ready (FreeSWITCH)

Este documento explica o conceito de Ring-Ready no FreeSWITCH, seus riscos e como desativá-lo, oferecendo um guia rápido para suporte técnico e desenvolvedores.

🔹 O que é o Ring-Ready

O Ring-Ready é um app/dialplan flag do FreeSWITCH que instrui o sistema a enviar a resposta 183 Session Progress com SDP, ativando o early media.

🔹 Como funciona

Sem Ring-Ready

• O FreeSWITCH envia apenas 180 Ringing (sem SDP).
• O endpoint de origem gera o tom de ringback local.
• O fluxo de áudio só é estabelecido no 200 OK.

Com Ring-Ready

• O FreeSWITCH envia 183 Session Progress com SDP.
• O chamador passa a receber áudio da rede (URA, anúncios, tom remoto).
• Há negociação antecipada de codec e RTP.

🔹 Riscos de uso

Se o SDP enviado no 183 contiver erros, pode ocorrer chamada muda. Exemplos de erro:

• IP inválido ou privado (problemas de NAT).
• Portas RTP incorretas ou bloqueadas.
• Codecs incompatíveis entre as pontas.

🔹 Como desativar

Caso não haja interface web para configuração, o ring_ready pode aparecer em dialplan, console (fs_cli) ou scripts. Exemplos e instruções abaixo.

Dialplan XML

Arquivo comum: /usr/local/freeswitch/conf/dialplan/

Trecho típico:

<action application="ring_ready"/>

Desativar removendo ou comentando:

<!-- <action application="ring_ready"/> -->

Console (fs_cli)

Comando que pode ser executado manualmente:

uuid_ring_ready <UUID>

Desativação: não executar esse comando em scripts ou fluxos automatizados.

Scripts (Lua / JavaScript)

Exemplos:

session:execute("ring_ready");
// ou
session.execute("ring_ready");

Desativação: remover ou comentar a linha.

Alternativa segura

Para manter sinalização de ringing sem SDP, use:

<action application="ring"/>

Este comando gera 180 Ringing e mantém o tom local do endpoint.

🔹 Resumo

• Ring-Ready ativa 183 com SDP → early media.
• Pode causar chamadas mudas se o SDP estiver incorreto.
• Remova ring_ready do dialplan, scripts ou comandos UUID para desativar.
• Use ring como alternativa segura (gera 180 Ringing).

© 2025 Ligue Aí - Documentação de Suporte.