Configurar Fluxos de trabalho de ServiceNow para Agent Workspace for Microsoft Teams (Agent for Microsoft Teams)

Você pode configurar fluxos de trabalho de pesquisa, Criação personalizada e Criação Padrão para ServiceNow e NiCE CXone Agent Workspace for Microsoft Teams (Agent for Microsoft Teams). Esses fluxos de trabalho procuram ou criam registros do ServiceNow, 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 analisam ServiceNow em busca de registros 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 de Criação Personalizada criam qualquer tipo de registro com campos personalizados e padrão. Criar registro personalizado
Criação padrão Os fluxos de trabalho Criação padrão criam registros padrão do ServiceNow 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 Caso
Criar Consumer
Criar Contato
Criar incidente
Criar Interação
Criar usuário
Atualizar Os fluxos de trabalho de atualização atualizam os valores de campo de um registro. Eles podem ser usados para atualizar um registro personalizado recuperado por um fluxo de trabalho de pesquisa ou um registro criado por um fluxo de trabalho de Criação personalizada. Atualizar registro personalizado

Fluxos de trabalho são executados usando as funções e permissões do usuário do sistema. Esta é a conta de usuário ServiceNow 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 de 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. do 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 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ê um 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 workflow Custom Search permite que você pesquise ServiceNow em busca de registros que correspondam a critérios de filtragem flexíveis. Você pode usar o Custom Search para:

  • Pesquisar um único tipo de registro ServiceNow, como Case.

  • Pesquise múltiplos tipos de registro ServiceNow na mesma instância de CRM em uma única carga útil. Por exemplo, você pode pesquisar Consumidor e Contact ao mesmo tempo.

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

  • Conecte condições de pesquisa com operadores ServiceNow, como AND e OR.

Você pode pesquisar qualquer combinação de até 5 registros de ServiceNow 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 depois de BEGIN e antes da ação Execução do fluxo de trabalho.

  3. Dê um duplo clique na ação SNIPPET no canvas 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 script simulando uma interação no Studio.

Configurar Fluxos de trabalho de criação personalizados

Os fluxos de trabalho de Criação personalizada permitem configurar uma carga útil do SNIPPET para criar qualquer tipo de registro ServiceNow, padrão ou personalizado. Também permite que você preencha qualquer tipo DE campo, padrão ou personalizado. Por exemplo, você pode criar um registro de Caso 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 ServiceNow.

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 ServiceNow, 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 você deseja configurar o workflow Create Custom Record.

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

  3. Dê um 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 createPayload
    DYNAMIC createDataArray
    						
    DYNAMIC item1
    item1.name = "subject"
    item1.value = "New Record - {CONTACTID}"
    DYNAMIC item2
    item2.name = "phonenumber"
    item2.value = "{ANI}"
    DYNAMIC item3
    item3.name = "new_contactid"
    item3.value = "{CONTACTID}"
    						
    createPayload.tablename = "incident"
    		ASSIGN createDataArray[1] = item1
    		ASSIGN createDataArray[2] = item2
    		ASSIGN createDataArray[3] = item3
    CreatePayload.data = createDataArray
    						
    createPayload.pinnedRecord = "[true or false]"
    createPayload.screenPop = "[true or false]"
    createPayload.relatesTo = "[true or false]"
    						
    DYNAMIC create[RecordName]Payload
    create[RecordName]Payload.workflowInput = createPayload
    						
    ASSIGN create[RecordName]Json = "{create[RecordName]Payload.asjson()}"
    		

    É necessário incluir cada uma dessas linhas.

  5. Para adicionar campos adicionais:

    1. Crie outros objetos de dados dinâmicos em item3.value = "{CONTACTID}". Siga este formato:

      
      DYNAMIC item#
      item#.name = "[fieldname]"
      item#.value = "{variable}"
      		
    2. Em seguida, crie outras matrizes de dados em createPayload.entity = "incident". Siga este formato:

      
      ASSIGN createDataArray[#] = item#
      		

      O número (#) precisa incrementar em um a cada item adicional que você adicionar à matriz.

  6. 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, ele será considerado como false.
  7. 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 ServiceNow. Quando definido como false, isso não acontece. Se você não incluir esse atributo na carga útil, ele será considerado como false.
  8. Altere o valor do atributo createPayload.relatesTo para true ou false. Quando definido como true, os agentes podem relacionar outro registro ao registro criado. Quando definido como false, essa funcionalidade não está disponível para os agentes. Se você não incluir esse atributo na carga útil, será assumido como false.
  9. Altere todas as instâncias do [RecordName] nas últimas três linhas do código para o nome do registro que você criou. Capitalize o nome para corresponder ao camel case do atributo. Por exemplo, se o nome do registro que você criou for incident, seu código será:

    
    DYNAMIC createIncidentPayload
    createIncidentPayload.workflowInput = createPayload
    						
    ASSIGN createIncidentJson = "{createIncidentPayload.asjson()}"
    		
  10. Clique na ação Workflow Execute que vem após o SNIPPET deste Fluxo de trabalho. Defina a propriedade workflowPayload dessa ação para a variável create[RecordName]Json na última linha da carga útil SNIPPET. Coloque-o entre chaves ( { } ). Por exemplo, {createIncidentJson}.

  11. Salve o seu script.

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

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

Os fluxos de trabalho de criação padrão criam um registro ServiceNow 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 fluxo de trabalho Criar Registro Personalizado.

Configurar o Workflow de Criação de Caso

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

  2. Caso ainda não tenha feito isso, 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 createCase
    createCase.title = "[Case Name]"
    createCase.entity = "[Contact, User, Consumer, or ConsumerUser]"
    createCase.phoneNumber = "{ANI}"
    						
    createCase.pinnedRecord = "[true or false]"
    createCase.screenPop = "[true or false]"
    createCase.relatesTo = "[true or false]"
    
    DYNAMIC createCasePayload
    createCasePayload.workflowInput = createCase
    						
    ASSIGN createCaseJson = "{createCasePayload.asjson()}"
    		

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

  5. Altere o valor do atributo createCase.title para o nome do caso. Por exemplo, createCase.title = "Elinor's Case". 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 createCase.entity para Contact, User, Consumer ou ConsumerUser. O workflow pesquisa um contato, usuário, consumidor ou consumeruser usando o número de telefone fornecido no atributo createCase.phoneNumber. Se uma única correspondência for encontrada, um caso é criado e relacionado ao contato, usuário, consumidor ou consumeruser. Por exemplo, createCase.entity = "Contact" pesquisa um contato e relaciona o caso criado a esse contato.

  7. Altere o valor do atributo createCase.pinnedRecord para true ou false. Quando definido como true, o registro criado é exibido para os agentes na seção Atual Interactions 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.
  8. Altere o valor do atributo createCase.screenPop para true ou false. Quando definido como true, o registro criado aparece automaticamente para o agente como um pop-up de tela no ServiceNow. Quando definido como false, isso não acontece. Se você não incluir este atributo na carga útil, ele será considerado como false.
  9. Altere o valor do atributo createCase.relatesTo para true ou false. Quando definido como true, os agentes podem relacionar outro registro ao registro criado. Quando definido como false, essa funcionalidade não está disponível para os agentes. Se você não incluir esse atributo na carga útil, ele será assumido como false.
  10. Clique na ação Execução do fluxo de trabalho que vem após o SNIPPET deste Fluxo de trabalho. Defina a propriedade workflowPayload dessa ação como {createCaseJson}. Certifique-se de incluir as chaves.

  11. Salve o seu script.

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

Configure o Workflow Create Consumer

  1. Em Studio, abra o script em que você deseja configurar o workflow Criar Consumidor.

  2. Caso ainda não tenha feito isso, 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 createConsumer
    createConsumer.phoneNumber = "{ANI}"
    createConsumer.firstName = "[first name]"
    createConsumer.lastName = "[last name]"
    createConsumer.email = "[email address]"
    						
    createConsumer.pinnedRecord = "[true or false]"
    createConsumer.screenPop = "[true or false]"
    createConsumer.relatesTo = "[true or false]"
    
    DYNAMIC createConsumerPayload
    createConsumerPayload.workflowInput = createConsumer
    						
    ASSIGN createConsumerJson = "{createConsumerPayload.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, createConsumer.email = "".

  5. Altere o valor do atributo createConsumer.firstName para o nome próprio do contato. Por exemplo, createConsumer.firstName = "Elinor". 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 createConsumer.lastName para o sobrenome do contato. Por exemplo, createConsumer.lastName = "Dashwood". 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 createConsumer.email para o endereço DE e-mail do contato. Por exemplo, createConsumer.email = "elinor.dashwood@classics.com". 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.

  8. Altere o valor do atributo createConsumer.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 createConsumer.screenPop para true ou false. Quando definido como true, o registro criado aparece automaticamente para o agente como um pop-up de tela no ServiceNow. Quando definido como false, isso não acontece. Se você não incluir esse atributo na carga útil, ele será considerado como false.
  10. Altere o valor do atributo createConsumer.relatesTo para true ou false. Quando definido como true, os agentes podem relacionar outro registro ao registro criado. Quando definido como false, essa funcionalidade não está disponível para os agentes. Se você não incluir este atributo na carga útil, ele será considerado como false.
  11. Clique na ação Execução do fluxo de trabalho que vem depois do SNIPPET deste Fluxo de trabalho. Defina a propriedade workflowPayload dessa ação como {createConsumerJson}. Certifique-se de incluir as chaves.

  12. Salve o seu script.

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

Configurar o Workflow de Criação de Contato

  1. Em Studio, abra o script em que você deseja configurar o workflow Create Contact.

  2. Se você ainda não o fez, adicione uma ação SNIPPET depois de 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 createContact
    createContact.phoneNumber = "{ANI}"
    createContact.firstName = "[first name]"
    createContact.lastName = "[last name]"
    createContact.email = "[email address]"
    						
    createContact.pinnedRecord = "[true or false]"
    createContact.screenPop = "[true or false]"
    createContact.relatesTo = "[true or false]"
    						
    DYNAMIC createContactPayload
    createContactPayload.workflowInput = createContact
    						
    ASSIGN createContactJson = "{createContactPayload.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, createContact.email = "".

  5. Altere o valor do atributo createContact.firstName para o nome próprio do contato. Por exemplo, createContact.firstName = "Elinor". 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 createContact.lastName para o sobrenome do contato. Por exemplo, createContact.lastName = "Dashwood". 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 createContact.email para o endereço DE e-mail do contato. Por exemplo, createContact.email = "elinor.dashwood@classics.com". 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.

  8. Altere o valor do atributo createContact.pinnedRecord para true ou false. Quando definido como true, o registro criado é exibido para os agentes na seção Atual Interactions 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á considerado como false.
  9. Altere o valor do atributo createContact.screenPop para true ou false. Quando definido como true, o registro criado aparece automaticamente para o agente como um pop-up de tela no ServiceNow. Quando definido como false, isso não acontece. Se você não incluir este atributo na carga útil, ele será considerado como false.
  10. Altere o valor do atributo createContact.relatesTo para true ou false. Quando definido como true, os agentes podem relacionar outro registro ao registro criado. Quando definido como false, essa funcionalidade não está disponível para os agentes. Se você não incluir esse atributo na carga útil, será assumido como false.
  11. Clique na ação Execução do fluxo de trabalho que vem após o SNIPPET deste Fluxo de trabalho. Defina a propriedade workflowPayload dessa ação como {createContactJson}. Certifique-se de incluir as chaves.

  12. Salve o seu script.

  13. Você pode testar seu script simulando uma interação em Studio ao simular uma interação.

Configurar o Workflow Create Incident

  1. No Studio, abra o script em que você deseja configurar o workflow Create Incidente.

  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 createIncident
    createIncident.title = "[Incident Name]"
    createIncident.entity = "[Contact, User, Consumer, or ConsumerUser]"
    createIncident.phoneNumber = "{ANI}"
    						
    createIncident.pinnedRecord = "[true or false]"
    createIncident.screenPop = "[true or false]"
    createIncident.relatesTo = "[true or false]"
    
    DYNAMIC createIncidentPayload
    createIncidentPayload.workflowInput = createIncident
    ASSIGN createIncidentJson = "{createIncidentPayload.asjson()}"
    		

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

  5. Alterar o valor do atributo createIncident.title para o nome do incidente. Por exemplo, createIncident.title = "Elinor's Incident". 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 createIncident.entity para Contact, User, Consumer ou ConsumerUser. O Workflow pesquisa um contato, usuário, consumidor ou consumeruser usando o número de telefone fornecido no atributo createIncident.phoneNumber. Se uma única correspondência for encontrada, um incidente é criado e relacionado ao contato, usuário, consumidor ou consumeruser. Por exemplo, createIncident.entity = "Contact" pesquisa um contato e relaciona o incidente criado a esse contato.

  7. Altere o valor do atributo createIncident.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.
  8. Altere o valor do atributo createIncident.screenPop para true ou false. Quando definido como true, o registro criado aparece automaticamente para o agente como um pop-up de tela no ServiceNow. Quando definido como false, isso não acontece. Se você não incluir este atributo na carga útil, ele será considerado como false.
  9. Altere o valor do atributo createIncident.relatesTo para true ou false. Quando definido como true, os agentes podem relacionar outro registro ao registro criado. Quando definido como false, essa funcionalidade não está disponível para os agentes. Se você não incluir este atributo na carga útil, ele será considerado como false.
  10. Clique na ação Workflow Execute que vem depois do SNIPPET deste Fluxo de trabalho. Defina a propriedade workflowPayload dessa ação como {createIncidentJson}. Certifique-se de incluir as chaves.

  11. Salve o seu script.

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

Configure o Workflow de Criar Interação

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

  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 createInteraction
    createInteraction.title = "[Interaction Name]"
    createInteraction.entity = "[Contact, User, Consumer, or ConsumerUser]"
    createInteraction.phoneNumber = "{ANI}"
    						
    createInteraction.pinnedRecord = "[true or false]"
    createInteraction.screenPop = "[true or false]"
    createInteraction.relatesTo = "[true or false]"
    						
    DYNAMIC createInteractionPayload
    createInteractionPayload.workflowInput = createInteraction
    ASSIGN createInteractionJson = "{createInteractionPayload.asjson()}"
    		

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

  5. Altere o valor do atributo createInteraction.title para o nome do caso. Por exemplo, createInteraction.title = "Elinor's Interaction". 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 createInteraction.entity para Contact, User, Consumer ou ConsumerUser. O workflow procura um contato, usuário, consumidor ou consumeruser usando o número de telefone fornecido no atributo createInteraction.phoneNumber. Se uma única correspondência for encontrada, uma interação é criada e relacionada ao contato, usuário, consumidor ou consumeruser. Por exemplo, createInteraction.entity = "Contact" procura um contato e relaciona a interação criada a esse contato.

  7. Altere o valor do atributo createInteraction.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, ele será considerado como false.
  8. Altere o valor do atributo createInteraction.screenPop para true ou false. Quando definido como true, o registro criado aparece automaticamente para o agente como um pop-up de tela no ServiceNow. Quando definido como false, isso não acontece. Se você não incluir este atributo na carga útil, será considerado false.
  9. Altere o valor do atributo createInteraction.relatesTo para true ou false. Quando definido como true, os agentes podem relacionar outro registro ao registro criado. Quando definido como false, essa funcionalidade não está disponível para os agentes. Se você não incluir este atributo na carga útil, será assumido como false.
  10. Clique na ação Workflow Execute que vem após o SNIPPET deste Fluxo de trabalho. Defina a propriedade workflowPayload dessa ação para {createInteractionJson}. Certifique-se de incluir as chaves.

  11. Salve o seu script.

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

Configure o Workflow de Criação de Usuário

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

  2. Caso ainda não tenha feito isso, 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 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.firstName = "[first name]"
    createUser.lastName = "[last name]"
    createUser.email = "[email address]"
    						
    createUser.pinnedRecord = "[true or false]"
    createUser.screenPop = "[true or false]"
    createUser.relatesTo = "[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.email = "".

  5. Altere o valor do atributo createUser.firstName para o nome próprio do contato. Por exemplo, createUser.firstName = "Elinor". 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 createUser.lastName para o sobrenome do contato. Por exemplo, createUser.lastName = "Dashwood". 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 createUser.email para o endereço DE e-mail do contato. Por exemplo, createUser.email = "elinor.dashwood@classics.com". 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.

  8. 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 Atual Interactions 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 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 ServiceNow. Quando definido como false, isso não acontece. Se você não incluir este atributo na carga útil, ele será considerado como false.
  10. Altere o valor do atributo createUser.relatesTo para true ou false. Quando definido como true, os agentes podem relacionar outro registro ao registro criado. Quando definido como false, essa funcionalidade não está disponível para os agentes. Se você não incluir esse atributo na carga útil, ele será considerado como false.
  11. Clique na ação Workflow Execute que vem depois do SNIPPET deste Fluxo de trabalho. Defina a propriedade workflowPayload dessa ação como {createUserJson}. Certifique-se de incluir as chaves.

  12. Salve o seu script.

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

Atualizar Fluxos de trabalho

Os fluxos de trabalho de atualização permitem que você configure uma carga útil SNIPPET para atualizar registros personalizados de ServiceNow. Os fluxos de trabalho de atualização podem atualizar registros personalizados recuperados por fluxos de trabalho de pesquisa. Eles também podem atualizar registros criados por fluxos de trabalho de criação personalizada.

Elinor Dashwood configurou fluxos de trabalho de Custom Create para criar registros de ServiceNow. No entanto, ela percebe que o campo Creator nesses registros é preenchido com a conta de usuário ServiceNow que ela criou para a configuração de NiCE CXone. Ela configura um fluxo de trabalho de Update em seu script do Studio para que o valor do campo Creator seja atualizado para o agente que estiver atendendo à interação.

Configurar o Workflow Atualizar Registro Personalizado

O workflow Update Custom Record atualiza os campos de um registro personalizado. Você pode usá-lo para:

  • Atualiza os campos de um registro personalizado recuperado por um workflow de pesquisa. Update Custom Record foi projetado para correspondência única. Se mais de um registro for retornado na pesquisa, somente o primeiro registro recuperado será atualizado.

  • Atualizar os campos de um registro criado por um workflow de criação personalizada.

Cada workflow Update Custom Record pode atualizar somente um registro. Para atualizar mais que um registro, configure mais que um workflow Update Custom Record.

  1. Em Studio, abra o script em que você deseja configurar o workflow Atualizar Registro Personalizado.

  2. 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 updatePayload
    updatePayload.table = "[entity API]"
    updatePayload.entityId = workflowResultSet.result[1].records[1].id
    
    DYNAMIC fields
    fields[1].name = "short_description"
    fields[1].value = "[record] updated for phone number {ANI}"
    fields[2].name = "state" 
    fields[2].value = "[#]" // 1 - New , 2 - In Progress , 3 - Hold , 4 - Resolved, 5 - Closed, 6 - Cancelled
    
    updatePayload.fields = fields
    
    DYNAMIC updateInput
    updateInput.workflowInput = updatePayload
    ASSIGN updateInputJson = "{updateInput.asjson()}"
    		
  5. Altere o valor do atributo updatePayload.table para o nome da API do registro que você deseja atualizar. Por exemplo, updatePayload.table = "incident". Diferencia maiúsculas de minúsculas.
  6. No atributo fields[1].value, altere o Placeholder [record] para o nome do registro personalizado. Por exemplo, fields[1].value = "incident updated for phone number {ANI}". Você também pode alterar o valor inteiro para uma descrição breve diferente para o registro.
  7. No atributo fields[2].value, insira o número que indica o status do registro. Por exemplo, se este registro estiver resolvido, fields[1].value = "4".
  8. Salve o seu script.

  9. 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 ServiceNow 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. For example, if you're using the standard Create Contact workflow, this line should be createContact.pinnedRecord = "true".

  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 ServiceNow. Isso é feito editando a carga útil do Workflow. No Agent Workspace (Embedded) (Agent Embedded) para Kustomer e todas as integrações com ServiceNow, somente um registro pode aparecer como pop-up de tela:

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[RecordName]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 Create Contact, esta linha deve ser createContact.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 do 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[RecordName]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 Contato, esta linha deve ser createContact.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.