Definir configuração de Agent Workspace for Salesforce Voice

Não é possível usar o Unified App Salesforce Voz em ambientes Salesforce Hyperforce ou GovCloud porque esses ambientes não têm suporte atualmente.

A configuração é realizada no Salesforce, portanto, as seções a seguir fornecem instruções gerais. Se você precisar de informações mais detalhadas, passo a passo, visite a central de ajuda do Salesforce. Depois de adicionar as contas de usuário do agente à central de contatos, os agentes podem acessar a guia Telefone no widget Omni-Channel. Nesta guia, eles podem fazer login e começar a atender chamadas. Quando você instala o Agent Workspace for Salesforce Voice, você recebe uma licença de avaliação com 25 estações que expirará após 30 dias. Para evitar essa expiração, você deve falar com seu representante de conta para atualizar sua licença para uma licença ativa. O representante da conta deve criar uma ordem de serviço para atualizar sua licença.

Antes de iniciar

Sua configuração do Salesforce deve incluir (Agent Workspace for Salesforce Voice com licenças de telefonia de Parceiro. Você deve obter essas licenças por meio do Salesforce.

  • Você deve ter uma conta Salesforce com permissões para acessar e configurar a página Configurações de recursos. Use essa conta para executar as etapas desta página.
  • Verifique se as licenças multiparty estão habilitadas para o seu org Salesforce. Abra um caso com Salesforce para habilitar essas licenças. Se você não tem licenças multiparty, Agent Workspace for Salesforce Voice pode apresentar problemas de controle de chamada.
  • Certifique-se de que você está instalando e usando o Agent Workspace for Salesforce Voice em uma plataforma com suporte e em um navegador com suporte.
  • Confirme se você não possui um espaço para nome definido na sua organização do Salesforce. Normalmente, você define um namespace quando usa uma org de desenvolvedor para criar um pacote gerenciado para distribuição. Agent Workspace for Salesforce Voice tem seu próprio namespace e não será executado em uma org que já tenha definido um. Se você já tiver um definido, consulte a ajuda do Salesforce.
  • Se você já tiver uma definição de contact center chamada NICE CXone Contact Center, renomeie-a antes de instalar o aplicativo, pois a instalação falhará ao tentar criar uma nova definição de contact center.
  • Habilitar Omni-Channel — No Configurar do Salesforce, vá para Configurações do Omni-Channel e habilite o Omni-Channel.

  • Certifique-se de que as permissões Multi-party Conferencing e Multi-party Consult estejam habilitadas no Salesforce Voice. Essas permissões são necessárias para que os agentes usem os recursos de Transferência Assistida e Conferência no Agent Workspace. Gere um caso de suporte com o Suporte da Salesforce para que o recurso seja habilitado.

Instalar o Pacote Salesforce

  1. Instale o Pacote Gerenciado mais recente.

    Ex.: Salesforce Fazer login

    Se a URL parcial não for copiada corretamente ou for substituída incorretamente, será exibido um pop-up de erro "A Página não existe".

  2. Atribuir todos os usuários à versão mais recente do pacote instalado.

  3. Selecione NiCE CXone Agent for Salesforce Voz.

  4. Clique em Obter Agora.

  5. Clique em Instalar em produção. Se solicitado, faça login primeiro clicando em fazer login no AppExchange.

  6. Concorde com os termos e condições e, em seguida, clique em Confirm and Install.
  7. Se solicitado, selecione um nome DE usuário e faça login.
  8. Escolha se deseja Instalar Somente para administradores, Instalar para Todos os usuários ou Instalar para Perfis Específicos... e, em seguida, clique em Instalar.

    Se você escolher Instalar para perfis específicos..., você terá a opção de escolher quais perfis têm acesso ao pacote. Você pode definir uma política global usando a configuração Definir o nível de acesso para todos os perfis como e modifique os perfis a partir daí.

  9. Conceda acesso a API.incontact.com e clique em Continuar.

  10. Quando a instalação for concluída, clique em Pronto.
  11. Atribua todos os usuários à versão de pacote mais recente instalada.

    Se os usuários não estiverem atribuídos à versão mais recente do pacote instalado, eles não terão acesso aos componentes atualizados e poderão apresentar erros ou funcionalidades ausentes ao usar Agent Workspace for Salesforce Voice (Agent for SCV).

Agora você deve ver CXone Agent for Service Cloud Voice em Pacotes Instalados. Para navegar até lá, vá para Setup > pesquise por Pacotes Instalados em Salesforce. Lá, você pode ver o número de licenças que possui e a data de expiração.

Configuração de Telefonia do parceiro

Ativar Agent Workspace for Salesforce Voice com telefonia do Parceiro

  1. Faça login na organização do Salesforce onde você deseja instalar Agent Workspace for Salesforce Voice .
  2. Clique em Setup icon of a lightning bolt inside a gear. no canto superior direito em Salesforce. Inicie o aplicativo Setup.
  3. Procure Configuração de telefonia do Parceiro. Selecione o resultado da pesquisa de Configuração de telefonia do Parceiro. Ele não aparecerá se você não tiver licenças de telefonia de Parceiro.
  4. On the Partner Telephony Setup page, configure the following settings:
    • Ativar Omni-Channel → ATIVADO: Ativa o sistema de roteamento Salesforce Omni-Channel, que é necessário para que os agentes recebam chamadas. Se esta opção estiver desativada, os agentes não receberão chamadas por meio do roteamento Omni-Channel.

    • Ativar Service Cloud Voice → ATIVADO: Ativa a integração de voz com o provedor de telefonia (por exemplo, NICE CXone). Se isso estiver desativado, os recursos do Service Cloud Voice serão desativados e o Salesforce não se conectará ao provedor de telefonia.

    • Respeitar Capacidade do agente → Desativado: Quando essa configuração está ativada, Salesforce bloqueia o roteamento de chamadas sempre que um Agente atinge a Capacidade configurada. Isso pode fazer com que chamadas recebidas sejam descartadas inesperadamente no Agent Workspace for Salesforce Voice (Agent for SCV). desative essa configuração para que a capacidade do agente seja gerenciada por meio das Configurações de presença.

Criar um status de presença Disponível

Para permitir que seus agentes atendam chamadas, você deve aplicar o canal Telefone a pelo menos um status de presença. Isso dá a seus agentes de telefone a capacidade de definir seu status como "Disponível" e aceitar chamadas. Você pode criar um novo status ou aplicar um canal Telefone a um status existente. Agent Workspace for Salesforce Voz atualmente oferece suporte somente a status do Salesforce, não a códigos de indisponibilidade do NiCE CXone.

  1. Em Salesforce, clique em Setup icon of a lightning bolt inside a gear. no canto superior direito. Inicie o aplicativo Setup.
  2. Procure Status de Presença e selecione o resultado da pesquisa Status de Presença.
  3. Set an available status:
    • If you want to create a new status:
      1. Clique em Adicionar.
      2. Nomeie o novo status.
    • Se você quiser editar um status existente, clique no status que deseja que os agentes usem para chamadas telefônicas.
  4. Clique para destacar Telefone na lista de canais.
  5. Clique em >> para adicionar Telefone ao status.
  6. Clique em Salvar.

Em alguns ambientes Salesforce, uma chamada recebida ou retorno de chamada pode ser recusada automaticamente quando é oferecida a um agente. Em outros casos, a chamada é conectada, mas o agente vê a mensagem de erro "We cannot decline an already connected call." Isso pode ocorrer quando o Salesforce processa a alteração do agente para Busy antes do evento call_started. O Salesforce então trata o agente como já ocupado e rejeita a interação recebida. O comportamento pode ser intermitente e pode afetar apenas determinadas organizações do Salesforce. Para evitar isso, configure o status de presença associado ao inboundContact no Mapeamento de Status de Presença para transicionar os agentes para Online em vez de Busy:

  1. Em Salesforce, clique em Configuração e pesquise por Presence Status.

  2. Abra o status de presença associado a inboundContact no Mapeamento de Status de Presença, como On Call, e clique em Editar.

  3. Mude a opção de status de Ocupado para Online.

  4. Clique em Salvar.

Atribuir status de presença a perfis de usuário

Após criar o status "Disponível", você deve atribuí-lo aos perfis de usuário apropriados para que os agentes possam usá-lo.

  1. Navegue até Configurar → Perfis.

  2. Abra o perfil relevante (por exemplo, Perfil de Administrador do Sistema).

  3. Clique em Editar em Enabled Service Presence Status Access, ou pesquise por Presence Status e edite a opção exibida.

  4. Adicione o status recém-criado à perfil.

  5. Clique em Salvar.

    Consulte o documento de configuração Salesforce para obter etapas detalhadas sobre a configuração do perfil.

    • Se o status "Disponível" não for criado ou não for atribuído a um perfil de usuário, o usuário não poderá receber chamadas.

    • Para receber chamadas, o status do Service Cloud Voice (SCV) deve estar definido como "Disponível".

Crie uma central de contato

Para integrar a telefonia do NICE CXone com Salesforce, você deve criar um novo Contact Center usando o arquivo de configuração fornecido pela NiCE.

  1. Salve o link XML do NiCE CXone Call Center para o seu Desktop.

    1. Clique no link para baixar automaticamente o arquivo ZIP.

    2. Localize o arquivo ZIP baixado e clique com o botão direito nele.

    3. Selecione Extract All.

    4. Escolha uma localização para salvar os arquivos extraídos e clique em Extract.

    5. Abra a pasta extraída e use o arquivo XML para o upload de Salesforce.

      Adquira o arquivo de definição do contact center com o representante da sua conta. Este arquivo deve estar no formato XML.

  2. Em Salesforce, clique em Configurar no canto superior direito para iniciar o aplicativo Configurar.

  3. Pesquise Partner Telephony Contact Centers e selecione o resultado.

  4. Clique em New para criar um novo Contact Center.

  5. Selecione NICE CXone Telephony Provider.

  6. Importe o arquivo de configuração XML fornecido pela NiCE.

  7. Clique em Salvar.

    O Contact Center será criado.

Criar um certificado no Salesforce

O Salesforce Service Cloud Voice requer um certificado autoassinado e uma central de atendimento configurada para se conectar ao NICE CXone. O certificado estabelece uma confiança segura entre o Salesforce e o CXone, e a central de atendimento atua como o pacote de configuração de telefonia para sua organização.

A configuração do contact center é a configuração principal de telefonia no Salesforce Service Cloud Voice. Se alguma parte dessa configuração estiver ausente, os agentes podem não ver o painel do Softphone ou podem não conseguir atender chamadas do NICE CXone.

  1. Em Salesforce, clique em Setupicon of a lightning bolt inside a gear. no canto superior direito. Inicie o aplicativo Setup.
  2. No painel de navegação Configuração, procure Gestão de Certificados e Chaves e selecione o resultado Gestão de Certificados e Chaves da pesquisa.
  3. Clique em Criar certificado autoassinado.
  4. Nos campos Rótulo e Exclusivo, digite NICE_Cxone_Service_Cloud_Voice.
  5. Clique em Salvar.
  6. Click Download Certificate.
    • Abra o arquivo de certificado baixado em um editor de texto (por exemplo, Notepad++ ou qualquer editor de texto simples).

    • Copiar a chave pública inteira do arquivo.

    • Cole a chave pública no campo Chave Pública na configuração do seu contact center em Salesforce.

Atualizar o Contact Center com a Chave Pública

Após obter a chave pública, atualize a configuração da central de contatos e adicione usuários.

A configuração do contact center é a configuração de telefonia principal no Salesforce Service Cloud Voice. Se alguma parte dessa configuração estiver ausente, os agentes podem não ver o painel do Softphone ou podem não conseguir atender chamadas do NICE CXone.

  1. Clique em Setupícone de um raio dentro de uma engrenagem.
  2. No painel de navegação Configuração, procure por Central de contato de Parceiro de telefonia e selecione Central de contato de Parceiro de telefonia.
  3. Clique no nome do centro de contato que você criou.

  4. Clique em Editar.

  5. No campo Chave Pública, cole a chave pública que você copiou do certificado.

  6. Clique em Salvar.
  7. Na seção Users, adicione os usuários que precisam de acesso ao contact center.

  8. Para verificar a configuração, acesse as configurações de um usuário e confirme que o contact center está visível.

    A central de atendimento informa a Salesforce para usar o comportamento de telefonia do NICE CXone. O Salesforce não trata chamadas diretamente — ele depende dessa configuração para rotear chamadas através do CXone.

Aplicar Permissões

Depois de ativar o Voz, Salesforce cria automaticamente quatro conjuntos de permissões:

  • Admin do Contact Center (Telefonia do Parceiro): Usado para configurar e gerenciar a configuração da Telefonia do Parceiro, contact centers e integrações de telefonia.
  • Contact Center Agent (Telefonia do Parceiro): Permite que os Agentes gerenciem chamadas de voz e usem os recursos de telefonia dentro de Salesforce.
  • Supervisor do Contact Center (Telefonia do Parceiro): Permite que os supervisores monitorem a atividade dos agentes em tempo real.

  • Conjunto de permissões de Telefonia do parceiro: Concede o acesso de nível básico necessário para que todos os usuários de SCV utilizem os principais recursos de Telefonia do Parceiro, incluindo controles de chamada (atendimento, espera, silêncio, transferência).

Atribua ambos os conjuntos de permissão à sua conta e adicione agentes para continuar a configuração do Agent Workspace for Salesforce Voice.

  1. No painel de navegação Configuração, procure por Conjuntos de permissões e selecione o resultado da pesquisa Conjuntos de permissões.
  2. Selecione o conjunto de permissões administrador do Contact Center (Telefonia do Parceiro), em seguida, clique em Gerenciar Atribuições.
  3. Clique em Adicionar atribuição.
  4. Marque a caixa ao lado do seu nome e clique em Avançar.
  5. Clique Atribuir.
  6. Clique em Permission sets novamente no painel de navegação de Setup e repita o processo para o conjunto de permissões Contact Center Agent (Partner Telephony).
  7. Clique em Permission sets novamente no painel de navegação de Setup e selecione o conjunto de permissões Contact Center Agent (Parceiro Telephony).
  8. Clique em Manage Assignment > Add Assignment.
  9. Marque a caixa ao lado de cada usuário cada agente que você quer adicionar e clique em Avançar.
  10. Revise a lista de usuários e clique em Atribuir.
  11. Assign Presence Sync status to Role:
    1. No painel de navegação Configuração, procure por Perfis e selecione o resultado de pesquisa Perfis.
    2. Em Acesso ao status de presença do serviço habilitado, clique em Editar.
    3. Adicione da coluna Status de presença de Serviços disponíveis para a coluna Status de presença do serviço habilitado.
    4. Clique em Salvar.

Configurações de Site remoto

As Configurações de Site remoto atuam como uma lista de permissões que permite que Salesforce se comunique de forma segura com URLs externas confiáveis. Essas configurações são essenciais para recursos de telefonia, como iniciar chamadas, atualizar o status das chamadas, acessar gravações e autenticar solicitações de login.

  1. Recuperar a URL do seu domínio.

    1. No painel de navegação Configurar, pesquise por Domínio e selecione o resultado da pesquisa My Domain.

    2. Copie a URL do campo Current My Domain URL. Isso será usado para construir as URLs de Remote Site necessárias com base no seu tipo de organização.

  2. Construa URLs de Site Remoto: Substitua {domain} pelo valor do seu My Domain. Para localizá-lo, vá para Configuração do Salesforce → pesquise por My Domain → copie o valor de Current My Domain URL. Por exemplo, se a sua URL for https://acme.my.salesforce.com, o seu domínio é acme.

    • VF Domínio — Renderiza o painel de chamada e carrega o aplicativo SCV

      • Scratch: https://{domain}--nice-cxone.scratch.vf.force.com

      • Dev: https://{domain}--nice-cxone.develop.vf.force.com

      • https://{domain}--nice-cxone.vf.force.com

        Ex.:

        • https://nice27-dev-ed--nicecxone.develop.vf.force.com

        • https://scvdeveloper1-dev-ed--nice-cxone.develop.vf.force.com

    • Domínio Seguro (SCRT) — Registros de Chamada, sincronização de estado, status do agente, troca de token

      • Scratch: https://{domain}.scratch.my.salesforce-scrt.com

      • Prod: https://{domain}.my.salesforce-scrt.com

      • Dev: https://{domain}.develop.my.salesforce-scrt.com

        Ex.:

        • https://nice27-dev-ed.develop.my.salesforce-scrt.com

        • https://scvdeveloper1-dev-ed.develop.my.salesforce-scrt.com

    Ambos os tipos de domínio são necessários para a funcionalidade completa.

    • Se o VF estiver ausente → painel de chamada em branco, botões não funcionais, problemas de redirecionamento ao fazer login.

    • Se o SCRT estiver ausente → os registros de chamada de voz não serão atualizados, o status da chamada (Espera, Silêncio, ACW) não será sincronizado, o status do agente não será sincronizado, as transcrições/gravações não serão vinculadas.

  3. No painel de navegação Configurar, pesquise Configurações de Site Remoto e selecione-a.

  4. Clique em Novo Site Remoto.
  5. Digite um Nome DO site Remoto.
  6. No campo URL DO site Remoto, insira as URLs de domínio construídas, conforme listado acima.

  7. Repeat as etapas para criar todas as entradas de site remoto necessárias.

App Manager

Você precisa de dois aplicativos para Agent Workspace for Salesforce Voice (Agent for SCV):

  • Aplicativo conectado: fornece credenciais de mapeamento de conta para a integração.

  • Lightning App: Dá aos agentes acesso ao widget Omni-Channel e a Chamadas de voz.

Criar um aplicativo Lightning para Omni-Channel e Voz

  1. Adicionar No painel de navegação Configuração, procure Gerenciador de aplicativos e selecione o resultado de pesquisaGerenciador de aplicativos.

  2. Clique em New Lightning App.

  3. Insira um nome do aplicativo.

  4. Clique em Próx..

  5. Selecione Console Navigation como o estilo de navegação.

  6. Em Fatores de Forma, selecione Desktop.

  7. Clique em Próx..

  8. Clique em Add Utility Item e, em seguida, procure e selecione Omni-Channel.

  9. Clique em Próx..

  10. Na lista Available Items, procure por Chamadas de voz e adicione-a.

  11. Clique em Próx..

  12. Clique em Próx. novamente.

  13. Em Perfis disponíveis, pesquise e adicione todos os perfis aplicáveis (por exemplo, Administrador do Sistema).

  14. Clique em Salvar e Terminar.

    Se o Lightning App não estiver configurado com Omni-Channel e Chamadas de voz, os agentes não verão o widget Omni-Channel nem o softphone SCV, e não poderão atender Chamadas no Salesforce.

Habilitar Lightning Web Segurança

Você deve habilitar o Lightning Web Security para que os Lightning Web Components e os Aura Components usados pela integração SCV funcionem corretamente. Essa configuração também é necessária para que os agentes possam salvar as disposições.

  1. No painel de navegação Configuração, procure por Configurações da sessão e selecione Configurações da sessão.

  2. Na seção Lightning Web Security, selecione a caixa de seleção Use Lightning Web Security for Lightning web components and Aura components.

  3. Clique em Salvar.

    Salesforce pode levar alguns minutos para aplicar a alteração. Se o problema persistir, tente abrir o Salesforce em uma janela de navegador anônima ou saia e entre novamente.

    Se o Lightning Web Security não estiver habilitado, os componentes do Lightning usados por Service Cloud Voice podem não carregar ou funcionar corretamente. Por exemplo, o componente Disposition Handling pode falhar ao renderizar, impedindo que os agentes salvem disposições após as chamadas.

Ativar indicadores de lançamento

Você pode ativar indicadores de lançamento no Studio no Agent Workspace for Salesforce Voice. Se tiver dúvidas sobre o script de Studio, contate seu representante de conta.

  1. No painel de navegação Configurar, procure Lightning App Builder e selecione Lightning App Builder.

  2. Clique em New > Voice Extension > Next.

  3. Use o campo Rótulo para nomear seu novo aplicativo e clique em Avançar > Terminar.

  4. No painel esquerdo, abaixo do título Personalizado, você verá o aplicativo que acabou de criar. Clique nela e arraste-a para o painel do Lightning App Builder à direita.

  5. Clique em Salvar > ativar.

  6. No painel de navegação Configurar, procure por Centro de contato de Parceiro de telefonia e selecione Centros de contato de Parceiro de telefonia.
  7. Abra seu centro de contato existente e clique em Editar.
  8. Na lista suspensa Extensão de Voz, selecione o aplicativo ativado.
  9. Clique em Salvar.

Ativar o Click2Jack

Clickjacking ocorre quando atacantes adicionam elementos maliciosos, como botões, ao seu site. Quando os usuários clicam nesses elementos, eles são direcionados para o site do atacante.

Ativar o Click2Jack ajuda a proteger você contra ataques de clickjack. Isso também evita problemas decorrentes da descontinuação de cookies de terceiro Google.

  1. Em Salesforce, clique em Configuração Icon of gray gear with a lightning bolt in the center na parte superior direita.

  2. Use a caixa Encontrar Rápido para procurar por Configurações de Sessão e, em seguida, clique em Configurações de Sessão.

  3. Na seção Domínios confiáveis para Quadros inline, clique em Add Domain.

  4. No campo Domínio, digite https://mydomain.lightning.force.com. Substitua mydomain pelo nome de domínio do seu Salesforce. Clique em Salvar & Novo.

  5. No campo Domínio, insira https://mydomain.my.salesforce.com. Substitua mydomain pelo nome de seu domínio Salesforce. Clique em Salvar.

  6. Ativar o Click2Jack no seu aplicativo Salesforce Icon of dark gray square with an arrow pointing out of its upper right corner.

Habilitar o Click2Jack pode causar problemas para usuários não agentes do Salesforce. Eles podem não conseguir abrir componentes lighting ou páginas Visualforce se qualquer um dos itens a seguir estiver atribuído a eles:

  • Um call center NiCE CXone.

  • O item de barra de utilitário NiCE CXone Softphone.

  • Um aplicativo Lightning com NiCE CXone componentes.

  • Uma página Visualforce com componentes NiCE CXone.

Configurar pop-ups de tela com a Ação INDICATE Studio

Para habilitar os Tipos DE ação de Indicação de Formulário Personalizado "Mostrar" para o Legacy Salesforce Agent, você precisará configurá-los em Desktop Studio.

  1. Faça login em Desktop Studio e abra o script no qual deseja adicionar pop-ups de tela. Para mais informações sobre INDICATE em Studio, visite a NiCE CXone Página Studio do Help Center.
  2. Organize essas ações de modo que Begin esteja vinculado a Reqagent. Conecte Onanswer a Indicate usando o mesmo método.
  3. Double-click on the Indicate icon to open the configuration wizard. Complete the following to configure the Indicate settings:
    1. Na primeira tela do Prompt, selecione Um agente que está atendendo um contato em selecionar categoria de Destinatário. Clique em Avançar.
    2. Verifique se {ContactID} está dentro do campo de entrada (entre chaves). Clique em Next.
    3. Insira um identificador exclusivo no campo. Selecione On. Clique em Next.
    4. Procure uma imagem para exibir como ícone usando a lista suspensa Menu. Clique em Next.
    5. No campo de entrada, insira o que você gostaria que aparecesse como texto da dica de ferramenta quando o usuário passar o cursor sobre o ícone indicador. Clique em Next.
    6. Em Tipo DE ação, clique em Prompt o usuário com uma página da web semelhante a um formulário (avançado). Clique em Próx..
    7. No espaço em branco, enter as tags HTML desejadas. Você pode clicar em Visualizar para ver como ficará em tempo real. Depois de gostar de como ficou, clique em Avançar.
    8. Na tela final, revise as configurações selecionadas e clique em Terminar.

Habilitar as guias de disposição, indicador e cancelamento de ruído

Você pode configurar as abas Indicador e Cancelamento de ruído para aparecerem quando os agentes clicarem em Mais na parte inferior de Agent Workspace for Salesforce Voice:

  • Disposição: Esta guia permite que os agentes atribuam uma Disposição, Tags e Notas DE disposição a uma chamada.

    A localização da UI de Disposição muda de Voice Extension para App Colega.

  • Indicador: Esta guia exibe indicadoresClosed Itens de menu personalizados configurados por um administrador. configurados para os agentes.

  • Cancelamento de ruído: Esta guia permite que os agentes controlem os recursos de AI Noise Cancellation.

Para habilitar isso para seus agentes, siga estas etapas.