Customer Experience
Employee Experience
Brand Experience
Core XM
Design XM

Integración con Qualtrics Social Connect

Acerca de la integración con Qualtrics Social Connect

La integración con Qualtrics Social Connect le permite consolidar y analizar todas las opiniones digitales de sus clientes en un solo lugar. A continuación, puede analizar sus datos utilizando cualquier método de análisis de Qualtrics, incluido Text iQ en un dashboard de CX.

Atención: Las características de codificación personalizadas se proporcionan tal cual y requieren conocimientos de programación para su implementación. El soporte técnico de Qualtrics no ofrece asistencia o consultoría sobre codificación personalizada. En su lugar, siempre puede preguntar a los usuarios especializados de nuestra comunidad. Si desea obtener más información sobre nuestros servicios de codificación personalizada, póngase en contacto con su Account Executive de Qualtrics.

Paso 1: Creación de la cabecera de autorización

En esta sección se explica cómo crear la cabecera de autorización para la integración. Necesitará esto para configurar la integración con Qualtrics Social Connect.

Vaya a Configuración de cuenta.
Vaya a la sección ID de Qualtrics de su cuenta y copie su token de API. Si ya tiene un token de API, no genere uno nuevo.
Anote su nombre de usuario de Qualtrics. Normalmente, esta es la dirección de correo electrónico que utiliza para iniciar sesión en Qualtrics. Si no conoce su nombre de usuario de Qualtrics, póngase en contacto con su administrador de organización.
Con su nombre de usuario de Qualtrics, construya una cadena de credenciales con el siguiente formato:
<Su nombre de usuario de Qualtrics>:<Su token de API de Qualtrics>.

Consejo Q: Si utiliza SSO para iniciar sesión en Qualtrics, asegúrese de incluir el componente # de su nombre de usuario.
Ejemplo: Un ejemplo de cadena de credencial es:
```
barnaby@qualtrics.com:63V9BuO9wMyvgo9HOf1OpeTOrhkvYGiRx1yMGrki
```
Codifique la cadena de credenciales con codificación base64. Puede utilizar cualquier codificador base64 en línea para lograrlo.
Ejemplo: Mi cadena de credencial codificada en base64 es:
```
YmFybmFieUBxdWFsdHJpY3MuY29tOjYzVjhCdU85V015dmcwOUlPZjFPcDhUT3Joa3ZZR2lSeDF5TUdaa2k=
```
Construya la cabecera de autorización en el siguiente formato: Básico <base64 codificado credenciales>. Tenga en cuenta el espacio entre “Básico” y las credenciales.
Ejemplo: Mi cabecera de autorización final es:
```
Basic YmFybmFieUBxdWFsdHJpY3MuY29tOjYzVjhCdU85V015dmcwOUlPZjFPcDhUT3Joa3ZR2lSeDF5TUdaa2k=
```

Necesitará esta credencial de autorización en la siguiente sección. Cópielo en algún lugar de fácil acceso.

Paso 2: Crear una automatización en Qualtrics Social Connect

Esta sección cubre la configuración inicial que deberá completar en Qualtrics Social Connect para configurar la integración. Para iniciar la configuración, primero deberá crear un workflow en Qualtrics.

Consejo Q: Para obtener ayuda con Qualtrics Social Connect, póngase en contacto con el equipo iniciando sesión en su cuenta de Qualtrics Social Connect, haciendo clic en el icono del perfil y seleccionando Contactar con soporte técnico.

Botón de asistencia técnica en su cuenta

En Qualtrics, vaya a Flujos de trabajo.
Haga clic en Crear un workflow y, a continuación, en Iniciado por un evento.
Seleccione el botón Evento JSON.
Haga clic en Copiar URL para copiar el extremo del evento. Necesitará este extremo del evento para completar la configuración en Qualtrics Social Connect. Guárdelo en algún lugar al que pueda acceder más tarde.
En una nueva pestaña del navegador, inicie sesión en Qualtrics Social Connect.
Consejo Q: Qualtrics Social Connect utiliza credenciales independientes de su cuenta de Qualtrics. Póngase en contacto con el equipo de soporte técnico de Social Connect si tiene preguntas sobre el acceso a Qualtrics Social Connect.
Vaya a Configuración de cuenta.
En la pestaña Resumen, seleccione Recetas de automatización.
En la sección En la actualización del caso, haga clic en Añadir receta de automatización.
Asigne un nombre a su receta de automatización.
Asegúrese de que se seleccione Mención en la sección Desencadenador y seleccione Se ha creado en el menú desplegable.
Haga clic en el signo más (+ ) para seleccionar uno o más temas para supervisar.
En la sección Filtro, configure las reglas de filtrado para las menciones que desea supervisar.
En la sección Acción, seleccione Desencadenar Webhook en el menú desplegable.
En el campo URL, pegue el punto final de evento que ha copiado en el paso 4.
En el campo Cabecera de autorización, pegue la cabecera de autorización que ha creado anteriormente.
Si utiliza una llamada API para recuperar etiquetas, active la opción Retraso. Se recomienda establecer un retraso mínimo de 10 minutos para garantizar que las etiquetas hayan tenido el tiempo de adjuntar a las menciones.
Haga clic en Añadir para completar la configuración.

Para probar la conexión, genere una nueva mención (la forma de generar la mención dependerá de su fuente, como crear un nuevo tweet o dejar un comentario). Como alternativa, puede esperar a la siguiente publicación cuando ocurra de forma natural. Una vez generada la nueva mención, abra el evento JSON en su workflow de Qualtrics y observe las propiedades JSON capturadas por el evento:

Consejo Q: Es posible que algunos de los campos devueltos por Qualtrics Social Connect deban limpiarse para poder utilizarlos en Qualtrics. Puede utilizar el campo stripped_content del objeto Mención para importar el campo sin formato HTML.

Paso 3: Crear el conjunto de datos de Qualtrics

Para guardar los datos en Qualtrics, debe crear un conjunto de datos de Qualtrics. Puede crear un conjunto de datos de Qualtrics llamando a la API de conjunto de datos directamente desde la línea de comandos.

Abra un editor de texto y construya el comando API. El formato general es el siguiente:

curl -X POST https://brandID.qualtrics.com/API/v3/datasets -H "Tipo de contenido: aplicación/json" -H "X-API-TOKEN: Su token de API de Qualtrics" -d '{

"nombre": "Elija un nombre para su conjunto de datos",

"primaryKey": "Seleccionar nombre de columna de ID",

"createProject": verdadero,

"campos": [

{

"nombre": "Mismo nombre de columna de ID que el anterior",

"tipo": "cadena"

}

]

}'

En el comando API anterior, debe sustituir los siguientes valores:
- brandID: Su ID de organización de Qualtrics.
- Su token de API de Qualtrics: su token de API.
- Seleccione un nombre para su conjunto de datos: Introduzca un nombre para darle al conjunto de datos.
- Elegir nombre de columna de ID: Especifique el nombre de campo que contendrá la clave de identificación de su proyecto. Recomendamos utilizar “uniqueId”.
Abra la terminal en su ordenador y pegue el comando. Pulse Intro para ejecutar el comando.

Copie el ID de conjunto de datos del resultado. Necesitará esto más tarde. El resultado de la llamada API tendrá el siguiente formato:

{"result":{"name":"","primaryKey":"","datasetId":"ID de conjunto de datos, esto es lo que debe copiar","fields":[]},"meta":{"requestId":"","httpStatus"}:"OK":"200"

Una vez creado el conjunto de datos, estará disponible en la página Proyectos de Qualtrics como un proyecto de datos importado. Haga clic en el proyecto para abrirlo.
Después de abrir su proyecto de datos importados, puede utilizar el editor de campos en la pestaña Datos y análisis para añadir los campos que desea importar de Social Connect. Consulte Campos comunes de conexión social para obtener más información sobre los campos que tiene a su disposición. Al añadir sus campos, le recomendamos que los guarde como un tipo de texto abierto en su conjunto de datos.

Paso 4: Completar el flujo de trabajo

Ahora que ha establecido una conexión con Qualtrics Social Connect y ha creado su conjunto de datos, ha llegado el momento de asignar datos de Qualtrics Social Connect a su conjunto de datos.

Abra el workflow que ha creado anteriormente.
Haga clic en el signo más (+) y seleccione Tarea.
Seleccione el botón Servicio web tarea.
Seleccione Servicio Web autenticado.
Haga clic en Siguiente.
Haga clic en Añadir una cuenta de usuario.
Asigne un nombre a su cuenta. Esto es para sus propios fines organizativos.
Seleccione OAuth para el tipo de conexión.
Seleccione Credenciales de cliente para el tipo de concesión.
Introduzca su ID de cliente y secreto de cliente. Consulte OAuth de API para obtener más información sobre cómo crearlos.
Pegue la siguiente URL en el punto de acceso de token: https://BrandID.DatacenterID.qualtrics.com/oauth2/token
- Sustituya el texto en negrita anterior por los ID correspondientes:
- BrandID: su ID de organización de Qualtrics.
- DatacenterID: su ID de centro de datos de Qualtrics.
Haga clic en Conectar cuenta.
Seleccione la cuenta que acaba de añadir.
Haga clic en Siguiente.
Seleccione POST para el tipo de solicitud.
Introduzca la URL en el siguiente formato:
```
https://brandID.qualtrics.com/API/v3/datasets/DatasetID/data
```
Donde brandID es su ID de organización de Qualtrics y DatasetID es el ID del conjunto de datos que copió anteriormente.
En la sección Cabeceras, añada Autorización como clave.
Para el Valor, introduzca Portador y añada un espacio final.
Haga clic en el icono de texto dinámico, {a}, y seleccione su cuenta QSC.
En la sección Cuerpo, seleccione pares de clave-valor JSON y comience a asignar sus campos. Para la Clave, introduzca el nombre de campo. Para el valor, utilice el texto dinámico para seleccionar el campo que proviene directamente del evento JSON. La sección Campos comunes de conexión social tiene el código de texto dinámico para los datos no transformados de Social Connect.
Cuando termine, haga clic en Guardar.

Paso 5: Analizar los datos de conexión social de Qualtrics

En esta sección se explica cómo analizar sus datos de Qualtrics Social Connect en dashboards de CX y Text iQ.

Visualización de datos de conexión social en dashboards de CX

Cree un nuevo dashboard en un proyecto de dashboard de CX.
Haga clic en Añadir fuente, pase el ratón por encima de Fuentes de datos externas y, a continuación, seleccione el proyecto que contiene sus datos de conexión social.
Ajuste los tipos de campo para sus campos importados. Consulte Campos comunes de conexión social para obtener más información sobre el tipo de campo sugerido para cada campo de conjunto de datos.
Guarde las modificaciones cuando haya terminado.

La edición del dashboard es la misma que la edición de cualquier dashboard de CX. Consulte las siguientes páginas de soporte técnico para obtener más información:

Uso de Text iQ

Le recomendamos que utilice Text iQ en su dashboard de CX. Esto garantizará que todos sus datos se encuentren en un solo lugar y que los campos de Text iQ se asignarán automáticamente a su dashboard si los analiza a través del dashboard. Cuando esté listo para empezar, haga clic en el botón Analizar en Text iQ de su dashboard.

La mayoría de los campos de mención no son útiles para el análisis de texto (por ejemplo, autor, fuente, ID, etc.). Al seleccionar los datos para importar a Text iQ, asegúrese de seleccionar el campo de contenido del mensaje.

El uso de Text iQ para datos de conexión social funciona de la misma manera que el análisis del texto de respuesta de la encuesta en Qualtrics. Consulte las siguientes páginas de soporte técnico para obtener más información:

Importación de enriquecimientos de XM Discover

Consejo Q: Si aún no ha configurado Descubrir modelos de categoría, se utilizarán los modelos de categoría predeterminados. Consulte la página de soporte Descubrir para obtener más información sobre los modelos de categoría predeterminados.

En esta sección se explica cómo importar enriquecimientos de XM Discover a su conjunto de datos. Aunque no es obligatorio integrarlo con Qualtrics Social Connect, XM Descubra los enriquecimientos que le ayudan a analizar las menciones en tiempo real etiquetándolas en función del contenido de la mención.

En Conexión social, vaya a Etiquetas.
Haga clic en Añadir XM Descubrir Enriquecimiento.
Seleccione los temas para los que desea añadir enriquecimientos.
Haga clic en Siguiente.
Seleccione los modelos de categoría que desea utilizar.
Consejo Q: Hay un límite de 2 categorías por tema. Si necesita más información, póngase en contacto con el equipo de Social Connect iniciando sesión en su cuenta de Qualtrics Social Connect, haciendo clic en el icono del perfil y seleccionando Contactar con soporte técnico.
.
Para Enriquecimiento en tiempo real, seleccione Sí.
Atención: Si no habilita el enriquecimiento en tiempo real, los enriquecimientos de XM Discover se procesarán con un retraso de 7 o más minutos después de que se cree la mención en Social Connect y, por lo tanto, las etiquetas correspondientes no estarán disponibles en su flujo de trabajo de Qualtrics.
Haga clic en Guardar.

Vuelva a su flujo de trabajo en Qualtrics. Asegúrese de asignar sus campos en su flujo de trabajo de Qualtrics para guardar los enriquecimientos de XM Discover en su conjunto de datos de Qualtrics. Se guardan como el campode etiquetas.

Dado que XM Discover Enrichments se exporta como una lista separada por comas, tendrá que especificar el delimitador de campo en su panel de instrucciones utilizando el editor de recodificación. Asegúrese de seleccionar Coma como delimitador. También puede cambiar el nombre de los campos con el editor de recodificación para que sean más fáciles de visualizar en el dashboard.

Campos comunes de conexión social

Esta sección contiene una tabla de campos de uso habitual de Social Connect, su código de texto dinámico para crear la asignación, el tipo de campo que debe guardarlos como en Qualtrics y cualquier nota especial sobre el campo.

Nombre de campo de conjunto de datos	Ruta de texto dinámico (para asignación de flujo de trabajo)	Tipo de campo de dashboard	Descripción y notas especiales
ID	~{aed://id}	Valor del texto	Identificador específico de Qualtrics Social Connect para esta mención (único por tema).
ID unívoco	~{aed://unique_id}	Valor del texto	Identificador específico de conexión social de Qualtrics para esta mención.
Nombre autor.	~{aed://author.name}	Valor del texto	Nombre de usuario o identificador del autor de la mención.
authorFullname	~{aed://author.fullname}	Valor del texto	Nombre completo del autor de la mención.
ID autoriz.	~{aed://author.id}	Valor del texto	Identificador específico de servicio del autor (p. ej., UID de Twitter)
nombre de autorización original	~{aed://original_author.name}	Valor del texto	Nombre de usuario o identificador del autor original de la mención. (En caso de que se trate de un retuit, repin,…)
nombre completo de autorización original	~{aed://original_author.fullname}	Valor del texto	Nombre completo del autor original de la mención.
originalAuthorId	~{aed://original_author.id}	Valor del texto	Identificador específico de servicio del autor original (p. ej., UID de Twitter).
messageTitle	~{aed://message.title}	Texto libre
messageContent	~{aed://message.content}	Texto libre	El contenido está en formato HTML. Es posible que desee utilizar una tarea de código para eliminar cualquier HTML o emojis.
messageLanguage	~{aed://message.language}	Conjunto de texto	Código de idioma ISO 639-1 del idioma en el que se encuentra este mensaje.
messageSentiment	~{aed://message.sentiment}	Conjunto de texto	Cualquiera de positivo, negativo, neutral o no fijado.
messageType	~{aed://message.type}	Conjunto de texto	Tipo de mensaje. Valores posibles: “post”, “privatemessage”, “video”, “check in”, “foto”, “texto”, “cita”, “enlace”, “chat”, “audio”, “correo electrónico”, “revisión”, “aplausos”, “como”, “retweet”, “compartido”, “repin”, “usuario_favorito”, “reblog”, “compromiso”, “respuesta”, “otro” “comentario”, “pregunta”, “otro”, “pregunta”, “otro”, “pregunta”, “otro”, “pregunta”
sourceCategory	~{aed://source.category}	Conjunto de texto	Categoría en la que se puede clasificar esta mención. Valores posibles: “social”, “social_videos”, “social_fotos”, “microblogs”, “foros”, “blogs”, “podcasts”, “comentarios”, “noticias”, “noticias_académicas”, “noticias_consumidor”, “noticias_corporativas”, “ventas_gobierno”, “news_journal”, “noticias_locales”, “noticias_nacionales”, “noticias_organizaciones”, “noticias_org”, “noticiares_productos” “noticieros”, “noticios_productos”, “noticias_productos”, “noticias_periodicos”, “noticias_productos”, “noticias_periodicos”, “noticios_productos”, “noticias_periodicos”, “noticias_productos”, “noticias_periodicos”, “noticias_productos”, “noticias_periodicos”, “noticias_periodicos”, “noticias_productos”, “noticias_periodicos”, “noticias_productos”, “noticias_periodicos”, “noticias_productos”, “noticias_periodicos”, “noticias_productos”, “noticias_periodismo”, “noticiares_productos”
ServicioOrigen	~{aed://source.service}	Conjunto de texto	De qué fuente de “servicio conectado” proviene la mención. Valores posibles: “twita_facebook”, “facebook_ads”, “foursquare_place”, “googleplus”, “instagram”, “instagram_hashtag”, “instagrament_ads”, “blyrimeum”, “telegryping_group”, “pinterest”, “youblog”, “blytrimeum”, “telammecompany”,
TipoOrigen	~{aed://source.type}	Conjunto de texto	De qué fuente proviene la mención. (Nombre interno para filtrar.) Valores posibles: “YouchProviderProvider”SearchProviderProvider”SearchProvider”SearchProvider” SearchProvider”SearchProvider”SearchProvider”SearchProvider” “SearchProvider”
ID de origen	~{aed://source.id}	Valor del texto	Identificación de este mensaje en el servicio del que es. (Por ejemplo, el ID de tuit para un mensaje de Twitter).
sourceUrl	~{aed://source.url}	Valor del texto	La URL del mensaje en el servicio del que es. (Por ejemplo, el enlace al comentario en el propio Facebook).
ubicationContinent	~{aed://location.continente}	Conjunto de texto	Código de continente.
ubicationCountry	~{aed://location.country}	Conjunto de texto	Código de país ISO 3166-1.
LocationCity	~{aed://location.city}	Valor del texto	Nombre completo de la ciudad.
LocationRegion	~{aed://location.region}	Valor del texto
etiquetas	~{aed://tags}	Conjunto de textos de varias respuestas	Matriz de cadenas; etiquetas (inteligentes) agregadas a esta mención.
ID de tema	~{aed://topic.id}	Valor del texto
topicName	~{aed://topic.name}	Valor del texto
estado	~{aed://status}	Conjunto de texto	El estado corresponde a la etapa del workflow en la que se encuentra actualmente una mención/caso. Valores posibles: “hecho”, “pendiente”, “nuevo”.
tinta permaliciosa	~{aed://permalink}	Valor del texto	URL específica de Qualtrics Social Connect única para esta mención.
fecha añadida	~{aed://date.added}	Valor del texto	Sello de fecha UNIX (en UTC) del momento en que Qualtrics Social Connect indexó la publicación. Si utiliza este campo, querrá utilizar una tarea de código para transformar la fecha en un formato más fácil de usar. Como alternativa, puede utilizar la Fecha registrada predeterminada que se creará cuando se importe la publicación en Qualtrics, ya que la fecha y hora serán aproximadamente las mismas.
fecha publicada	~{aed://date.publish}	Valor del texto	Cronomarcador UNIX (en UTC) de cuándo se publicó la publicación. Probablemente desee utilizar el texto dinámico de la tarea Código con fecha formateada.
prioridad	~{aed://Priority}	Conjunto de texto
etiquetas		Conjunto de textos de varias respuestas	Matriz de cadenas; etiquetas (inteligentes) agregadas a esta mención. Los datos de etiquetas inteligentes no se envían a través de webhooks. No estará en el payload del objeto Mención. Solo se pueden recuperar mediante una llamada API.

Muchas de las páginas de este sitio han sido traducidas del inglés original utilizando la traducción automática. Aunque en Qualtrics hemos realizado nuestra diligencia debida para obtener las mejores traducciones automáticas posibles, la traducción automática nunca es perfecta. El texto original en inglés se considera la versión oficial, y cualquier discrepancia entre el inglés original y las traducciones automáticas no son legalmente vinculantes.