Definir uma configuração de CRM para o HubSpot

Esta página explica como configurar uma configuração de CRM para HubSpot. Isso é concluído em NiCE CXone. A configuração conecta HubSpot a NiCE CXone Agent Workspace (Browser Extension) (Agent Integrated). Isso permite que os dois compartilhem dados por meio de memorialização de dados e mapeamento de dados dinâmicos.

Quando um token de autenticação do CRM expira, leva de 9 a 15 segundos para gerar um novo. Isso significa que a memorialização de dados e o mapeamento de dados dinâmicos podem levar de 9 a 15 segundos para serem executados, especialmente durante a primeira interação do dia.

Complete cada uma dessas tarefas na ordem indicada.

Criar uma nova configuração de CRM no NiCE CXone

Permissões necessárias: Configurações Criar

Forneça a NiCE CXone as informações necessárias para conectar a HubSpot.

Se a conta de usuário HubSpot que criou a configuração do CRM for excluída ou desativada, a configuração do CRM também será excluída. Evite isso criando uma conta de usuário no HubSpot especificamente para a configuração do NiCE CXone. Este é o usuário do sistema. É recomendável conceder ao usuário do sistema privilégios de administrador. Se você não quiser conceder privilégios de administrador ao usuário do sistema, você deve atribuir a ele:

  • Acesso de leitura a todos os registros de entidade HubSpot e campos de entidade.

  • Acesso de Leitura/Gravar a todos os HubSpot registros de entidade que serão acessados ou atualizados nos fluxos de trabalho que você configurou, incluindo fluxos de trabalho de pesquisa, fluxos de trabalho de criação e memorialização de dados.

Os fluxos de trabalho que você configurar mais adiante neste processo utilizam as funções e permissões do usuário do sistema. Quando os registros são criados ou atualizados, eles usam o nome e o fuso horário do usuário do sistema.

  1. Em NiCE CXone, clique no seletor de aplicativos Icon of three-by-three grid of white squares on a blue background e selecioneIntegrações de agente ícone: uma engrenagem laranja com três setas dentro. > Configurações.
  2. Clique em nova configuração CRM.
  3. No menu suspenso Selecionar região, selecione a região à qual deseja conectar esta configuração do CRM: AMERICAS, APAC ou EMEA.

    Você não pode alterar essa região posteriormente. Se você quiser mover uma configuração de CRM de uma região para outra, você deve criar uma nova configuração de CRM. Isso inclui reautenticar, recriar a memorialização de dados e os mapeamentos de dados dinâmicos, e reconfigurar as ações WORKFLOW EXECUTE e AGENT WORKFLOW CONFIGURATION no seu script Studio.

  4. Selecione HubSpot na lista suspensa Tipo de integração.
  5. Insira um Nome da configuração. Você pode escrever uma Descrição.
  6. Clique em Autenticar.
  7. Na janela pop-up Autenticação, selecione uma das contas autenticadas listadas, se houver.

    Cada conta HubSpot deve ser usada para autenticar uma configuração de CRM. Não reutilize contas.

    Se houver contas listadas, mas você quiser criar uma nova, role até o final da lista suspensa e clique em Add a new account. Se não houver contas listadas, clique em New authentication. Configure os campos exibidos:

    1. Para alterar o nome da autenticação, edite Your authentication name.
    2. Para se habilitar a gerenciar as configurações desta integração dentro de HubSpot, insira sua Developer API key. Para localizá-la, abra sua conta de desenvolvedor HubSpot e navegue até o painel de Aplicativos. Clique em Get HubSpot API key na parte superior. Na janela pop-up exibida, clique em Show key. Copie e cole a chave no campo Developer API key.
    3. Insira seu Private app access token. Para localizá-lo, abra HubSpot e navegue até o private app Box with arrow indicating navigation to external site. que você criou para Agent Workspace (Browser Extension) (Agent Integrated). Na página de detalhes desse Aplicativo, clique em Show token. Copie e cole o token no campo Private app access token.
    4. Clique em Create.
    5. Se ainda não o tiver feito, faça login em HubSpot com a conta de usuário do sistema que você criou especificamente para a configuração de NiCE CXone. Se você já estiver conectado a HubSpot, certifique-se de que está conectado com a conta de usuário do sistema.
    6. Se uma janela de HubSpot aparecer solicitando permissão para que NiCE se conecte à sua conta HubSpot, clique em Allow.

  8. Clique em Avançar.
  9. No campo external_screenpop_domain_hs, enter o seu subdomínio HubSpot. Para localizá-lo, abra a instância do HubSpot e copie e cole o URL que for exibido na barra de endereços do navegador. Você só precisa do URL até .com. Por exemplo: https://ven12345.hubspot.com.
  10. No campo account_id, insira seu Hub ID. Ele deve ser o ID do Hub correspondente a uma conta de administrador.
  11. Clique em Terminar. Uma mensagem informando que a autenticação está ativa aparece no canto inferior direito.
  12. Clique em Salvar no canto superior direito de Integrações de agente.

Criar Mapeamentos de Memorialização de dados

Permissões necessárias: Configurações Editar; Memorialização de dados Criar

Data memorialization mappings allow for data from Agent Workspace (Browser Extension) (Agent Integrated) to be popped into HubSpot records. In these mappings, you select the NiCE CXone data field to map to each HubSpot record field. For example, if you map the Customer Name NiCE CXone data field to the Name HubSpot record field, Name displays the value from Customer Name. Only text is mapped; attachments, images, and notes cannot be mapped. Currently, you can set up data mappings for standard CRM entity types.

Para interações de voz, a memorialização de dados ocorre quando a chamada termina e o agente completa o tempo de ACWClosed Estado que permite que um agente conclua as tarefas necessárias após finalizar uma interação., se configurado. Para interações digitaisClosed Qualquer canal, contato ou competência associado a Digital Experience (DX)., isso ocorre quando o agente transfere a interação ou quando ele a Desatribui e Dispensa de si mesmo. Se o contatoClosed A pessoa que interage com um agente, Rvi ou bot em seu contact center. encerrar a interação primeiro, a memorialização de dados não ocorrerá para status, disposições, notas e tags. No entanto, toda outra memorialização de dados configurada será mapeada para o registro do CRM.

  1. Se ainda não o fez, abra uma configuração de CRM para HubSpot. Em NiCE CXone, clique no seletor de aplicativos Icon of three-by-three grid of white squares on a blue background e selecioneIntegrações de agente icon: an orange gear with three arrows inside. > Configurações. Selecione uma configuração de CRM na lista.
  2. Clique na guia Memorialização de dados.
  3. Clique em Novo Mapeamento de dados.
  4. Digite um Nome para o mapeamento. Opcionalmente, você pode inserir uma Descrição.
  5. No menu suspenso Selecionar Tipo de entidade, selecione o Tipo de registro HubSpot para o qual deseja criar mapeamentos de campo.

  6. Clique em Adicionar entidade.
  7. No menu suspenso Campo de CRM Externo exibido, selecione o campo de registro HubSpot do qual você deseja receber dados de Agent Workspace (Browser Extension) (Agent Integrated).

    Se quiser mapear a transcrição completa de uma interação, selecione um campo de registro com formatação adequada e um limite de caracteres grande o suficiente. Se o campo não atender a esses requisitos, apenas parte ou nenhuma da transcrição será exibida, dependendo do CRM.

  8. No menu suspenso Selecionar canal, selecione o tipo de dados NiCE CXone que deseja mapear para o campo de registro HubSpot que você selecionou.

    Recomendamos criar dois mapeamentos separados para voz e digital channels em cada novo canal que você criar. Isso serve para evitar mapeamentos de dados desnecessários para registros em uma interação. As ações Studio podem então ser adicionadas aos mapeamentos de voz ou digitais.

  9. No menu suspenso NiCE CXone Data, selecione o campo de dados NiCE CXone que você deseja mapear para o campo de registro HubSpot selecionado.

    Se você selecionou Variável de script na lista suspensa Selecionar canal, digite a variável de script no campo CXone Dados. Você deve digitá-la em letras minúsculas, mesmo que tenha usado caixa alta no script para definir a Variável.

  10. Para adicionar mais campos de dados, clique em Adicionar campo.
  11. Para configurar mapeamentos para outro tipo de registro HubSpot, selecione um tipo de registro diferente na lista suspensa Selecionar Tipo de entidade e clique em Adicionar entidade.
  12. Clique em Salvar na parte superior da página. O mapeamento de dados ativo aparece na guia Memorialização de dados.

    Na próxima tarefa deste processo, selecione esse mapeamento de dados na ação AGENT WORKFLOW CONFIGURATION Ação em seu script Studio. Ela aparece quando você seleciona Memorialização de dados no menu suspenso Ações no assistente da ação.

Criar Mapeamentos de Mapeamento de dados Dinâmicos

Permissões necessárias: Configurações Editar; Dados dinâmicos Criar

Os mapeamentos de dados dinâmicos permitem que você escolha quais campos de registro HubSpot aparecem em Agent Workspace (Browser Extension) (Agent Integrated). Você pode configurar mapeamentos de dados dinâmicos para tipos de registro padrão HubSpot recuperados por fluxos de trabalho de pesquisa. Você também pode configurá-los para registros personalizados criados por fluxos de trabalho de criação personalizada. Para cada tipo de registro, você pode adicionar até dez campos de cadeia de caracteres. Você pode adicionar até três campos com um tipo de dados diferente de cadeia de caracteres.

  1. Se ainda não o fez, abra uma configuração de CRM para HubSpot. Em NiCE CXone, clique no seletor de aplicativos Icon of three-by-three grid of white squares on a blue background e selecioneIntegrações de agente icon: an orange gear with three arrows inside. > Configurações. Selecione uma configuração de CRM na lista.
  2. Clique na guia Dados dinâmicos.
  3. Clique em Novo Mapeamento de dados.
  4. Digite um Nome para o mapeamento. Opcionalmente, você pode inserir uma Descrição.
  5. No menu suspenso Selecionar Tipo de entidade, selecione o Tipo de registro HubSpot com os campos que você deseja exibir em Agent Workspace (Browser Extension) (Agent Integrated).

  6. Clique em Adicionar entidade.
  7. No menu suspenso Campo de CRM Externo exibido, selecione o campo de registro HubSpot que deseja exibir para os agentes.

  8. Para adicionar mais campos de registro HubSpot, clique em Adicionar campo. Você pode adicionar até cinco campos por tipo de registro.
  9. Clique em Salvar na parte superior da página. O mapeamento ativo de dados dinâmicos será exibido na guia Dados dinâmicos.

    Na próxima tarefa neste processo, selecione esse mapeamento de dados dinâmico na ação AGENT WORKFLOW CONFIGURATION Ação em seu script Studio. Ela aparece quando você seleciona Pesquisar na lista suspensa Ações no assistente da ação.

A próxima etapa da integração de HubSpot com Agent Workspace (Browser Extension) (Agent Integrated) é modificar o seu script Studio.