Zendesk Inbound Connector

About the Zendesk Inbound Connector

You can use the Zendesk inbound connector to load chat data from Zendesk into XM Discover.

Setting up a Zendesk Inbound Job

1. Na página Trabalhos, clique em Novo trabalho.
   
2. Selecione Zendesk.
   
3. Dê um nome ao seu job para poder identificá-lo.
   
4. Selecione o projeto para o qual os dados devem ser carregados.
5. Dê uma descrição ao seu cargo para que você saiba o seu objetivo.
6. Clique em Seguinte.
7. Choose the Zendesk account to use, or select Add New to add a new one.
   
8. If adding a new account, enter the following information about your Zendesk account:
   • Connection Name: Give the connection a name so you can identify it.
   • Zendesk Email: The email address for your Zendesk account.
   • Zendesk API token: Your Zendesk account API token.
   • Zendesk Host: Your Zendesk subdomain.
9. If you want your credentials to expire, then configure the following options:
   • Send Expiration Notifications: Select this option to allow your credentials to expire.
   • Days prior expiration: If enabling expiration notifications, enter how many days you’d like to be notified before the expiration. Você pode inserir um valor entre 1 e 100 dias.
   • Data de vencimento: defina a data em que as credenciais expirarão. Clique na caixa para abrir um calendário e selecionar a data.
10. Clique em Seguinte.
11. Choose the data type you want to import into XM Discover:
    
    • Process Chat Tickets as conversations: Zendesk chat tickets are imported as conversations.
    • Process All Tickets as documents: All Zendesk tickets are imported as documents.
12. You can choose whether you want to include unfinished tickets in the upload. Select the Process only closed tickets option to upload only closed tickets. Deselect this option to upload both closed and open tickets.
13. Clique em Seguinte.
14. Se necessário, ajuste seus mapeamentos de dados. Consulte a página de suporte Mapeamento de dados para obter informações detalhadas sobre campos de mapeamento no XM Discover. The Default Data Mapping section has information on the fields specific to this connector and the Mapping Conversational Fields section covers how to map data for conversational data.
15. Clique em Seguinte.
16. Se desejar, você pode adicionar regras de substituição e ocultação de dados para ocultar dados confidenciais ou substituir automaticamente determinadas palavras e frases no feedback e nas interações do cliente. See the Data Substitution and Redaction support page.
    
    Qtip: Click Download Sample Data to download an Excel file with sample data to your computer.
17. Clique em Seguinte.
18. Se desejar, você pode adicionar um filtro de conector para filtrar os dados de entrada a fim de limitar quais dados são importados.
    
19. Você também pode limitar o número de registros importados em um único job inserindo um número na caixa Indicar limite de registros. Insira “Todos” se quiser importar todos os registros.
    Qdica: Para dados conversacionais, o limite é aplicado com base em conversas em vez de linhas.
20. Clique em Seguinte.
21. Escolha quando você deseja ser notificado. Consulte Notificações de job para mais informações.
    
22. Clique em Seguinte.
23. Escolha como os documentos duplicados são tratados. Consulte Tratamento de duplicados para obter mais informações.
    
24. Selecione Programar execuções incrementais se você quiser que seu job seja executado periodicamente em uma programação ou Configurar pull único se quiser que o job seja executado somente uma vez. Consulte Escalonamento do job para mais informações.
25. Clique em Seguinte.
26. Revise sua configuração. Se você precisar modificar uma configuração específica, clique no botão Editar para ir para essa etapa na configuração do conector.
27. Clique em Concluir para salvar o trabalho.

Mapeamento de dados padrão

This section contains information on the default fields for Zendesk inbound jobs.

• natural_id: Um identificador exclusivo de um documento. É altamente recomendado ter um ID único para cada documento para processar duplicados corretamente. Para ID natural, você pode selecionar qualquer campo de texto ou numérico a partir de seus dados. Como alternativa, você pode gerar IDs automaticamente adicionando um campo personalizado. By default, XM Discover uses source IDs prefixed by the connector’s name via a custom transformation:Natural ID = Connector-name;Source-ID.
• document_date: o campo de data principal associado a um documento. Esta data é usada em relatórios, tendências, alertas do XM Discover e assim por diante. By default, this is mapped to the date field selected after specifying the SOQL query. You can choose one of the following options:
  • updated_at (default): Date and time when the chat activity was most recently updated.
  • created_at: Date and time when the chat activity was created.
  • Você também pode definir uma data específica do documento.
• feedback_provider: identifica dados obtidos de um provedor específico. For Zendesk uploads, this attribute’s value is set to “Zendesk” and cannot be changed.
• source_value: identifica 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 uma campanha de marketing móvel. By default, this attribute’s value is set to “Zendesk.” Use transformações personalizadas para definir um valor personalizado, definir uma expressão ou mapeá-la para outro campo.
• feedback_type: Identifica dados com base em seu tipo. Isso é útil para relatórios quando seu projeto contém diferentes tipos de dados (por exemplo, pesquisas e feedback de mídias sociais). By default, this attribute’s value is set to “Messaging Platform”. Use transformações personalizadas para definir um valor personalizado, definir uma expressão ou mapeá-la para outro campo.
• job_name: identifica dados com base no nome do trabalho usado para carregá-lo. Você pode modificar o valor deste atributo durante a configuração por meio do campo Nome do job que é exibido na parte superior de cada página durante a configuração.
• loadDate: indica quando um documento foi carregado no XM Discover. Este campo é definido automaticamente e não pode ser modificado.