Configurar os HubSpot fluxos de trabalho de CXone Agent for Microsoft Teams

É possível configurar os fluxos de trabalho Procurar, Criação personalizada e Criação padrão para o HubSpot e CXone Agent for Microsoft Teams. Esses fluxos de trabalho procuram ou criam registros do HubSpot, 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	Os fluxos de trabalho de pesquisa verificam no HubSpot os registros que se aplicam à interação que estiver sendo tratada pelo agente.	Procurar ANI
		Pesquisa personalizada
Criação personalizada	Os fluxos de trabalho Criação personalizada criam qualquer tipo de registro com campos padrão e personalizados.	Criação personalizada
Criação padrão	Os fluxos de trabalho Criação padrão criam registros padrão do HubSpot 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 empresa
		Criar contato
		Criar ticket
		Criar ticket com associação

Configurar os fluxos de trabalho de pesquisa

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

Configurar o fluxo de trabalho Procurar ANI

Você pode configurar o fluxo de trabalho Procurar por ANI para chamadas telefônicas ou e-mails.

1. No Studio, abra o script no qual você deseja configurar o fluxo de trabalho Procurar ANI.

2. Se ainda não o fez, adicione uma ação SNIPPET após BEGIN e antes da ação Workflow Execute.

3. Clique duas vezes na ação SNIPPET na tela do script.

4. Para configurar o fluxo de trabalho Procurar por ANI para chamadas telefônicas, copie cada uma das seguintes linhas de código e cole-as na guia Visualização em texto da janela Editor.

   
   ASSIGN phoneNumber = "{ANI}"
   ASSIGN email = ""
   DYNAMIC searchInput
   searchInput.phoneNumber = "{phoneNumber}"
   DYNAMIC searchFlowPayload
   searchFlowPayload.workflowInput = searchInput
   		

5. Para configurar o fluxo de trabalho Procurar por ANI para e-mails, copie cada uma das seguintes linhas de código e cole-as na guia Visualização em texto da janela Editor.

   
   ASSIGN phoneNumber = ""
   ASSIGN email = "{ANI}"
   DYNAMIC searchInput
   searchInput.email = "{email}"
   DYNAMIC searchFlowPayload
   searchFlowPayload.workflowInput = searchInput
   		

6. Salve o seu script.

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

Configurar o fluxo de trabalho de pesquisas personalizadas

O fluxo de trabalho Pesquisa personalizada permite procurar um ou mais registros do HubSpot. Também permite que você procure vários campos e variáveis ​​dentro de um registro especificado. Você pode conectar diferentes requisitos de pesquisa usando operadores do HubSpot.

Este fluxo de trabalho é compatível com os seguintes registros do HubSpot:

• Empresa
• Contato
• Ticket (com ou sem registros associados)

1. No Studio, abra o script no qual quer configurar o fluxo de trabalho Pesquisa personalizada.

2. Se ainda não o fez, adicione uma ação SNIPPET após BEGIN e antes da ação Workflow Execute.

3. Clique duas vezes 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 filterGroups
   	
   DYNAMIC filters1
   filters1.propertyName = "[fieldName]"
   filters1.operator = "[operator]"
   filters1.value = "[value]"
   
   DYNAMIC filters2
   filters2.propertyName = "[fieldName]"		
   filters2.operator = "[operator]"
   filters2.value = "[value]"
   
   filterGroups.filters[1] = filters1
   filterGroups.filters[2] = filters2
   
   DYNAMIC sorts
   DYNAMIC sort1
   sort1.propertyName = "[fieldName]"
   sort1.direction = "[ASCENDING or DESCENDING]"
   sorts[1] = sort1
   
   DYNAMIC searchArray
   searchArray[1].entity = "[API name]"
   searchArray[1].filter.filterGroups[1] = filterGroups
   
   DYNAMIC searchFlowPayload
   searchFlowPayload.workflowInput.entities = searchArray
   		

5. Altere os valores dos atributos filters1 e filters2.

   1. Altere os valores dos atributos filters1.propertyName e filters2.propertyName para os nomes dos campos que você deseja usar para pesquisar. Por exemplo, filters1.propertyName = "subject".

      Uma lista completa de nomes de campos, chamados de propriedades, e terminais pode ser encontrada na documentação do HubSpot dos registros:

      • Empresa

      • Contato

      • Ticket

   2. Altere os valores dos atributos filters1.operator e filters2.operator para os operadores do HubSpot que você deseja usar. É possível encontra uma lista completa de operadores do HubSpot na documentação do HubSpot. Isso diferencia maiúsculas de minúsculas.

   3. Altere os valores dos atributos filters1.value e filters2.value para os valores que você deseja atribuir aos campos. Por exemplo, filters1.value = "Account invalid Login".

6. Altere os valores dos atributos sort1.

   1. Altere o valor do atributo sort1.propertyName para o campo que você deseja usar para classificar os resultados. Por exemplo, sort1.propertyName = "createdate".

   2. Altere o valor do atributo sort1.direction para ASCENDING ou DESCENDING.

7. Altere o valor do atributo searchArray[1].entity para o nome da API correspondente ao registro que você quer procurar. Por exemplo, searchArray[1].entity = "companies". Isso diferencia maiúsculas de minúsculas.

   Ver os nomes de API correspondentes a cada registro

   Gravar	API	Vinculável
   Empresa	companies	Sim
   Contato	contacts	Sim
   Ticket	tickets	Sim

8. Salve o seu script.

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

Configurar os fluxos de trabalho de criação personalizada

Os fluxos de trabalho Criação personalizada permitem configurar uma carga útil SNIPPET para criar qualquer tipo de registro do HubSpot, 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 Empresa com alguns campos padrão desse tipo de registro, bem como seus próprios campos personalizados.

Configurar o fluxo de trabalho Criação personalizada

O fluxo de trabalho Criação personalizada cria qualquer tipo de registro do HubSpot, 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.

1. Certifique-se de que você tenha a ferramenta Sales Hub Enterprise ativada no HubSpot. Você precisa dessa ferramenta para criar registros personalizados do HubSpot.

2. Use esta documentação do HubSpot para criar um registro, ou objeto, personalizado no HubSpot.

3. No Studio, abra o script no qual quer configurar o fluxo de trabalho Criação personalizada.

4. Se ainda não o fez, adicione uma ação SNIPPET após BEGIN e antes da ação Workflow Execute.

5. Clique duas vezes na ação SNIPPET na tela do script.

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

   
   DYNAMIC createPayload
   createPayload.entities.name = "[custom record API]"
   createPayload.entities.properties.[fieldName]= "[field value]"
   createPayload.entities.properties.[fieldName]= "[field value]"
   createPayload.entities.properties.[fieldName]= "[field value]"
   createPayload.entities.properties.[fieldName]= "[field value]"
   						
   createPayload.pinnedRecord = "[true or false]"
   
   DYNAMIC create[ObjectName]Payload
   create[ObjectName]Payload.workflowInput = createPayload
   
   ASSIGN create[ObjectName]Json = "{create[RecordName]Payload.asjson()}"
   		

7. Altere o valor do atributo createPayload.entities.name para a API do registro personalizado que você criou. Por exemplo, createPayload.entities.name = "companies". Isso diferencia maiúsculas de minúsculas.

   Ver os nomes de API correspondentes a cada registro padrão

   Gravar	API	Vinculável
   Empresa	companies	Sim
   Contato	contacts	Sim
   Ticket	tickets	Sim

8. Nos atributos createPayload.entities.properties, altere [fieldname] para o nome do campo que você deseja adicionar ao registro personalizado. Por exemplo, createPayload.entities.properties.accountNumber.

9. Altere os valores dos atributos createPayload.entities.properties para os valores que você deseja atribuir aos campos. Por exemplo, createPayload.entities.properties.accountNumber = "12345".

10. Altere o valor do atributo createPayload.pinnedRecord para true ou false. Quando definido como true, o registro criado será exibido aos agentes na seção Interações atuais do cartão de cliente. Se definido como false, ele será exibido na seção Interações recentes do cartão de cliente. Se você não incluir esse atributo na carga útil, ele será presumido como false.

11. Altere todas as instâncias do [ObjectName] nas últimas três linhas do código para o nome do registro que você criou. Coloque o nome em maiúsculas para corresponder ao formato em caixa alta do atributo. Por exemplo, se o nome do registro que você criou for account, seu código será:

    
    DYNAMIC createAccountPayload
    createAccountPayload.workflowInput = createPayload
    						
    ASSIGN createAccountJson = "{createAccountPayload.asjson()}"
    		

12. Salve o seu script.

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

Configurar os fluxos de trabalho de criação padrão

Os fluxos de trabalho Criação padrão permitem que os usuários procurem registros padrão do HubSpot dentro do HubSpot.

Configurar o fluxo de trabalho Criar empresa

1. No Studio, abra o script no qual deseja configurar o fluxo de trabalho Criar empresa.

2. Se ainda não o fez, adicione uma ação SNIPPET após BEGIN e antes da ação Workflow Execute.

3. Clique duas vezes 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
   createPayload.entities.name = "company"
   createPayload.entities.properties.name = "[company name]"
   createPayload.entities.properties.domain = "[company website]"
   createPayload.entities.properties.city = "[company city]"
   createPayload.entities.properties.phone = "[company phone number]"
   						
   DYNAMIC createCompanyPayload
   createCompanyPayload.workflowInput = createPayload
   
   ASSIGN createCompanyJson = "{createCompanyPayload.asjson()}"
   		

   É necessário incluir cada uma dessas linhas. Caso queira deixar em branco um campo, utilize um valor nulo (""). Por exemplo, createPayload.entities.properties.city = "".

5. Altere os valores dos atributos. Qualquer um destes pode ser codificado, uma variável ou uma combinação destes. Utilize uma variável, caso queira que o valor seja atualizado a cada interação.

   1. Altere o valor do atributo createPayload.entities.properties.name para o nome da empresa. Por exemplo, createPayload.entities.properties.name = "Classics, Inc.".

   2. Altere o valor do atributo createPayload.entities.properties.domain para o site da empresa. Por exemplo, createPayload.entities.properties.domain = "classics.com".

   3. Altere o valor do atributo createPayload.entities.properties.city para a cidade da empresa. Por exemplo, createPayload.entities.properties.city = "London".

   4. Altere o valor do atributo createPayload.entities.properties.phone para o número de telefone da empresa. Por exemplo, createPayload.entities.properties.phone = "1234567890".

6. Salve o seu script.

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

Configurar o fluxo de trabalho de criação de contatos

1. No Studio, abra o script no qual deseja configurar o fluxo de trabalho Criar contato.

2. Se ainda não o fez, adicione uma ação SNIPPET após BEGIN e antes da ação Workflow Execute.

3. Clique duas vezes 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
   createPayload.entities.name = "contact"
   createPayload.entities.properties.firstName = "[first name]"
   createPayload.entities.properties.email = "[email address]"
   createPayload.entities.properties.lastName = "[last name]"
   createPayload.entities.properties.phone = "[phone number]"
   
   DYNAMIC createContactPayload
   createContactPayload.workflowInput = createPayload
   
   ASSIGN createContactJson = "{createContactPayload.asjson()}"
   		

   É necessário incluir cada uma dessas linhas. Caso queira deixar em branco um campo, utilize um valor nulo (""). Por exemplo, createPayload.entities.properties.email = "".

5. Altere os valores dos atributos. Qualquer um destes pode ser codificado, uma variável ou uma combinação destes. Utilize uma variável, caso queira que o valor seja atualizado a cada interação.

   1. Altere o valor do atributo createPayload.entities.properties.firstName para o nome do contato. Por exemplo, createPayload.entities.properties.firstName = "Elinor".

   2. Altere o valor do atributo createPayload.entities.properties.email para o endereço de e-mail do contato. Por exemplo, createPayload.entities.properties.email = "elinor.dashwood@classics.com".

   3. Altere o valor do atributo createPayload.entities.properties.lastName para o sobrenome do contato. Por exemplo, createPayload.entities.properties.lastName = "Dashwood".
      

   4. Altere o valor do atributo createPayload.entities.properties.phone para o número de telefone do contato. Por exemplo, createPayload.entities.properties.phone = "1234567890".

6. Salve o seu script.

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

Configurar o fluxo de trabalho Criar ticket

1. No Studio, abra o script no qual deseja configurar o fluxo de trabalho Criar ticket.

2. Se ainda não o fez, adicione uma ação SNIPPET após BEGIN e antes da ação Workflow Execute.

3. Clique duas vezes 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
   createPayload.entities.name = "ticket"
   createPayload.entities.properties.subject = "[ticket subject]"
   createPayload.entities.properties.hs_pipeline = "[#]"
   createPayload.entities.properties.hs_pipeline_stage = "[#]"
   createPayload.entities.properties.hs_ticket_priority = "[LOW, MEDIUM, or HIGH]"
   
   DYNAMIC createTicketPayload
   createTicketPayload.workflowInput = createPayload
   
   ASSIGN createTicketJson = "{createTicketPayload.asjson()}"
   		

   É necessário incluir cada uma dessas linhas. Caso queira deixar em branco um campo, utilize um valor nulo (""). Por exemplo, createPayload.entities.properties.hs_ticket_priority = "".

5. Altere os valores dos atributos.

   1. Altere o valor do atributo createPayload.entities.properties.subject para o assunto do ticket: por que ele foi criado. Por exemplo, createPayload.entities.properties.subject = "Query about large book orders". Isso pode ser codificado, uma variável ou uma combinação destes. Utilize uma variável, caso queira que o valor seja atualizado a cada interação.

   2. Altere o valor do atributo createPayload.entities.properties.hs_pipeline para o número do pipeline do ticket. Por exemplo, createPayload.entities.properties.hs_pipeline = "0".

   3. Altere o valor do atributo createPayload.entities.properties.hs_pipeline_stage para o número que indica o status do ticket no pipeline. Por exemplo, createPayload.entities.properties.hs_pipeline_stage = "3".
      

   4. Altere o valor do atributo createPayload.entities.properties.hs_ticket_priority para LOW, MEDIUM ou HIGH.

6. Salve o seu script.

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

Configurar o fluxo de trabalho Criar ticket com associação

1. No Studio, abra o script no qual deseja configurar o fluxo de trabalho Criar ticket com associação.

2. Se ainda não o fez, adicione uma ação SNIPPET após BEGIN e antes da ação Workflow Execute.

3. Clique duas vezes 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
   createPayload.entities.name = "ticket"
   createPayload.entities.properties.subject = "[ticket subject]"
   createPayload.entities.properties.hs_pipeline = "[#]"
   createPayload.entities.properties.hs_pipeline_stage = "[#]"
   createPayload.entities.properties.hs_ticket_priority = "[LOW, MEDIUM, or HIGH]"
   
   DYNAMIC Association
   DYNAMIC item1
   item1.relatedObjectType = "[record API]"
   item1.relatedObjectId = "[#]"
   createPayload.entities.association[1] = item1
   
   DYNAMIC createTicketPayload
   createTicketPayload.workflowInput = createPayload
   
   ASSIGN createTicketJson = "{createTicketPayload.asjson()}"
   		

   É necessário incluir cada uma dessas linhas. Caso queira deixar em branco um campo, utilize um valor nulo (""). Por exemplo, createPayload.entities.properties.hs_ticket_priority = "".

5. Altere os valores dos atributos createPayload.

   1. Altere o valor do atributo createPayload.entities.properties.subject para o assunto do ticket: por que ele foi criado. Por exemplo, createPayload.entities.properties.subject = "Query about mass book orders". Isso pode ser codificado, uma variável ou uma combinação destes. Utilize uma variável, caso queira que o valor seja atualizado a cada interação.

   2. Altere o valor do atributo createPayload.entities.properties.hs_pipeline para o número do pipeline do ticket. Por exemplo, createPayload.entities.properties.hs_pipeline = "0".

   3. Altere o valor do atributo createPayload.entities.properties.hs_pipeline_stage para o número que indica o status do ticket no pipeline. Por exemplo, createPayload.entities.properties.hs_pipeline_stage = "3".
      

   4. Altere o valor do atributo createPayload.entities.properties.hs_ticket_priority para LOW, MEDIUM ou HIGH.

6. Altere os valores dos atributos item1.

   1. Altere o valor do atributo item1.relatedObjectType para a API do registro que você deseja conectar a esse fluxo de trabalho. Por exemplo, item1.relatedObjectType = "companies". Isso diferencia maiúsculas de minúsculas.

      Ver os nomes de API correspondentes a cada registro

      Gravar	API	Vinculável
      Empresa	companies	Sim
      Contato	contacts	Sim
      Ticket	tickets	Sim

   2. Altere o valor do atributo item1.relatedObjectId para o número de ID do registro que você deseja conectar a esse fluxo de trabalho. Por exemplo, item1.relatedObjectId = "19019671367".

7. Salve o seu script.

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

Fixar registros

Como fixar um registro na seção Interação atual do cartão de cliente.

1. Abra o SNIPPET com o fluxo de trabalho do registro que você quer fixar.

2. Copie esta linha de código e cole-a antes de DYNAMIC create[RecordType]Payload:

   						
   createPayload.pinnedRecord = "true"					
   		

3. Salve o seu script.