-
Qualtrics Platform -
Customer Journey Optimizer -
XM Discover -
Qualtrics Social Connect
Introducción a la API de Qualtrics
Acerca de la API de Qualtrics
La API de Qualtrics se puede utilizar para automatizar procesos repetitivos en Qualtrics o para importar información a Qualtrics o exportarla. Por ejemplo, un Administrador de organización puede utilizar la API de Qualtrics para automatizar el proceso de creación de cuentas en lugar de crear cientos de cuentas de forma individual. Del mismo modo, un usuario puede automatizar la creación de listas de contactos, en lugar de compilarlas e importarlas de forma manual. Qualtrics también cuenta con varias guías de soluciones para la API que pueden ayudarle a determinar la mejor manera de utilizar la API según sus necesidades.
Acceso a la API para distintos productos
Qualtrics dispone de una variedad de productos que le permiten recopilar datos procesables en tiempo real. Algunos de estos productos incluyen Survey Platform, Site Intercept y XM Directory (audiencia objetivo). Una vez que haya adquirido la función API de Qualtrics, podrá usarla para cualquier producto que forme parte de su licencia.
A continuación, se muestran los enlaces a la documentación de la versión más reciente de la API para cada uno de nuestros productos:
- Para conocer las API más recientes para la mayoría de los productos, consulte la API de Qualtrics
- Site Intercept
Tenga en cuenta que siempre recomendamos que nuestros clientes utilicen la versión más reciente de la API.
Explicación acerca de la API de Qualtrics v3
La API de Qualtrics v3 es una API REST que le permite comunicarse con nuestro sistema o consultarlo mediante una sintaxis simple de URL. La comunicación con el sistema de Qualtrics se puede considerar una secuencia de solicitudes. Puede solicitar que la información se envíe a Qualtrics, se actualice, se elimine o se devuelva a su sistema. Estas solicitudes se pueden realizar mediante solicitudes GET, POST, PUT o DELETE, que devuelven respuestas en formato JSON.
Con estos métodos, la API de Qualtrics le permite interactuar con partes del sistema de Qualtrics e integrar estas áreas con su CRM (plataforma de gestión de relaciones con clientes).
Introducción
Parámetros de aprobación
Los parámetros son la base fundamental de sus solicitudes. Todas las solicitudes de API requieren que se transfieran varios parámetros globales a Qualtrics, así como parámetros más específicos de la solicitud y algunos opcionales.
Siempre tendrá que indicar el token de la API a través del encabezado de la solicitud, como X-API-TOKEN. En función de la solicitud específica que se esté ejecutando, es posible que deba indicar otros parámetros a través del encabezado, de la URL o del cuerpo de la solicitud. Cuando indique parámetros a través del cuerpo, deberá enviarlos como JSON. Cuando utilice este método, deberá especificar un tipo de contenido, es decir: application/json o multipart/form-data.
Ejemplo: En el siguiente ejemplo POST, en cURL, especificamos la URL base, el tipo de contenido y el token en el encabezado. El ID de encuesta y el formato de exportación se especifican en el cuerpo.
curl -X POST -H 'X-API-TOKEN: aquíeltokenAPI' -H 'Content-Type: application/json' -d ''{
"surveyId": "SV_012345678912345",
"format": "csv"
}'' 'https://eliddesucentrodedatos.qualtrics.com/API/v3/responseexports'
Generación de un token de API
Se requerirá un token de API para acceder a la API de Qualtrics. Cada usuario de una licencia debe generar su propio token de API. Se necesita el token de API de su cuenta para autenticar cada solicitud de API que cree. Se utiliza su token, en lugar de la contraseña de su cuenta, lo cual ayuda a mejorar la seguridad de su trabajo. Para autenticarse, incluya el token en el encabezado HTTPS X-API-TOKEN.
Cómo generar un token de API
- Haga clic en el ícono de configuración de usuario en la esquina superior derecha de su cuenta.
- Seleccione Configuración de cuenta.
- Haga clic en ID de Qualtrics en la barra de navegación.
Atención: Se rediseñó la configuración de cuenta. Para ver los ID de Qualtrics, haga clic en Cambiar a la versión anterior.
- En el cuadro con la etiqueta API, haga clic en Generar token.
Creación de un secreto de cliente
- Haga clic en el ícono de configuración de usuario en la esquina superior derecha de su cuenta de Qualtrics.
- Seleccione Configuración de cuenta.
- Diríjase a los ID de Qualtrics.
Atención: Se rediseñó la configuración de cuenta. Para ver los ID de Qualtrics, haga clic en Cambiar a la versión anterior. - Seleccione Administrador de cliente de OAuth.
- Haga clic en Crear cliente.
- Introduzca un nombre de cliente.
- Si lo desea, introduzca una dirección de correo electrónico de contacto.
- Para Tipo de adjudicación, seleccione Credenciales del cliente.
- Haga clic en Crear cliente.
- Anote el ID de cliente y el secreto de cliente y guárdelos en una ubicación segura.
Atención: Una vez que sale de esta ventana, el secreto de cliente es irrecuperable. Si pierde u olvida su secreto de cliente, deberá repetir el proceso anterior para generar uno nuevo.
Protocolo de contexto de modelo
El protocolo de contexto del modelo (MCP) es un estándar de código abierto para conectar aplicaciones de IA a sistemas externos. Muchas aplicaciones modernas de IA (por ejemplo, ChatGPT, Claude, Cursor) aprovechan el MCP para facultar a sus usuarios.
Qualtrics proporciona un servidor de MCP para cada una de las API documentadas en nuestro sitio de API. Cada servidor expone una herramienta de MCP para un punto acceso de API que se documenta aquí. Todas las API basadas en JSON son compatibles. Por el momento, no se permiten API que no sean compatibles con JSON.
Por ejemplo, puedes utilizar MCP de Qualtrics para crear agentes de IA que utilicen la API de Qualtrics para consultar las tasas de respuesta, o puedes utilizar la API de Qualtrics para actualizar los contactos de clientes en XM Directory.
Consulta la guía de MCP en nuestro sitio de API para obtener más información sobre cómo aprovechar esta capacidad.