LivePerson Inbound Connector
About the LivePerson Inbound Connector
You can use the LivePerson inbound connector to load chats and messages from your LivePerson account into XM Discover.
Required Setup in LivePerson
To connect XM Discover to LivePerson, you will need the following information about your LivePerson account:
- Your LivePerson account ID
- If using OAuth 2.0, your LivePerson username and password
- If using API keys, your LivePerson API security tokens
Qtip: For more information, please see the LivePerson documentation.
Setting Up a LivePerson Inbound Job
Qdica: a permissão “Gerenciar tarefas” é necessária para usar esse recurso.
- Na página Trabalhos, clique em Novo trabalho.
- Select LivePerson.
- Dê um nome ao seu job para poder identificá-lo.
- Selecione o projeto para o qual os dados devem ser carregados.
- Dê uma descrição ao seu cargo para que você saiba o seu objetivo.
- Clique em Seguinte.
- Choose a LivePerson account to use, or select Add New to add a new one.
- If adding a new account, give the connection a name so you can identify it.
- Choose between Oauth 2.0 and API Key as the authorization mode.
- If you’re using Oauth, enter the following information:
- LivePerson Username: Your LivePerson username.
- LivePerson Password: Your LivePerson password.
- Account ID: Your LivePerson account ID.
- If you’re using an API key, enter the following information:
- LivePerson App Key: Your LivePerson app key.
- LivePerson App Secret: Your LivePerson app secret.
- LivePerson Token: Your LivePerson token.
- LivePerson Token Secret: Your LivePerson token secret.
- Account ID: Your LivePerson account ID.
- 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.
- Clique em Seguinte.
- Select the type of data to upload from LivePerson.
- Chat: Upload chat transcripts and related data.
- Message: Upload contact center messaging interactions. Only closed messages are imported.
- Clique em Seguinte.
- 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.
- Clique em Seguinte.
- 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. - Clique em Seguinte.
- Se desejar, você pode adicionar um filtro de conector para filtrar os dados de entrada a fim de limitar quais dados são importados.
- 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.
- Clique em Seguinte.
- Escolha quando você deseja ser notificado. Consulte Notificações de job para mais informações.
- Clique em Seguinte.
- Escolha como os documentos duplicados são tratados. Consulte Tratamento de duplicados para obter mais informações.
- 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.
- Clique em Seguinte.
- 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.
- Clique em Concluir para salvar o trabalho.
Mapeamento de dados padrão
Attention: As field names are case-sensitive in Connectors, the first letter of the field name must be upper-case as displayed in the Data Sample to ensure data mappings are accurate and the job succeeds.
This section contains information on the default fields for LivePerson inbound jobs.
- richVerbatim: Verbatim for conversational data. This field includes sub-fields to track the client’s and representative’s side of the conversation.
Qtip: Transformations are not supported for conversational verbatim fields.
- clientVerbatim: Identifies data from the client’s side of a conversation. By default this field is mapped to “clientVerbatimChat” for digital interactions, and to “clientVerbatimCall” for call interactions.
- agentVerbatim: Identifies data from the representative’s side of a conversation. By default this field is mapped to “agentVerbatimChat” for digital interactions, and to “agentVerbatimCall” for call interactions.
- unknown: Identifies data from the unknown side of a conversation. By default this field is mapped to “unknownVerbatimChat” for digital interactions, and to “unknownVerbatimCall” for call interactions.
- 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.
- 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. You can choose one of the following options:
- chatRequestedTime: The time the chat was requested.
- interactiveTime: The time when the CoBrowse session became interactive.
- startTime (default): Conversation start time.
- endTime: Conversation end time.
- Você também pode definir uma data específica do documento.
- feedback_provider: identifica dados obtidos de um provedor específico. For LivePerson documents, this attribute’s value is set to “LivePerson” and cannot be changed.
- source: Identifies data obtained from a specific source. 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 “LivePerson.” 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 “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.