Configurar Fluxos de trabalho de Zendesk para Agent Workspace (Browser Extension) (Agent Integrated)

Você pode configurar fluxos de trabalho de Search, Custom Create e Standard Create para Zendesk e NiCE CXone Agent Workspace (Browser Extension) (Agent Integrated). Esses fluxos de trabalho procuram ou criam registros do Zendesk, também chamados de entidades ou objetos. Essa é a configuração de back-end do mapeamento de dados dinâmicos.

Tipo de fluxo de trabalho

Descrição

Fluxos de trabalho

Procurar Fluxos de trabalho de pesquisa escaneiam Zendesk para registros que sejam aplicáveis à 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. que o agente está tratando. Pesquisar ANI
Pesquisa personalizada
Criação personalizada Os fluxos de trabalho Criação Personalizada criam qualquer tipo de registro com campos personalizados e padrão. Criar Gravar Personalizado
Criação padrão Os fluxos de trabalho Criação padrão criam registros padrão do Zendesk com os campos de dados padrão. A carga útil SNIPPET desses fluxos de trabalho deve incluir os campos padrão e somente esses campos. Criar Chamado
Criar usuário

Fluxos de trabalho são executados usando as funções e permissões do usuário do sistema. Esta é a conta de usuário Zendesk que você criou especificamente para a configuração de NiCE CXone. Quando os registros são criados, eles usam o nome e o fuso horário do usuário do sistema.

Antes de começar, revise o diagrama de integração de CRM, o diagrama de fluxo de trabalho de CRM, e a lista de terminologia de integração de CRM.

Também baixe esta pasta de scripts modelo. Ela contém scripts de voz e digitais para NiCE CXone Studio e Desktop Studio.

Configurar Fluxos de trabalho de pesquisa

Há dois fluxos de trabalho de pesquisa: Procurar ANI e pesquisa personalizada.

Quando você usa mapeamentos de dados dinâmicos em um workflow de pesquisa, a seção Interactions Relacionados no cartão do cliente icon: a person next to a document. mostra primeiro os registros que:

  • Corresponder aos critérios de busca, e

  • Ter dados em cada campo mapeado.

Os agentes podem clicar em Atualizar no cartão do cliente icon: a person next to a document. para visualizar todos os registros que correspondem aos critérios de pesquisa.

Configurar o Fluxo de trabalho de pesquisas de ANI

O workflow Search for ANI usa o ANIClosed Também conhecido como id do chamador. número de telefone listado de uma chamada de voz recebida. de ACD para pesquisar todos os campos de telefone padrão em busca de registros correspondentes.

Não inclua a propriedade timeoutMilliSec em seu código de Workflow. Isso pode fazer com que múltiplas interações iguais sejam entregues aos seus agentes.

  1. Em Studio, abra o script em que você deseja configurar o workflow Search for ANI.

  2. Se ainda não o fez, adicione uma ação SNIPPET após BEGIN e antes da ação Execução do fluxo de trabalho.

  3. Dê duplo clique na ação SNIPPET no canvas do script.

  4. Copie cada uma das seguintes linhas de código e cole-as na guia Visualização em texto da janela editor.

    
    DYNAMIC searchInput
    searchInput.workflowInput.phoneNumber = "{ANI}"
    						
    ASSIGN searchJson = "{searchInput.asjson()}"
    		
  5. Salve o seu script.

  6. Você pode testar seu script simulando uma interação no Studio.

Configurar o Workflow de Procurar Personalizado

O fluxo de trabalho Custom Search permite que você pesquise Zendesk por registros que correspondam a critérios de filtragem flexíveis. Você pode usar o Custom Search para:

  • Pesquisar um único tipo de registro Zendesk, como Chamado.

  • Pesquise múltiplos tipos de registro Zendesk na mesma instância do CRM em uma única carga útil. Por exemplo, você pode pesquisar Chamado e Usuário ao mesmo tempo.

  • Use múltiplos campos e variáveis no filtro de pesquisa.

Você pode pesquisar qualquer combinação de até 5 registros de Zendesk em uma única carga útil. Não há limite imposto para o número de campos em uma Custom Search. No entanto, pesquisar muitos campos em uma única carga útil pode tornar a pesquisa lenta. Comece com um conjunto pequeno de campos e expanda conforme necessário.

Não inclua a propriedade timeoutMilliSec em seu código de Workflow. Isso pode fazer com que múltiplas interações iguais sejam entregues aos seus agentes.

  1. Em Studio, abra o script no qual você deseja configurar o workflow Custom Search.

  2. Se ainda não o fez, adicione uma ação SNIPPET após BEGIN e antes da ação Execução do fluxo de trabalho.

  3. Duplo clique na ação SNIPPET na tela do script.

  4. Copie um dos blocos de código de amostra abaixo e cole-o na guia Text View da janela editor. Em seguida, atualize os valores conforme necessário.

  5. Salve o seu script.

  6. Você pode testar o seu script simulando uma interação em Studio.

Configurar Fluxos de trabalho de criação personalizados

Os fluxos de trabalho Custom Create permitem configurar uma carga útil de SNIPPET para criar qualquer tipo de registro de Zendesk, padrão ou personalizado. Também permite que você preencha qualquer tipo DE campo, padrão ou personalizado. Por exemplo, você poderia criar um registro de Chamado com alguns dos campos padrão desse tipo de registro, bem como seus próprios campos personalizados.

Esse é o método recomendado para criar registros do Zendesk.

Configurar o Fluxo de trabalho Criar registro personalizado (o antigo fluxo de trabalho Criar entidade)

O workflow Create Custom Record cria qualquer tipo de registro Zendesk, padrão ou personalizado. Esse registro pode exibir campos de dados padrão e personalizados. Os campos devem conter texto, números ou variáveis. Os campos vinculados geralmente são preenchidos por resultados da pesquisa ou listas de opções, mas você pode configurar este workflow para adicionar dados codificados de forma fixa a um campo vinculado.

Se você usar a versão mais antiga deste workflow, chamada de workflow Criar entidade, você precisa configurar seu script Studio com duas ações adicionais: um SNIPPET chamado Snippet for Send Workflow Response, e um CUSTOMEVENT chamado Send Workflow Response. Use este script de modelo para Desktop Studio ou este script de modelo para Studio.

  1. Em Studio, abra o script no qual deseja configurar o workflow Create Custom Record.

  2. Se você ainda não fez isso, adicione uma ação SNIPPET após ONANSWER ou ONASSIGNMENT.

  3. Duplo clique na ação SNIPPET na tela do script.

  4. Copie cada uma das seguintes linhas de código e cole-as na guia Visualização em texto da janela editor.

    
    DYNAMIC create[Record]
    create[Record].table = "[ticket or user]"
    create[Record].data.[ticket or user].[fieldName] = "[field value]"
    create[Record].data.[ticket or user].[fieldName] = "[field value]"
    
    createPayload.pinnedRecord = "[true or false]"
    createPayload.screenPop = "[true or false]"
    						
    DYNAMIC create[Record]Payload
    create[Record]Payload.workflowInput = create[Record]
    						
    ASSIGN createCustomJson = "{create[Record]Payload.asjson()}"
    		

    É necessário incluir cada uma dessas linhas.

  5. Substitua o espaço reservado [Record] em cada instância de create[Record] por Ticket ou User, dependendo do tipo de registro que você está criando. Por exemplo, createTicket.
  6. Altere o valor do atributo create[Record].table para ticket ou user, dependendo do tipo de registro que você está criando. Por exemplo, se você estiver criando um tíquete, essa linha deverá ser createTicket.table = "ticket".
  7. Nos próximos dois atributos, altere [ticket or user] para ticket ou user, dependendo do tipo de registro que você está criando. Por exemplo, se você estiver criando um tíquete, essas linhas devem começar com o createTicket.data.ticket.
  8. Nesses mesmos atributos, altere [fieldName] para o nome do campo que deseja incluir no registro. Por exemplo, createTicket.data.ticket.description. Altere [field value] para o valor que você deseja exibir no campo. Por exemplo, createTicket.data.ticket.description = "This ticket is new."
  9. Para adicionar outros campos, crie atributos adicionais que sigam o mesmo formato:

    
    create[Record].data.[ticket or user].[fieldName] = "[field value]"
    		

    Por exemplo:

    
    createTicket.data.ticket.group_id = "12345678910112"
    				
  10. Altere o valor do atributo createPayload.pinnedRecord para true ou false. Quando definido como true, o registro criado é exibido aos agentes na seção Interactions Atual do cartão do cliente. Quando definido como false, ele é exibido na seção Interações recentes do cartão do cliente. Se você não incluir esse atributo na carga útil, será assumido como false.
  11. Altere o valor do atributo createPayload.screenPop para true ou false. Quando definido como true, o registro criado aparece automaticamente para o agente como um pop-up de tela no Zendesk. Se estiver definido como false, isso não ocorrerá. Se você não incluir este atributo na carga útil, ele será considerado como false.

  12. Salve o seu script.

  13. Você pode testar seu script simulando uma interação no Studio.

Configurar Fluxos de trabalho de criação Padrão

Fluxos de trabalho de criação padrão criam registros Zendesk padrão com os campos especificados na carga útil do fluxo de trabalho.

Você não pode adicionar ou excluir campos na carga útil SNIPPET dos fluxos de trabalho Criação Padrão. Se você adicionar ou excluir campos, o registro não será criado. Para criar um registro padrão ou personalizado com os campos desejados, use o workflow Create Custom Record.

Configurar o Workflow de Criação de Chamado

  1. Em Studio, abra o script no qual você deseja configurar o workflow Create Chamado.

  2. Se ainda não o fez, adicione uma ação SNIPPET após BEGIN e antes da ação Execução do fluxo de trabalho.

  3. Duplo clique na ação SNIPPET no canvas do script.

  4. Copie cada uma das seguintes linhas de código e cole-as na guia Visualização em texto da janela editor.

    
    DYNAMIC createTicket
    createTicket.subject = "[Ticket Name] - {ANI}"
    createTicket.description = "{ANI}"
    createTicket.requester_id = "{variable}"
    						
    createTicket.pinnedRecord = "[true or false]"
    createTicket.screenPop = "[true or false]"
    
    DYNAMIC createTicketPayload
    createTicketPayload.workflowInput = createTicket
    						
    ASSIGN createTicketJson = "{createTicketPayload.asjson()}"
    		

    É necessário incluir cada uma dessas linhas. Se desejar que um campo permaneça em branco, você pode usar um valor nulo (""). Por exemplo, createTicket.description = "".

  5. Altere o valor do atributo createTicket.subject para o nome do chamado. Por exemplo, createTicket.subject= "Auto Created Ticket for {ANI}". Este valor pode ser codificado, uma variável ou uma combinação destes. Utilize uma variável se quiser que este valor seja atualizado a cada interação.

  6. Altere o valor do atributo createTicket.description para uma descrição do chamado. Por exemplo, createTicket.data.ticket.description = "Ticket created for {ANI}". Este valor pode ser codificado, uma variável ou uma combinação destes. Utilize uma variável se quiser que este valor seja atualizado a cada interação.

  7. Altere o valor do atributo createTicket.requester_id para o nome da variável que você deseja usar. Por exemplo, createTicket.requester_id = "{userRecord.id}".
  8. Altere o valor do atributo createTicket.pinnedRecord para true ou false. Quando definido como true, o registro criado é exibido aos agentes na seção Interactions atual do cartão do cliente. Quando definido como false, ele é exibido na seção Interações recentes do cartão do cliente. Se você não incluir esse atributo na carga útil, ele será considerado como false.
  9. Altere o valor do atributo createTicket.screenPop para true ou false. Quando definido como true, o registro criado aparece automaticamente para o agente como um pop-up de tela no Zendesk. Se estiver definido como false, isso não ocorrerá. Se você não incluir esse atributo na carga útil, ele será considerado como false.

  10. Clique na ação Execução do fluxo de trabalho que vem após o SNIPPET deste Fluxo de trabalho. Altere a propriedade workflowPayload dessa ação para {createTicketJson}. Certifique-se de incluir as chaves.

  11. Salve o seu script.

  12. Você pode testar seu script simulando uma interação no Studio.

Configurar o Workflow de criação de usuário

  1. Em Studio, abra o script em que deseja configurar o workflow Create User.

  2. Se ainda não o fez, adicione uma ação SNIPPET após BEGIN e antes da ação Execução do fluxo de trabalho.

  3. Dê duplo clique na ação SNIPPET no canvas do script.

  4. Copie cada uma das seguintes linhas de código e cole-as na guia Visualização em texto da janela editor.

    
    DYNAMIC createUser
    createUser.phoneNumber = "{ANI}"
    createUser.name = "Auto Created User for {ANI}"
    						
    createUser.pinnedRecord = "[true or false]"
    createUser.screenPop = "[true or false]"
    
    DYNAMIC createUserPayload
    createUserPayload.workflowInput = createUser
    						
    ASSIGN createUserJson = "{createUserPayload.asjson()}"
    		

    É necessário incluir cada uma dessas linhas. Se quiser que um campo permaneça em branco, você pode usar um valor nulo (""). Por exemplo, createUser.name = "".

  5. Altere os valores dos atributos createUser.phoneNumber e createUser.name para atender às suas necessidades. Por exemplo, createUser.name = "Caller {ANI} to Billing".

  6. Altere o valor do atributo createUser.pinnedRecord para true ou false. Quando definido como true, o registro criado é exibido para os agentes na seção Interactions atual do cartão do cliente. Quando definido como false, ele é exibido na seção Interações recentes do cartão do cliente. Se você não incluir esse atributo na carga útil, será assumido como false.
  7. Altere o valor do atributo createUser.screenPop para true ou false. Quando definido como true, o registro criado aparece automaticamente para o agente como um pop-up de tela no Zendesk. Se estiver definido como false, isso não ocorrerá. Se você não incluir esse atributo na carga útil, ele será considerado como false.

  8. Clique na ação Workflow Execute que vem depois do SNIPPET deste Fluxo de trabalho. Altere a propriedade workflowPayload dessa ação para {createUserJson}. Certifique-se de incluir as chaves.

  9. Salve seu script.

  10. Você pode testar seu script simulando uma interação em Studio simulando uma interação em Studio.

Fixar registros

Você pode fixar um registro na seção Interação Atual do cartão do cliente. Quando um registro é fixado, ele é vinculado icon of a check mark in a green box. para memorialização de dados e informações de linha do tempo por padrão. Isso significa que as informações de memorialização de dados e de linha do tempo serão adicionadas ao registro Zendesk quando a interação for concluída. Se o agente não quiser que as informações sejam mapeadas, ele poderá desvincular o registro.

  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[RecordType]Payload:

    						
    createPayload.pinnedRecord = "true"					
    		
  3. Make sure that createPayload matches the earlier lines in your workflow.

  4. Salve o seu script.

Configurar registros para Screen Pop

Você pode configurar registros para que apareçam automaticamente como pop-ups de tela em Zendesk. Isso é feito editando a carga útil do Workflow.

Pesquisar em Fluxos de trabalho

By padrão, os registros de correspondência únicaClosed Ocorre quando um workflow de pesquisa retorna somente um registro. aparecem como Tela pops. Você pode alterar isso definindo o atributo screenPop como false.

Múltiplos registros de correspondência não aparecem como Tela pops, mesmo se você definir o atributo screenPop como true.

  1. Abra a ação SNIPPET do workflow no seu script Studio.

  2. Na carga útil do fluxo de trabalho, copie esta linha de código e cole-a antes de ASSIGN searchJson = "{searchInput.asjson()}":

    						
    searchPayload.screenPop = "[true or false]"				
    		
  3. Configure o code colado.

    1. Verifique se searchPayload corresponde às linhas anteriores no seu workflow. Por exemplo, no workflow Custom Search, esta linha deve ser payload.screenPop. No workflow Search for ANI, ela deve ser searchInput.workflowInput.screenPop.

    2. Alterar o valor do atributo screenPop:

      • Defina-o como true para mostrar o registro como uma tela pop.

      • Defina-o como false para não mostrá-lo.

  4. Salve o seu script.

Em Criar Fluxos de trabalho

Por padrão, os registros criados não aparecem como Tela pops. Você pode alterar isso definindo o atributo screenPop como true.

  1. Abra a ação SNIPPET do workflow no script Studio.

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

    						
    createPayload.screenPop = "[true or false]"				
    		
  3. Configure o code colado.

    1. Certifique-se de que createPayload corresponda às linhas anteriores do seu workflow. Por exemplo, no workflow padrão Criar Chamado, esta linha deve ser createTicket.screenPop.

    2. Alterar o valor do atributo screenPop:

      • Defina-o como true para mostrar o registro como uma tela pop.

      • Defina-o como false para não mostrá-lo.

  4. Salve o seu script.

Configurar o cache de Workflow

Você pode controlar se os resultados do workflow de pesquisa e Criação são armazenados em cache. Isso é feito editando a carga útil do workflow. Quando os resultados são armazenados em cache, eles aparecem no cartão do cliente no aplicativo do agente.

Pesquisar Fluxos de trabalho

Por padrão, os resultados de workflow de pesquisa ficam em cache. Você pode alterar isso definindo o atributo cacheResponse como false. Os registros retornados não aparecerão no aplicativo do agente.

  1. Abra a ação SNIPPET do workflow em seu script Studio.

  2. Na carga útil do fluxo de trabalho, copie esta linha de código e cole-a antes de ASSIGN searchJson = "{searchInput.asjson()}":

    						
    searchPayload.cacheResponse = "[true or false]"				
    		
  3. Configure o code colado.

    1. Certifique-se de que searchPayload corresponda às linhas anteriores do seu workflow. Por exemplo, no Custom Search workflow, esta linha deve ser payload.cacheResponse.

    2. Alterar o valor do atributo cacheResponse:

      • Defina-o como true para armazenar em cache os resultados do workflow.

      • Defina como false para não armazená-los em cache.

  4. Salve seu script.

Em Criar Fluxos de trabalho

Por padrão, os resultados de Create Workflow são armazenados em cache. Você pode alterar isso definindo o atributo cacheResponse como false. Os registros criados não aparecerão no aplicativo do agente.

  1. Abra a ação SNIPPET do workflow em seu script.

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

    						
    createPayload.cacheResponse = "[true or false]"				
    		
  3. Configure o code colado.

    1. Verifique se createPayload corresponde às linhas anteriores no seu workflow. Por exemplo, no workflow padrão Criar Chamado, esta linha deve ser createTicket.cacheResponse.

    2. Alterar o valor do atributo cacheResponse:

      • Defina como true para armazenar em cache os resultados do workflow.

      • Defina como false para não armazená-los em cache.

  4. Salve o seu script.