Plantilla de artículo

Acerca de las preguntas más frecuentes API

Qualtrics tiene una variedad de productos diferentes que permiten a nuestros clientes recopilar datos procesables en tiempo real. Algunos de estos productos incluyen la plataforma de Encuesta , Opinión sobre el sitio web/de la aplicación, XM Directory y Qualtrics 360. Una vez que haya adquirido la función API de Qualtrics, podrá usar la API para cualquier producto que forme parte de su licencia.

• Documentación de la API para la plataforma de Encuesta y el XM Directory.
• Documentación de la API para Opinión sobre el sitio web/de la aplicación.

Plataforma de la encuesta

Tengo todos los parámetros correctos, pero sigo recibiendo un mensaje de error que dice “Solicitud no válida. “Solicitud de parámetro faltante o no válida.” ¿Por qué sucede esto?

Ejemplo:

curl -X POST \ https: qualtrics.com/ API/v3/responseexports \  
-H 'tipo-contenido: aplicación/ json' \ -H 'x-api-token: 12345678901234567890' \  
-d '{"surveyId": "SV_1234567890", "Formato": "json"}'

Los parámetros de la API de Qualtrics distinguen entre mayúsculas y minúsculas. En este ejemplo, su parámetro se llama “Formato” cuando debería ser “formato”. Actualice esto y podrá ejecutar con éxito su solicitud de API .

Me gustaría descargar mis datos sin procesar para abrirlos en Excel. ¿Qué solicitud API debo utilizar?

Querrás utilizar el Crear respuesta de exportación solicitud para iniciar el proceso de exportación y especificar que el formato del archivo de exportación de respuesta debe ser CSV. Luego, necesitarás usar el Progreso de la exportación de Get Response solicitud para verificar si el archivo está listo, seguido de la Archivo de exportación de Get Response solicitud para descargar su archivo CSV .

Al utilizar la función Crear importación de contactos, ¿cuáles son los diferentes métodos para publicar o enviar mi lista de contactos a Qualtrics?

Hay dos opciones para cargar su lista de contactos:

1. Puede configurar el tipo de contenido en multiparte/datos de formulario y cargue sus contactos como un archivo JSON .
2. Puede configurar el tipo de contenido en aplicación/ json y publicar los contactos como una matriz JSON en el cuerpo de la solicitud.

¿Estoy limitado en el número de solicitudes que puedo realizar para mi organización? ¿Y cuántas solicitudes de API simultáneas puedo realizar a la vez?

Mira esto Página API para obtener más información sobre los límites.

Estoy utilizando la solicitud de importación de Encuesta y he guardado mi encuesta como un archivo TXT . La solicitud se realizó correctamente, pero mis preguntas no aparecen en la encuesta recién importada. ¿Por qué sucede esto?

Deberá asegurarse de seguir el formato necesario para importar encuestas a Qualtrics. Para obtener más información sobre el formato TXT , consulte Preparación de un archivo TXT en formato simple y Preparación de un archivo TXT en formato avanzado. Una vez que su archivo esté formateado correctamente, la solicitud se ejecutará correctamente.

Estoy utilizando la solicitud de exportación de creación de respuesta con los parámetros startDate y endDate. Sin embargo, cuando miro los datos descargados, no veo el rango de fechas de respuestas previsto.

La clave para usar los parámetros startDate y endDate es comprender qué valor de fecha se está utilizando para evaluar la condición que estás creando (es decir, qué fechas se están mirando para evaluar la startDate que estableces y la endDate que estableces). Estos dos parámetros utilizan la fecha en que el participante inició la encuesta. Este valor, llamado Fecha de inicio, se puede encontrar en la pestaña Datos y análisis y en los datos descargados. Entonces, si establece el parámetro startDate en 2017-01-01 y el parámetro endDate en 2017-01-02, descargará las respuestas que se hayan registrado (enviadas o incompletas) para los participantes de la encuesta que comenzaron su encuesta dentro del rango de fechas del 1 de enero de 2017 al 2 de enero de 2017.

Consejo Q: Una respuesta de la encuesta no se registra hasta que el participante hace clic en el botón de enviar dentro de una encuesta o cuando el respuestas incompletas de la encuesta El plazo se ha cumplido.

Opinión sobre el sitio web/de la aplicación

Para preguntas Opinión sobre el sitio web/de la aplicación , contacto con nuestro equipo de soporte Opinión sobre el sitio web/de la aplicación.

XM Directory

¿Puedo usar la API de Encuesta Platform ahora que también estoy usando XM Directory ?

Sí, absolutamente. El XM Directory tiene algunas solicitudes de API que reemplazarán las solicitudes realizadas a través de la API de Encuesta Platform, pero en general, aún puede usar todas las solicitudes de API de Encuesta Platform. Las solicitudes de contactos de la Plataforma de Encuesta son las únicas que pueden cambiar. En la documentación v3, las solicitudes de API que no son compatibles con los usuarios del XM Directory (y viceversa) tendrán un aviso.

¿Qué funcionalidad adicional proporciona la API de XM Directory a la que no tengo acceso solo con la API de Encuesta Platform?

La API del XM Directory le proporciona algunas solicitudes únicas específicas del XM Directory. Puedes utilizar Obtener contactos rebotados (API v2.4) para encontrar todos los contactos en su directorio (o en una lista de distribución específica) que alguna vez hayan tenido un rebote de correo electrónico. El Lista de contactos del Directorio La solicitud se puede utilizar para exportar un subconjunto de todo su directorio. El Obtener destinatarios de incentivos La solicitud le permite descargar una lista de todos los contacto de su directorio que hayan obtenido un incentivo específico, como una recompensa de puntos o una entrada a un sorteo. Estas solicitudes y otras están disponibles con la API de XM Directory .

¿Cuál es la diferencia entre el ID de Contacto y el ID del Destinatario ?

Cada solicitud de API de XM Directory generalmente solicita el ID de Contacto del contacto. Esta ID comienza con “CID_” y va seguida de una cadena alfanumérica única. El ID de Contacto es el ID único del contacto en su directorio. Algunas solicitudes de API solicitan el ID del Destinatario del contacto. Esta ID comienza con “CGC_” y va seguida de una cadena alfanumérica única. El ID del Destinatario es el ID único del contacto en una lista de distribución.

Para comprender la diferencia entre el ID de Contacto y el ID de Destinatario , es importante recordar que cada contacto solo debe existir en su directorio una vez. De esta forma, un único contacto podría aparecer en su directorio una sola vez, pero también podría ser miembro de varias listas de correo. Si este contacto fuera miembro de tres listas de correo, tendría un ID de Contacto y tres ID de Destinatario , uno para cada lista.

Qualtrics 360

Para las preguntas de Qualtrics 360 , contacto con nuestro equipo de soporte de Qualtrics 360.