Preguntas comunes de API

Acerca de las preguntas de API comunes

Qualtrics dispone de diversos productos que permiten a nuestros clientes recopilar datos procesables en tiempo real. Algunos de estos productos incluyen Plataforma de encuestas, Opiniones de página web/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 API para la Plataforma de encuestas y el Directorio XM.
• Documentación de API para Opinión de página web/aplicación.

Plataforma de encuestas

Tengo todos los parámetros correctos, pero recibo un mensaje de error que dice “Solicitud no válida. Falta la solicitud de parámetro o no es válido.” ¿Por qué sucede esto?

Ejemplo:

curl -X POST \  https://yourdatacenterid.qualtrics.com/API/v3/responseexports \   
 -H 'content-type: application/json' \  -H 'x-api-token: 12345678901234567890' \   -
d '{"SurveyId":"SV_1234567890","Format":"json"}"

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

Deseo descargar mis datos sin procesar para abrirlos en Excel. ¿Qué solicitud de API debería utilizar?

Desea utilizar Crear solicitud de exportación de respuesta para iniciar el proceso de exportación y especificar que el formato del archivo de exportación de respuesta debe ser CSV. A continuación, deberá utilizar la solicitud Obtener progreso de exportación de respuesta para verificar si el archivo está listo, seguido de la solicitud Obtener respuesta y exportar archivo para descargar el archivo CSV.

Al utilizar Crear importación de contactos, ¿cuáles son los diferentes métodos de publicación o envío de mi lista de contactos a Qualtrics?

Existen dos opciones para cargar su lista de contactos:

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

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

Consulte esta página de la API para obtener más información sobre los límites.

Estoy utilizando la solicitud Importar encuesta y he guardado mi encuesta como archivo TXT. La solicitud se ha realizado correctamente, pero mis preguntas no aparecen en mi encuesta recién importada. ¿Por qué sucede esto?

Deberá asegurarse de que está siguiendo 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 el archivo tenga el formato correcto, la solicitud se ejecutará correctamente.

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

La clave para utilizar los parámetros startDate y endDate es comprender qué valor de fecha se utiliza para evaluar la condición que está creando (es decir, qué fechas se están observando para evaluar la startDate que fija y la endDate que fija). Estos dos parámetros utilizan la fecha en la que el participante inició la encuesta. Este valor, llamado Fecha de inicio, se puede encontrar en su pestaña Datos y datos descargados. Por lo tanto, si establece su parámetro startDate en 2017-01-01 y su parámetro endDate en 2017-01-02, descargará las respuestas que se hayan registrado (enviado o incompleto) para los participantes de la encuesta que iniciaron 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 envío dentro de una encuesta o cuando el respuestas incompletas de la encuesta Se ha cumplido el período de tiempo.

Opinión de sitio web/aplicación

Para preguntas sobre Opinión de página web/aplicación, póngase en contacto con nuestro equipo de soporte técnico de Opinión de página web/aplicación.

XM Directory

¿Puedo utilizar la API de plataforma de encuestas ahora que también estoy utilizando XM Directory?

Sí, absolutamente. XM Directory tiene algunas solicitudes de API que reemplazarán las solicitudes realizadas a través de la API de Plataforma de encuestas, pero en la mayoría de los casos aún puede utilizar todas las solicitudes de API de Plataforma de encuestas. Las solicitudes de Contactos de plataforma de encuesta son las únicas que pueden cambiar. En la documentación v3, las solicitudes API que no son compatibles con los usuarios de 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 Plataforma de encuestas?

La API de XM Directory le proporciona algunas solicitudes únicas específicas de XM Directory. Puede utilizar getBouncedContacts (API v2.4) para buscar todos los contactos de su directorio (o en una lista de distribución específica) que hayan tenido una devolución de correo electrónico. La solicitud Lista de contactos del directorio se puede utilizar para exportar un subconjunto de todo el directorio. La solicitud getIncentiveRecipients le permite descargar una lista de todos los contactos de su directorio que han obtenido un incentivo específico, como una bonificación por puntos o una entrada de 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 de destinatario?

Normalmente, cada solicitud de API de XM Directory solicita el ID de contacto del contacto. Este ID empieza por “CID_” y va seguido 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 de destinatario del contacto. Este ID empieza por “CGC_” y va seguido de un string alfanumérico único. El ID de 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 una vez en su directorio. Por lo tanto, se puede encontrar un solo contacto en su directorio una vez, pero también puede ser miembro de varias listas de distribución. Si este contacto fuera miembro de tres listas de distribución, tendría un ID de contacto y tres ID de destinatario, uno para cada lista.

Qualtrics 360

Si tiene preguntas sobre Qualtrics 360, póngase en contacto con nuestro equipo de soporte técnico de Qualtrics 360.