Click-to-Call

Click-to-Call permite que seus contatosClosed A pessoa que interage com um agente, Rvi ou bot em seu contact center. liguem para um agente em tempo real com um único clique. A partir de um botão no seu site da Web, os visitantes podem iniciar uma chamada direta a um agente. Isso pode ajudar você a reduzir ou eliminar:

  • Etapas adicionais ao se conectar a uma equipe de vendas ou de Suporte.

  • Custos indiretos, como taxas de número de serviço e sobretaxas de celular.

Click-to-Call funciona por meio de um kit de desenvolvimento de software (SDK) escrito em JavaScript. Para deixá-lo configurado, colabore com um criador para implementar o SDK no seu site da Web. Você também deve trabalhar com um representante de conta que possa fornecer credenciais específicas.

Fatos principais sobre a chave Click-to-Call

  • Click-to-Call é suportado em navegadores de computadores de mesa. Atualmente, não é compatível com dispositivos móveis.

  • Click-to-Call atualmente tem suporte nestas regiões:

    • Canadá

    • Alemanha

    • Japão

    • Reino Unido

    • EUA

  • Informações principais sobre o Click-to-Call SDK incluem:

  • O SDK consiste em um único arquivo clicktocall.js. Isso deve ser incluído ou referenciado em cada página da web em que você deseja que o botão Click-to-Call seja exibido. Também é necessário implementar os seus próprios componentes da UI, como o botão Click-to-Call e os controles de chamadas. O botão Click-to-Call deverá chamar a função makeCall no SDK, que inicia uma chamada WebRTC. Caso a solicitação de chamada seja autenticada pelo NiCE CXone, a chamada será efetuada.

  • O SDK fornece uma opção para passar dados do usuário, metadados do site e dados de roteamento como parte da solicitação SIP invite usando cabeçalhos X. Você deve configurar seu script Studio associado ao ponto de contatoClosed O ponto de entrada que um contato de entrada usa para iniciar uma interação, como um número de telefone ou endereço de e-mail. Click-to-Call para obter os dados e usá-los conforme necessário. Isso pode incluir a exibição de dados do usuário em uma tela pop-up para agentes ou o uso dos dados de roteamento para tomar decisões de roteamento.

    Esta disposição é opcional e você deve configurá-la somente se precisar dela. Se você não precisar dela, poderá configurar a função makeCall() sem passar nenhum dado.

    Coletar e transmitir dados é de sua responsabilidade. O SDK fornece apenas o mecanismo para transmitir os dados. Ele não gera, valida nem gerencia os dados.

  • Para atualizações do SDK Click-to-Call:

    • Alterações, incluindo melhorias, novas funcionalidades e atualizações de compatibilidade, não ocorrem em uma agenda fixa.

    • O SDK é entregue como um único arquivo JavaScript. Quando uma atualização está disponível, NiCE fornece a você a versão mais recente. Você deve, então, substituir o arquivo existente em sua implementação.

    • O SDK mantém a compatibilidade com versões anteriores, de modo que as versões existentes continuem a funcionar sem interrupções. No entanto, se ocorrer uma alteração importante, pode ser necessário que você atualize para a versão mais recente.

Pré-requisitos de integração

Para preparar para integrar Click-to-Call ao seu site, é necessário:

  • Obtenha um Id DO cliente com seu representante de conta.

  • Trabalhe com seu representante de conta para provisionar números de telefone específicos para Click-to-Call.

  • Implemente uma API POST no seu próprio servidor. Esta API deve gerar um token JWT para autenticação. Isso confirma que as solicitações de chamadas recebidas sejam legítimas.

  • Forneça a chave pública à sua conta de representante para autenticação.

  • Considere o design da sua interface. Você deverá criar a sua própria IU do lado do contato da chamada, inclusive os botões de controle de chamada, como colocação de chamadas no mudo ou encerramento de chamadas. O SDK inclui exemplos de componentes Reagir e Angular que poderão ser usados pelos criadores como referência e inspiração. O lado do agente da chamada é tratado em seu aplicativo de agente, portanto, o desenvolvimento da UI é necessário somente para o lado do contato.

Configuração do NiCE CXone

Além de adicionar a funcionalidade Click-to-Call ao seu website, você também deve garantir que os componentes de roteamento estejam configurados em NiCE CXone. O seu administrador NiCE CXone poderá configurar os componentes necessários.

Assegure-se de ter:

  • Uma competência de voz de entrada ACD skill criada com os agentes necessários atribuídos a ela.

  • Pontos de contato configurados para as chamadas de voz. Esses devem ser POCs de telefone para cada número de telefone Click-to-Call. O criador que estiver implementando o Click-to-Call no seu site deverá utilizar isso para contactAddress no arquivo JavaScript.

  • Um script Studio para rotear as chamadas para um agente.

Dependendo da configuração do seu NiCE CXone, talvez você possa usar componentes de roteamento existentes, ou talvez seja necessário criar e configurar novos.

Integração de SDK

Assegure-se de ter concluído ou preparado os itens necessários da seção prerrequisitos.

  1. Conforme a necessidade, incorpore o arquivo clicktocall.js à sua página da Web.

  2. No arquivo clicktocall.js, defina o URL de terminal de API da API POST.

    let getJWT1TokenURL = '<YOUR_TOKEN_ENDPOINT_URL>';
  3. Adicione os seguintes componentes de UI ao seu website. Assegure-se de atribuir a cada componente um identificador exclusivo. O pacote do SDK inclui exemplos de componentes de UI em React e Angular. É possível encontrá-los no diretório do IntegrationHelpers/UIComponents.

    • Botão para iniciar a chamada de voz.

    • Botão para desligar ou desconectar a chamada.

    • Botão para colocar o áudio da chamada no mudo ou restituir o som.

    • Botão para exibir um teclado para Entradas dtmf.

    • Um <div> para exibir as teclas do teclado.

    • Rótulo para exibir mensagens de sucesso ou erro da chamada.

    • Um tag <audio> que executará determinados sons, como tons de discagem ou de conexão de chamadas, por exemplo.

  4. Atualize o arquivo clicktocall.js com referências aos componentes da IU que tiverem sido adicionados na etapa anterior.

    let clickToCallButtonId = '<YOUR_CLICK_TO_CALL_BUTTON_ID>';
    let hangUpButtonId = '<YOUR_HANG_UP_BUTTON_ID>';
    let muteAudioButtonId = '<YOUR_MUTE_AUDIO_BUTTON_ID>';
    let keypadButtonId = '<YOUR_KEYPAD_BUTTON_ID>';
    let dtmfKeyDivId = '<YOUR_DTMF_KEY_DIV_ID>';
    let callStatusMessageLabelId = '<YOUR_CALL_STATUS_MESSAGE_LABEL_ID>';
    let remoteAudioId = '<YOUR_AUDIO_CONTROL_ID>';
  5. Ajuste as suas preferências na seção de configurações do arquivo clicktocall.js. Esta é uma seção com várias variáveis de configuração que controlam determinados tipos de comportamento.

    • Ajuste a contagem de tentativas repetidas com retryCount. Caso uma chamada seja desconectada, este é o número de vezes que o sistema tentará reconectá-la. O padrão é 3.

    • Ajuste o POCREnvironmentXHeaderValue valor como sendo PROD.

    • Defina as configurações do servidor de telefone em phoneServerConfig e clientId.

      let phoneServerConfig = {
      	domain: '<Domain of the SIP server>', //Set value of this configuration to 'cxonevoice.com'
      	addresses: [], //Keep this array empty
      	iceServers: [], //Keep this array empty
      	userName: '<username>', //This configuration is a human-readable string used to identify the sender in a more friendly way. In agent applications like CXone Agent, this might be displayed on the screen during a call. Tthis value should not contain any spaces and should not exceed 20 characters. 
      	displayName: '', // This is an optional field and its value can be kept the same as userName 
      	password: '' //Keep this field empty
      }
      let clientID = '<YOUR_CLIENT_ID>'; //Set the value of this configuration as provided by CXone 
  6. Se você quiser personalizar as notificações do lado do contato relacionadas a chamadas com falha ou desconexão, altere as cadeias de texto nas seguintes variáveis em clicktocall.js.

    • callFailedToConnectErrorMessage

    • uiErrorMessage

    • contactSupportTeamMessage

    let callFailedToConnectErrorMessage = 'Call failed to connect. Service not available!';
    let uiErrorMessage = {
    'Default': 'Error occurred. Please try again!',
    'Terminated': 'Call ended successfully!',
    'Canceled': 'Call cancelled. Please try again!',
    'Failed': callFailedToConnectErrorMessage,
    'login failed': callFailedToConnectErrorMessage,
    'disconnected': callFailedToConnectErrorMessage,
    'logout': callFailedToConnectErrorMessage,
    'SIP Failure Code': callFailedToConnectErrorMessage,
    'RTP Timeout':  'RTP Timeout': 'The call ended unexpectedly due to network issues. Please ensure your internet is stable and try placing the call again!',
    'Token Claims': 'An error occurred during the call attempt. Please retry!'
    						}
    let contactSupportTeamMessage = "We're sorry, could not connect the call. Please try again later or contact our support team!";
  7. Configure recursos baseados em localização se você quiser alocar os recursos mais próximos para tratar solicitações de Click-to-Call. Para fazer isso, execute o seguinte em clicktocall.js:

    1. Use a função getAvailableLocations() para retornar uma lista de localizações em que os recursos necessários, como Session Border Controllers (SBCs), estão implantados. Essas localizações ajudam a determinar o melhor recurso para processar as solicitações de Click-to-Call.

    2. Integre a seleção de localização na UI. Você pode fazer isso de uma das duas maneiras a seguir:

      • Controle selecionável pelo usuário: Forneça um elemento selecionável, como uma lista suspensa ou botão de opção, que permita que os contatos selecionem sua localização mais próxima entre as opções fornecidas pela função getAvailableLocations().

      • Mapeamento automático: Se o sistema puder determinar a localização do contato, mapeie-a para uma das localizações expostas pela função getAvailableLocations() e passe-a para a função makeCall().

    3. Configure a localização padrão. Para fazer isso, defina a variável defaultLocation para a localização de onde seus contatos mais frequentemente ligam. A localização padrão deve ser uma das localizações retornadas pela função getAvailableLocations().

      // Variable to store default location
      let defaultLocation = "US";
  8. Adicione o método makeCall(contactAddress, [location], [userData], [routingData]) ao botão Click-to-Call. Os parâmetros location, userData e routingData são opcionais.

    O parâmetros userData e routingData transmitem dados de usuário e de roteamento para uso em decisões de roteamento ou para exibição em Agent Workspace (Agent). Isso é feito como parte da solicitação de convite SIP usando cabeçalhos X X. Você pode então processar os dados no script Studio usado para o ponto de contato.

    • Exibe informações relacionadas a userData: Usuário.
    • routingData: Exibe dados usados para decisões de roteamento.

    Esses parâmetros devem ser fornecidos como objetos contendo pares de chave-valor. O SDK converte ambos os objetos em strings usando JSON.stringify() e os transmite como cabeçalhos X na solicitação de convite SIP:

    • X-user-data: Contém o objeto userData.

    • X-routing-data: Contém o objeto routingData.

    userData e routingData são objetos separados, portanto você pode separar os dados, caso necessário. No entanto, você pode passar todos os dados necessários em apenas um dos parâmetros, se preferir. Você também pode transmitir todos os dados dentro de um único cabeçalho X, se o seu script Studio estiver configurado de acordo.

    Devido a limitações no tamanho dos dados que podem ser passados em cabeçalhos X, o tamanho em caracteres de cada objeto userData e routingData não deve exceder 1.000 caracteres (1 KB) após a conversão de string.

    Consulte os exemplos a seguir para configurá-lo de acordo com o seu caso de uso específico:

    • Sem passar nenhum parâmetro:

      makeCall(contactAddress);
    • Passar somente location:

      makeCall(contactAddress, "US");
    • Transmitindo location, userData e routingData:

      makeCall(contactAddress, "US", { name: "Elizabeth Bennet", age: 20 }, { skill: "sales" });
    • Passar somente userData:

      makeCall(contactAddress, undefined, { name: "John Doe", age: 30 }, undefined);
  9. Se você configurou o método makeCall() para usar os objetos userData ou routingData, deverá processar os dados do cabeçalho X no script Studio associado ao Click-to-Call ponto de contatoClosed O ponto de entrada que um contato de entrada usa para iniciar uma interação, como um número de telefone ou endereço de e-mail. usando estas ações:

  10. Para enviar tons DTMF, chame a funçãoClosed Tons de sinalização gerados quando um contato pressiona uma tecla do teclado do telefone. guiSendDTMF(digit) quando um botão DTMF for clicado.

  11. Teste sua configuração para garantir que ela possa iniciar e rotear chamadas com sucesso.