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
Consejo Q: Se requiere el permiso “Gestionar trabajos” para utilizar esta función.
- En la página Jobs, haga clic en Job nuevo.
- Select LivePerson.
- Asigne un nombre a su trabajo para que pueda identificarlo.
- Seleccione el proyecto en el que desea cargar los datos.
- Dele una descripción a su trabajo para que conozca su propósito.
- Haga clic en Siguiente.
- 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. Puede introducir un valor entre 1 y 100 días.
- Fecha de vencimiento: establezca la fecha en la que vencerán las credenciales. Haga clic en la casilla para abrir un calendario para elegir la fecha.
- Haga clic en Siguiente.
- 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.
- Haga clic en Siguiente.
- Si es necesario, ajuste sus asignaciones de datos. Consulte la página de soporte Asignación de datos para obtener información detallada sobre los campos de asignación en 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.
- Haga clic en Siguiente.
- Si lo desea, puede añadir reglas de sustitución y edición de datos para ocultar datos confidenciales o sustituir automáticamente determinadas palabras y frases en los comentarios y las interacciones del 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. - Haga clic en Siguiente.
- Si lo desea, puede añadir un filtro de conector para filtrar los datos entrantes para limitar los datos que se importan.
- También puede limitar el número de registros importados en un solo job introduciendo un número en el cuadro Especificar límite de registros. Introduzca “Todos” si desea importar todos los registros.
Consejo Q: Para los datos conversacionales, el límite se aplica en función de las conversaciones en lugar de las filas.
- Haga clic en Siguiente.
- Elija cuándo desea que se le notifique. Consulte Notificaciones de job para obtener más información.
- Haga clic en Siguiente.
- Seleccione cómo se gestionan los documentos duplicados. Consulte Tratamiento de duplicados para obtener más información.
- Seleccione Programar ejecuciones incrementales si desea que el job se ejecute periódicamente en una programación o Configurar pull único si desea que el job se ejecute solo una vez. Consulte Programación de jobs para obtener más información.
- Haga clic en Siguiente.
- Revise su configuración. Si necesita cambiar una configuración específica, haga clic en el botón Editar para ir a ese paso en la configuración del conector.
- Haga clic en Finalizar para grabar el job.
Asignación de datos predeterminados
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: un identificador único de un documento. Se recomienda encarecidamente tener un ID único para cada documento para procesar duplicados correctamente. Para el ID natural, puede seleccionar cualquier campo de texto o numérico de sus datos. Como alternativa, puede generar automáticamente ID añadiendo un campo personalizado.
- document_date: el campo de fecha principal asociado a un documento. Esta fecha se utiliza en informes, tendencias, alertas, etc. de XM Discover. 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.
- También puede fijar una fecha de documento específica.
- feedback_provider: identifica los datos obtenidos de un proveedor 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. Puede ser cualquier cosa que describa el origen de los datos, como el nombre de una encuesta o una campaña de marketing móvil. By default, this attribute’s value is set to “LivePerson.” Utilice transformaciones personalizadas para establecer un valor personalizado, definir una expresión o asignarla a otro campo.
- feedback_type: identifica los datos en función de su tipo. Esto es útil para la generación de informes cuando su proyecto contiene diferentes tipos de datos (por ejemplo, encuestas y opiniones de medios sociales). By default, this attribute’s value is set “Messaging Platform”. Utilice transformaciones personalizadas para establecer un valor personalizado, definir una expresión o asignarla a otro campo.
- job_name: identifica los datos según el nombre del job utilizado para cargarlos. Puede modificar el valor de este atributo durante la configuración mediante el campo Nombre del trabajo que se muestra en la parte superior de cada página durante la configuración.
- loadDate: indica cuándo se cargó un documento en XM Discover. Este campo se fija automáticamente y no se puede modificar.