Configurar pops de tela em Agent Workspace for Salesforce

Esta é a quarta etapa da configuração do Agent Workspace (Embedded) (Agent Embedded) no Salesforce. Esta etapa é opcional. Você pode pular para a próxima etapa: configurar fluxos de trabalho.

Quando um agente recebe uma interaçãoClosed A conversa completa com um agente por meio de um canal. Por exemplo, uma interação pode ser uma chamada de voz, um e-mail, um chat ou uma conversa em mídia social., NiCE CXone Agent Workspace (Embedded) (Agent Embedded) para Salesforce (Agent Workspace for Salesforce) pode exibir um screen popClosed Uma janela pop-up com informações sobre o contato que aparece na tela de um agente após um evento, como a conexão com um contato. ao agente. É possível configurar os seguintes tipos de pop-ups de tela:

  • Registros do Salesforce afixados
  • Salesforce Fluxos Icon of dark gray square with an arrow pointing out of its upper right corner
  • URLs
  • Visualforce Icon of dark gray square with an arrow pointing out of its upper right corner Páginas
  • Páginas de pesquisa do Salesforce
  • Páginas iniciais do objeto
  • Lista de exibições
  • Novos formulários de registro

Configurar o pop-up de tela de Salesforce Record

Você pode configurar registros criados para aparecer automaticamente como screen popsClosed Uma janela pop-up com informações sobre o contato que aparece na tela de um agente após um evento, como a conexão com um contato. em Salesforce. Isso faz parte da configuração dos fluxos de trabalho de Salesforce.

  1. Abra a ação Snippet for Create Workflow SNIPPET em seu script.

  2. Na carga útil do fluxo de trabalho, copie esta linha de código e cole-a antes de DYNAMIC create[RecordName]Payload:

    						
    createPayload.screenPop = "true"				
    		

    Certifique-se de que createPayload corresponda às linhas anteriores no seu fluxo de trabalho. Por exemplo, se você estiver usando o workflow padrão de Create Case, essa linha deve ser createCase.screenPop = "true".

  3. Salve o seu script.

Configurar tela pop-up de Fluxo

Você pode usar esta opção para exibir Salesforce fluxos Caixa com seta indicando navegação para site externo. como screen popsClosed Uma janela pop-up com informações sobre o contato que aparece na tela de um agente após um evento, como a conexão com um contato.. Os screen pops de Fluxo abrem em uma nova guia em Salesforce se:

Em todas as outras Salesforce interfaces e em Lightning Apps com navegação padrão, os pop-ups de tela de fluxo aparecem em uma janela pop-up.

Este tipo de screen pop utiliza uma CustomEvent ação. Se o seu script exigir mais que um evento personalizado, utilize uma nova instância de CustomEvent para cada um.

Se você já tiver um script de pop-up de tela de fluxo para Salesforce Agent (SFA), você pode usar seu SNIPPET além do script abaixo.

  1. Em Studio, abra o script que você modificou para a integração de Salesforce.

  2. Adicione uma SNIPPET ação ao script após a ação ONANSWER ou ONASSIGNMENT.

  3. Altere a propriedade legenda da ação SNIPPET para indicar sua finalidade, como Tela pop-up para Fluxo.

  4. Abra o editor da ação snippet e adicione o seguinte código:

    
    DYNAMIC payloadJSON
    
    payloadJSON.contactId="{contactid}"
    payloadJSON.data.popType = "poptoflow"
    payloadJSON.data.params.flowDevName = "[Flow_Name]"
    payloadJSON.data.params.flowArgs = "firstName=[First_Name]&ani={ANI}&lastName=[Last_Name]"
    
    ASSIGN reqPayload="{payloadJSON.AsJson()}"
    				

    Neste Snippet:

    • popType: Isso deve ser definido como poptoflow para que a tela pop contenha um fluxo.
    • Substituir [Flow_Name] pelo nome de API do Fluxo que você deseja abrir em pop-up. flowDevName

    • flowArgs: Insira um ou mais argumentos para passar como uma cadeia de consulta no URL. Esta é uma propriedade opcional. Se você incluiu um SNIPPET de um script de pop-up de tela de fluxo para Salesforce Agent (SFA), você pode deixar esta propriedade em branco: payloadJSON.data.params.flowArgs = "".
  5. Adicione uma CustomEvent ação após a ação Screen Pop to Flow SNIPPET.
  6. Altere a propriedade Caption da ação CustomEvent para indicar sua finalidade, como Send Screen Pop to Flow.

  7. Configure a propriedade EventName da ação CustomEvent com ScreenPopCustomSettings. Não use um nome de evento diferente.

  8. Salve seu script.

Configurar um Pop de tela de URL

Você pode usar esta opção para exibir qualquer URL como um screen popClosed Uma janela pop-up com informações sobre o contato que aparece na tela de um agente após um evento, como a conexão com um contato.. Para configurar esse tipo de screen pop, use a ação POPURL em seu script. Se você quiser exibir mais que uma página, será necessária uma ação POPURL para cada uma.

URLs de terceiros sempre são exibidas em uma nova guia do navegador. Salesforce URLs podem ser exibidas na guia Salesforce Lightning atual ou em uma nova guia, dependendo de como o agente configurou a configuração Panel Open in Browser.

As imagens a seguir mostram exemplos de scripts de voz e scripts digitais.

Script de voz do Desktop Studio:

Desktop Studio script digital:

Script de voz do Studio:

Studio script digital:

  1. Em Studio, abra o script que você modificou para a integração de Salesforce.

  2. Adicione uma POPURL ação ao script após a ação ONANSWER ou ONASSIGNMENT.

  3. Configure a propriedade URL da ação POPURL com a URL da página que você deseja exibir em tela pop-up para os agentes.

  4. Salve o seu script.

Configurar uma tela de pop-up Visualforce

Você pode usar esta opção para exibir as páginas Visualforce como Tela popsClosed Uma janela pop-up com informações sobre o contato que aparece na tela de um agente após um evento, como a conexão com um contato..

Este tipo de screen pop usa uma CustomEvent ação. Se o seu script exigir mais de um evento personalizado, use uma nova instância de CustomEvent para cada um.

  1. Em Studio, abra o script que você modificou para a integração com Salesforce.

  2. Adicione uma SNIPPET ação ao script após a ação ONANSWER ou ONASSIGNMENT.

  3. Altere a propriedade Caption da ação SNIPPET para indicar sua finalidade, como Screen Pop para Visualforce.

  4. Abra o editor da snippet ação e adicione o seguinte código:

    
    DYNAMIC payloadJSON
    
    payloadJSON.contactId="{contactid}"
    payloadJSON.data.popType = "popvisualforcepage"
    payloadJSON.data.params.url = "[VisualforceAPIname]?&_c={contactid}&ani={ANI}"
    
    ASSIGN reqPayload="{payloadJSON.AsJson()}"
    				​

    Neste Snippet:

    • popType: Isso deve ser definido como popvisualforcepage para que a tela pop contenha a página Visualforce.
    • Insira o nome da API da página url no Placeholder [VisualforceAPIname], Visualforce. Por exemplo, vjSamplePage?&c={contactid}&ani={ANI}. Os parâmetros de consulta que começam com ?&c= são opcionais.

  5. Adicione uma CustomEvent ação após a ação Screen Pop to Visualforce SNIPPET.
  6. Altere a propriedade Caption da ação CustomEvent para indicar sua finalidade, como Send Screen Pop to Visualforce.

  7. Configure a propriedade EventName da ação CustomEvent com ScreenPopCustomSettings. Não use um nome de evento diferente.

  8. Salve o seu script.

Configurar um pop-up de tela de pesquisa

Você pode fazer com que uma página de pesquisa Salesforce apareça como um screen popClosed Uma janela pop-up com informações sobre o contato que aparece na tela de um agente após um evento, como a conexão com um contato. quando o agente recebe uma interaçãoClosed A conversa completa com um agente por meio de um canal. Por exemplo, uma interação pode ser uma chamada de voz, um e-mail, um chat ou uma conversa em mídia social.. Essa página de pesquisa exibe os resultados de uma string de pesquisa que você configurar.

Este tipo de screen pop usa uma CustomEvent ação. Se o seu script exigir mais que um evento personalizado, use uma nova instância de CustomEvent para cada um.

  1. Em Studio, abra o script que você modificou para a integração com Salesforce.

  2. Adicione uma SNIPPET ação ao script após a ação ONANSWER ou ONASSIGNMENT.

  3. Altere a propriedade Caption da ação SNIPPET para indicar sua finalidade, como Screen Pop to Search.

  4. Abra o editor da ação snippet e adicione o seguinte código:

    
    
    DYNAMIC payloadJSON
    
    payloadJSON.contactId="{contactid}"
    payloadJSON.data.popType = "searchstring"
    payloadJSON.data.params.searchString = "[text entered in Salesforce search bar]"
    
    ASSIGN reqPayload="{payloadJSON.AsJson()}"
    				​

    Neste Snippet:

    • popType: Isso deve ser definido como searchstring para que a tela pop contenha a página de pesquisa.
    • searchString: Enter o texto que você deseja que seja inserido na barra de pesquisa na parte superior de Salesforce. O tamanho mínimo é três caracteres.
      Por exemplo, se esta linha for payloadJSON.data.params.searchString = "billing", o texto billing é inserido na barra de pesquisa Salesforce. todos os registros que contêm o texto billing aparecem nos resultados.
  5. Adicione uma CustomEvent ação após a ação Screen Pop to Search SNIPPET.
  6. Altere a propriedade Caption da ação CustomEvent para indicar sua finalidade, como Send Screen Pop to Search.

  7. Configure a propriedade TargetAgent da ação CustomEvent com {agentid}.

  8. Configure a propriedade EventName da ação CustomEvent com ScreenPopCustomSettings. Não use um nome de evento diferente.

  9. Configure a propriedade PersistInMemory da ação CustomEvent com False.

  10. Configure a propriedade Data da ação CustomEvent com {reqPayload}.

  11. Salve o seu script.

Configurar uma Tela de Boas-vindas de Objeto

Você pode fazer com que a página inicial de um registro, ou objeto, Salesforce apareça como um screen popClosed Uma janela pop-up com informações sobre o contato que aparece na tela de um agente após um evento, como a conexão com um contato. quando o agente receber uma interaçãoClosed A conversa completa com um agente por meio de um canal. Por exemplo, uma interação pode ser uma chamada de voz, um e-mail, um chat ou uma conversa em mídia social.. A página inicial do objeto lista todos os registros desse tipo de registro. Por exemplo, se você fizer um screen pop para a página inicial do objeto de conta, essa página inicial listará todos os registros de conta em sua instância do Salesforce.

Este tipo de pop de tela usa uma CustomEvent ação. Se o seu script exigir mais de um evento personalizado, use uma nova instância de CustomEvent para cada um.

  1. Em Studio, abra o script que você modificou para a integração de Salesforce.

  2. Adicione uma SNIPPET ação ao script após a ação ONANSWER ou ONASSIGNMENT.

  3. Altere a propriedade Caption da ação SNIPPET para indicar sua finalidade, como Screen Pop to Object Home.

  4. Abra o editor da ação snippet e adicione o seguinte código:

    
    DYNAMIC payloadJSON
    
    payloadJSON.contactId="{contactid}"
    payloadJSON.data.popType = "objecthome"
    payloadJSON.data.params.scope = "[record API name]"
    
    ASSIGN reqPayload="{payloadJSON.AsJson()}"
    				​

    Neste Snippet:

    • popType: Isso deve ser definido como objecthome para que a tela pop contenha a página inicial do registro.
    • scope: Insira o nome da API do registro, como account, case ou lead.

      Para localizar o nome da API do registro, abra Salesforce e navegue até Setup Icon of gray gear with a lightning bolt in the center > Object Manager. Clique no nome do registro. Na página Detalhes que é aberta, localize o API Name.

  5. Adicione uma ação CustomEvent action após a ação Screen Pop to Object Home SNIPPET.
  6. Altere a propriedade Caption da ação CustomEvent para indicar sua finalidade, como Send Screen Pop to Object Home.

  7. Configure a propriedade EventName da ação CustomEvent com ScreenPopCustomSettings. Não use um nome de evento diferente.

  8. Salve o seu script.

Configurar um pop-up de Tela de Lista

Você pode fazer com que a exibição de lista de um registro de Salesforce apareça como um screen popClosed Uma janela pop-up com informações sobre o contato que aparece na tela de um agente após um evento, como a conexão com um contato. quando o agente recebe uma interaçãoClosed A conversa completa com um agente por meio de um canal. Por exemplo, uma interação pode ser uma chamada de voz, um e-mail, um chat ou uma conversa em mídia social.. As exibições de lista incluem Novo Esta semana, Visualizado Recentemente e quaisquer exibições de lista personalizadas que você tenha configurado.

Este tipo de pop-up de tela usa uma ação CustomEvent. Se o seu script exigir mais de um evento personalizado, use uma nova instância de CustomEvent para cada um.

  1. Em Studio, abra o script que você modificou para a integração de Salesforce.

  2. Adicione uma SNIPPET ação ao script após a ação ONANSWER ou ONASSIGNMENT.

  3. Altere a propriedade Caption da ação SNIPPET para indicar sua finalidade, como Screen Pop to List.

  4. Abra o editor da ação snippet e adicione o seguinte código:

    
    DYNAMIC payloadJSON
    
    payloadJSON.contactId="{contactid}"
    payloadJSON.data.popType = "list"
    payloadJSON.data.params.listViewId = "[list API name]"
    payloadJSON.data.params.scope = "[record API name]"
    
    ASSIGN reqPayload="{payloadJSON.AsJson()}"
    				​

    Neste Snippet:

    • popType: Isso deve ser definido como list para que a tela pop contenha a exibição de lista do registro.
    • listViewId: Enter o nome da API da lista, incluindo o namespace no prefixo. Por exemplo, Test__MyOpenCases.

    • scope: Insira o nome da API do registro, como account, case ou lead.

      Para localizar o nome da API do registro, abra Salesforce e navegue até Setup Icon of gray gear with a lightning bolt in the center > Object Manager. Clique no nome do registro. Na página Detalhes que é aberta, localize API Name.

  5. Adicione uma CustomEvent ação após a ação Screen Pop to List SNIPPET.
  6. Altere a propriedade Caption da ação CustomEvent para indicar sua finalidade, como Send Screen Pop to List.

  7. Configure a propriedade EventName da ação CustomEvent com ScreenPopCustomSettings. Não use um nome de evento diferente.

  8. Salve o seu script.

Configurar uma tela de pop-up de formulário de novo registro

Se nenhum registro correspondente for encontrado em uma pesquisa, você pode fazer com que o formulário para criar um novo registro de Salesforce apareça como um screen popClosed Uma janela pop-up com informações sobre o contato que aparece na tela de um agente após um evento, como a conexão com um contato..

Este tipo de tela pop usa uma ação CustomEvent. Se o seu script exigir mais que um evento personalizado, use uma nova instância de CustomEvent para cada um.

  1. Em Studio, abra o script que você modificou para a integração de Salesforce.

  2. Adicione uma SNIPPET ação ao script após a ação ONANSWER ou ONASSIGNMENT.

  3. Altere a propriedade Caption da ação SNIPPET para indicar sua finalidade, como Screen Pop to New Record Form.

  4. Abra o editor da ação snippet e adicione o seguinte código:

    
    DYNAMIC payloadJSON
    DYNAMIC fieldValues
    
    payloadJSON.contactId="{contactid}"
    payloadJSON.data.popType = "newrecordmodal"
    payloadJSON.data.params.entityName = "[record API name]"
    fieldValues.Phone = "{ANI}"
    payloadJSON.data.params.defaultFieldValues = "{fieldValues.AsJson()}"
    
    ASSIGN reqPayload="{payloadJSON.AsJson()}"
    				​

    Neste Snippet:

    • Resposta: popType: Isso deve ser definido como newrecordmodal para que a tela pop contenha o formulário para criar um novo registro.
    • entityName: Insira o nome da API do registro, como account, case ou lead.

      Para encontrar o nome da API do registro, abra Salesforce e navegue até Setup Icon of gray gear with a lightning bolt in the center > Object Manager. Clique no nome do registro. Na página Detalhes que é aberta, encontre API Name.

    • defaultFieldValues: Inclua esta propriedade para preencher previamente os campos no formulário de novo registro. Por exemplo, o código acima preenche o campo Telefone com a variável {ANI}. Esta é uma propriedade opcional.

  5. Adicione uma CustomEvent ação após a ação Screen Pop to New Record Form SNIPPET.
  6. Altere a propriedade Caption da ação CustomEvent para indicar sua finalidade, como Send Screen Pop to New Record Form.

  7. Configure a propriedade EventName da ação CustomEvent com ScreenPopCustomSettings. Não use um nome de evento diferente.

  8. Salve o seu script.

A próxima etapa da configuração de Agent Workspace (Embedded) (Agent Embedded) em Salesforce é configurar os fluxos de trabalho.