Configurar os HubSpot fluxos de trabalho de CXone Agent

Esta é a última etapa da integração do HubSpot com o CXone Agent.

É possível configurar os fluxos de trabalho Procurar, Criação personalizada e Criação padrão para o HubSpot e CXone Agent. 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.

Linha do tempo personalizada não é permitida no HubSpot.

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:

    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 HubSpotCaixa com seta indicando navegação para site externo.. 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.

    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.

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

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 Caixa com seta indicando navegação para site externo. 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.

    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.

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 Criação personalizada.

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.

      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.