Genesys Cloud - Developer Community!

 View Only

Sign Up

  • 1.  Question about different ringtones for each interaction type in embedded Framework.

    Posted 11-03-2025 07:15

    As an agent (or admin), I'd like to be able to have different 'ring tones' for each interaction type so that I know what type of interaction is being offered by the sound alone.

    Is there any API, to achieve this in Embedded Frame work.

    Thank you.


    #EmbeddableFramework

    ------------------------------
    Sai Shankar
    x
    ------------------------------


  • 2.  RE: Question about different ringtones for each interaction type in embedded Framework.

    Posted 11-04-2025 06:20
    Edited by Brian Jones 11-04-2025 06:20

    Greetings Sai:

    Given there currently isn't even a way to do this in the desktop/web application, there isn't an existing API that covers that capability. Fortunately you're not the first to ask for this in some capacity though (especially since the feature was lost for those of us migrating from PureConnect).

    Please check out and vote for an existing (or even post your own) ringtone idea to get it on Genesys' radar: https://genesyscloud.ideas.aha.io/ideas/search?query=ringtone



    ------------------------------
    Brian T. Jones | Ascension | Senior Specialist - Technology
    ------------------------------



  • 3.  RE: Question about different ringtones for each interaction type in embedded Framework.

    Posted 11-05-2025 14:07

    Olá @Sai Shankar. A plataforma não permite alterar o tom de toque nativo do WebRTC diretamente - o áudio de chamada é controlado pelo próprio cliente WebRTC, e não existe hoje uma configuração ou API para substituir o som padrão por tipo de mídia.

    Porém, se você tiver a possibilidade de carregar o Genesys Cloud dentro de uma página própria (seja no CRM, intranet ou aplicação web), utilizando o Embeddable Framework, aí sim é possível personalizar o comportamento. Nesse modelo, você não altera o toque interno do WebRTC, mas adiciona sons personalizados acionados pelos eventos de oferta de interação.

    Como funciona na prática

    1. Você cria ou usa uma página já existente (ex.: CRM, aplicação web, portal interno).

    2. Nessa página, você carrega o Embeddable Framework (o widget do Genesys Cloud).

    3. O EF expõe eventos como:

      • conversation:alerting

      • conversation:connected

      • conversation:terminated

    4. A partir desses eventos, você toca seus próprios áudios, escolhidos conforme o tipo de interação.

    Exemplo de lógica:

    

    

    

    

    

    

    efBus.on('conversation:alerting', (event) => {
   const mediaType = event.mediaType; // voice | chat | email | message
   tocarSom(mediaType);
});

efBus.on(['conversation:connected','conversation:terminated'], () => {
   pararSom();
});

    Em que tocarSom() chama um Audio() definido por você (ex.: chat.mp3, whatsapp.mp3, email.wav, etc.).

    Resultado

    • Voice: o toque padrão do WebRTC continua sendo reproduzido (não é removido), mas você pode complementar com um alerta visual ou outro som baixo.

    • Chat / Mensagens / E-mail: você pode ter tons totalmente diferentes, pois esses canais não possuem toque próprio - aqui a personalização funciona muito bem.

    Por que essa abordagem é a correta

    • Você não precisa modificar o cliente Genesys.

    • Você usa apenas eventos oficiais e suportados.

    • A personalização fica isolada na sua página (CRM, portal ou web app).

    • Evita soluções inseguras ou não suportadas.



    ------------------------------
    Fernando Sotto dos Santos
    Consultor Grupo Casas Bahia
    ------------------------------



Related Content