Conector de entrada do Salesforce

Sobre o Salesforce Inbound Connector

Você pode usar o conector de entrada do Salesforce para carregar dados de relatórios operacionais de sua conta do Salesforce no XM Discover.

Configuração necessária no Salesforce

Para conectar XM Discover ao Salesforce, você precisará das seguintes informações sobre sua conta do Salesforce:

• Sua chave de consumidor do Salesforce (ID do cliente)
• Seu segredo de consumidor do Salesforce (segredo do cliente)
• Seu nome de usuário e senha do Salesforce
• URL do ambiente de sua organização do Salesforce
• Uma consulta válida da linguagem de consulta de objetos do Salesforce (SOQL) para recuperar feedback ou interações de bate-papo
  Qdica: o SOQL permite que você pesquise informações específicas nos dados do Salesforce de sua organização. O SOQL é semelhante à instrução “SELECT” da SQL (Structured Query Language), amplamente utilizada, mas foi projetado especificamente para os dados do Salesforce. Para obter uma introdução ao SOQL, consulte esta página de ajuda do Salesforce.

Além disso, você deve fazer o seguinte em sua conta do Salesforce:

1. Em seu aplicativo conectado, selecione Ativar configurações do OAuth. Consulte esta página de ajuda do Salesforce para obter mais informações.
2. Defina o URL de retorno de chamada como: https://data.us1.qualtrics.io/connectors?token_type=salesforce
3. Selecione os seguintes escopos OAuth:
   • Acessar permissões personalizadas (custom_permissions)
   • Acesso a identificadores de usuário exclusivos (openid)
   • Acesso total (completo)
   • Gerencie os dados do usuário por meio de APIs (api)
   • Realizar solicitações a qualquer momento (refresh_token, offline_access)
   • Certifique-se de que o PKCE não esteja ativado
4. No mesmo mapa conectado, selecione Manage OAuth Access Policies (Gerenciar políticas de acesso OAuth). Consulte esta página de ajuda do Salesforce para obter mais informações.
5. Escolha as seguintes opções:
   • Usuário permitido: todos os usuários podem se autorizar.
   • Política de token de atualização: O token de atualização é válido até ser revogado.

Configuração de um trabalho de entrada do Salesforce

1. Na página Jobs, clique em New Job (Novo trabalho).
   
2. Selecione Salesforce.
   
3. Dê um nome ao seu trabalho para que você possa identificá-lo.
   
4. Escolha o projeto para carregar os dados.
5. Faça uma descrição do seu trabalho para que você saiba o propósito dele.
6. Clique em Seguinte.
7. Escolha uma conta do Salesforce para usar ou selecione Adicionar nova para adicionar uma nova conta.
8. Se estiver adicionando uma nova conta, insira as seguintes informações sobre sua conta do Salesforce:
   • Nome da conexão: Dê um nome à conexão para que você possa identificá-la.
   • ID do cliente do Salesforce: Sua chave de consumidor do Salesforce.
   • Segredo do cliente do Salesforce: seu segredo de consumidor do Salesforce
   • Ambiente do Salesforce: URL do ambiente de sua organização Salesforce
   • Ambiente de teste: Se estiver se conectando a um ambiente de teste, ative essa opção.
9. Clique em Authorize (Autorizar).
10. Se quiser que suas credenciais expirem, configure as seguintes opções:
    
    • Enviar notificações de expiração: Selecione essa opção para permitir que suas credenciais expirem.
    • Dias antes da expiração: Se estiver ativando as notificações de expiração, insira quantos dias você gostaria de ser notificado antes da expiração. Você pode inserir um valor entre 1 e 100 dias.
    • Data de expiração: Defina a data em que as credenciais expirarão. Clique na caixa para abrir um calendário e escolher a data.
11. Clique em Seguinte.
12. Escolha o tipo de feedback a ser carregado do Salesforce:
    
    • Feedback do Salesforce: Faça upload de comentários regulares.
    • Salesforce Chat: Carregar interações de agente/cliente do Salesforce Chat.
    • Texto SMS do Salesforce: Carregar interações de agente/cliente do Salesforce LiveMessage.
13. Se estiver carregando o Salesforce Chat, selecione como os agentes e clientes são identificados:
    • Detecção automática: Detecte agentes, assistentes de bate-papo e visitantes automaticamente.
    • O primeiro participante é um agente: O primeiro participante do bate-papo será atribuído como um agente.
    • O primeiro participante é um cliente: O segundo participante do bate-papo será atribuído como um agente.
14. Selecione a versão API que você gostaria de usar.
15. Insira uma instrução SOQL personalizada para limitar os dados recuperados do Salesforce.
    
    Qdica: para recuperar dados de bate-papo, use o objeto LiveChatTranscript na consulta.
    Atenção: Não há suporte para GROUP BY.
    Exemplo: SELECT Id, CreatedDate, Body, ChatDuration FROM LiveChatTranscript.
16. Clique em Validate Query ( Validarconsulta) para testar sua declaração SOQL.
17. Se a validação for bem-sucedida, escolha o campo de data usado para identificar os dados a serem recuperados.
    Qdica: esta lista contém apenas os campos que estão presentes em sua consulta SOQL.
18. Clique em Avançar
19. Se necessário, ajuste seus mapeamentos de dados. Consulte a página de suporte do Mapeamento de dados para obter informações detalhadas sobre o mapeamento de campos no XM Discover. A seção Mapeamento de dados padrão contém informações sobre os campos específicos desse conector e a seção Mapeamento de campos de conversação aborda como mapear dados para dados de conversação.
    
20. Clique em Avançar.
21. Se desejar, você pode adicionar regras de substituição e redação de dados para ocultar dados confidenciais ou substituir automaticamente determinadas palavras e frases no feedback e nas interações do cliente. Consulte a página de suporte de Substituição e Redação de Dados.
    Qdica: clique em Download Amostra Data (Baixar dados de amostra ) para baixar um arquivo Excel com dados amostra para seu computador.
22. Clique em Seguinte.
23. Se desejar, você pode adicionar um filtro de conector para filtro os dados de entrada e limitar os dados importados.
    
24. Também é possível limitar o número de registros importados em um único trabalho inserindo um número na caixa Specify Record Limit (Especificar limite de registros ). Digite “All” se quiser importar todos os registros.
    Qdica: para dados de conversação, o limite é aplicado com base em conversações e não em linhas.
25. Clique em Seguinte.
26. Escolha quando você gostaria de ser notificado. Consulte Notificações de trabalho para obter mais informações.
    
27. Clique em Seguinte.
28. Escolha como os documentos duplicar são tratados. Consulte Tratamento de Duplicar para obter mais informações.
    
29. Selecione Schedule Incremental Runs (Agendar execuções incrementais ) se quiser que o trabalho seja executado periodicamente em uma programação ou Set Up One-Time Pull (Configurar execução única ) se quiser que o trabalho seja executado apenas uma vez. Consulte Agendamento de trabalhos para obter mais informações.
30. Clique em Seguinte.
31. Revise sua configuração. Se você precisar alterar uma configuração específica, clique no botão Edit (Editar ) para ser levado a essa etapa na configuração do conector.
32. Clique em Finish (Concluir ) para salvar o trabalho.

Mapeamento de dados padrão

Esta seção contém informações sobre os campos padrão dos trabalhos de entrada do Salesforce.

• natural_id: Um identificador exclusivo de um documento. É altamente recomendável ter um ID exclusivo para cada documento para processar as duplicatas corretamente. Para Natural ID, você pode selecionar qualquer campo de texto ou numérico de seus dados. Como alternativa, você pode gerar IDs automaticamente adicionando um campo personalizado.
• document_date: o campo de data primária associado a um documento. Essa data é usada nos relatórios, tendências e alertas XM Discover, entre outros. Por padrão, isso é mapeado para o campo de data selecionado após a especificação da consulta SOQL. Você pode escolher uma das seguintes opções:
  • CreatedDate (padrão): A data em que o objeto do Salesforce foi criado.
  • ClosedDate (para dados de chat): A data em que o caso foi fechado.
  • Se seus dados de origem contiverem outros campos de data, você poderá escolher um deles.
  • Você também pode definir uma data específica para o documento.
• feedback_provider: Identifica os dados obtidos de um provedor específico. Para uploads do Salesforce, o valor desse atributo é definido como “Salesforce” e não pode ser alterado.
• source_value: Identifica os dados obtidos de uma fonte específica. Isso pode ser qualquer coisa que descreva a origem dos dados, como o nome de uma pesquisa ou de uma campanha de marketing móvel. Por padrão, o valor desse atributo é definido como “Salesforce” Use transformações personalizadas para definir um valor personalizado, definir uma expressão ou mapeá-lo para outro campo.
• feedback_type: Identifica os dados com base em seu tipo. Isso é útil para a geração de relatórios quando o seu projeto contém diferentes tipos de dados (por exemplo, pesquisas e feedback de mídia social). Por padrão, o valor desse atributo é definido como “Relatório operacional”. Use transformações personalizadas para definir um valor personalizado, definir uma expressão ou mapeá-lo para outro campo.
• job_name: Identifica os dados com base no nome do trabalho usado para carregá-los. Você pode modificar o valor desse atributo durante a configuração por meio do campo Job Name (Nome do trabalho ), exibido na parte superior de cada página durante a configuração.
• loadDate: indica quando um documento foi carregado no XM Discover. Esse campo é definido automaticamente e não pode ser alterado.