Saltar al contenido principal
Loading...
Skip to article
  • Qualtrics Platform
    Qualtrics Platform
  • Customer Journey Optimizer
    Customer Journey Optimizer
  • XM Discover
    XM Discover
  • Qualtrics Social Connect
    Qualtrics Social Connect

Servicio web


Was this helpful?


This site is protected by reCAPTCHA and the Google Privacy Policy and Terms of Service apply.

The feedback you submit here is used only to help improve this page.

That’s great! Thank you for your feedback!

Thank you for your feedback!


Acerca de los servicios web

A veces, es posible que desee incluir funciones más complejas en su encuesta. Tal vez desee incluir los 10 titulares principales de una página web de noticias en su encuesta, o bien desea automatizar una segunda distribución de encuestas para que se envíe por correo electrónico a los encuestados de una primera encuesta exactamente 2 horas más tarde. Un servicio web le permitiría hacer exactamente eso haciendo solicitudes a una URL designada.

Consejo Q: Esta página contiene referencias a la API de Qualtrics, que es una función que requiere permiso especial para acceder a. Si está interesado en obtener acceso a esta función, póngase en contacto con su Administrador de organización para obtener más información.
Atención: La configuración de un servicio web a menudo requiere conocimientos de programación avanzados. Aunque nuestro equipo de soporte está encantado de ayudar con los aspectos básicos de poner información en el servicio web, no podemos proporcionar soporte en los aspectos de programación. En su lugar, puede preguntar a los usuarios especializados de nuestra comunidad.

Adición de un servicio web

  1. Al editar la encuesta, haga clic en el icono Flujo de la encuesta en la barra de navegación izquierda.
    se muestra la navegación al flujo de la encuesta al hacer clic en el ícono del flujo de la encuesta en la barra de navegación izquierda
  2. Haga clic en Añadir abajo o Añadir nuevo elemento aquí.
    Añadir abajo y añadir un nuevo elemento Aquí botones; opción Servicio Web en la opción ¿Qué desea añadir? menú
  3. Seleccione Servicio web.
  4. En el campo URL, pegue la URL de su servicio Web externo.
    Campo para URL en un servicio web seguido del método

    Consejo Q: Puede usar texto dinámico para pasar la información de la encuesta a su URL de extremo a través de cadenas de consulta.
  5. Seleccione un Método para el servicio Web. Explicaremos más sobre los diferentes métodos en la siguiente sección.

Métodos

Nuestra función de servicio web le permite elegir entre una serie de métodos para solicitar información de la URL especificada.

Tipo de método Acción Ejemplo
GET El servicio web va a la URL y recupera información. Recupere información sobre un miembro de su lista de contactos. Consulte la llamada Obtener API de contacto para obtener más detalles.
POST Vaya al URL y guarde la información allí. Crear un mensaje de biblioteca.
PUT Actualice o reemplace la información existente. Cambiar un nombre de usuario. Esto es 1 de las cosas que puede hacer con la llamada Actualizar usuario.
PARCHE Actualice o reemplace la información existente. Muy similar a PUT. Aunque nuestro servicio web ofrece este método, nuestra API no utiliza llamadas PATCH. Modifique los datos guardados en su servidor.
ELIMINAR Eliminar información. Borre un gráfico de su biblioteca.

 

Si utiliza nuestras llamadas API, la documentación le indicará qué método utilizar, como se indica en la siguiente captura de pantalla.

Método enumerado junto a cada llamada en la documentación de API

Parámetros

Actualmente hay 3 tipos de parámetros que puede anexar a su solicitud.

Un servicio web con lo siguiente resaltado: Añadir un parámetro de consulta, Añadir un parámetro del cuerpo y Añadir una cabecera personalizada

  1. Parámetro de consulta: en lugar de añadir una cadena de consulta al final de la URL de servicio Web, coloque los parámetros de consulta aquí.
  2. Parámetro Body: Este parámetro no está disponible para solicitudes GET o DELETE. Viene con 2 opciones de formato:
    a) application/x-www-form-urlencoded: En lugar de introducir los parámetros del cuerpo en el área especificada del servicio web, agréguelos como una cadena de consulta al final de la URL especificada.
    b) application/json: Ingrese sus claves en Notación de puntos. Por ejemplo, es posible que nuestra llamada a la API le pida que especifique un encabezado[fromEmail]. En Notación de puntos, se convierte en header.fromEmail.

    Atención: Cada clave y valor de un objeto JSON, así como todos los elementos de una matriz JSON (incluido el texto dinámico), deben tener comillas dobles a su alrededor. En un parámetro del cuerpo, cada clave y valor de un objeto JSON, así como cada elemento de una matriz JSON, deben tener comillas dobles a su alrededor.
  3. Encabezado personalizado: inserte aquí los encabezados de URL.
    Consejo Q: Las URL de autenticación deben añadirse al encabezado personalizado.

Si utiliza nuestras llamadas API, la documentación le indicará qué tipo de parámetros incluir. El siguiente ejemplo proporciona los parámetros del cuerpo que se deben establecer.

En la documentación de API, una flecha que indica Parámetros del cuerpo

Añadir parámetros a su servicio Web

Parámetros del cuerpo rellenados en un servicio web

  1. Seleccione cualquiera de las 3 opciones Agregar un parámetro para enviar al servicio web indicadas en la sección anterior. En el ejemplo anterior, indicamos los Parámetros de consulta.
  2. Escriba el nombre del parámetro en el cuadro Parámetro para servicio web de la izquierda.
  3. Escriba el valor correspondiente del parámetro en el cuadro Valor de la derecha.
  4. Haga clic en el signo más (+) situado a la derecha del parámetro para añadir otro.
  5. Haga clic en Aplicar cuando termine.

Probar los parámetros

Una vez que haya pegado la URL y configurado los parámetros, puede probar la URL para ver qué campos puede introducir.

  1. Haga clic en URL de test para ver qué información puede extraer del servicio Web externo.
    Pulsador URL de test junto al campo URL
  2. Seleccione los campos que desea utilizar o registrar en su encuesta. El Nombre de campo aparece a la izquierda y un Valor de ejemplo correspondiente aparece a la derecha.
    Seleccionar campos para capturar desde la URL
  3. Haga clic en Añadir datos embebidos para añadir campos seleccionados a sus datos.
    Consejo Q: Puede cambiar los nombres de los datos embebidos asociados con los campos de su servicio web en la columna Establecer datos embebidos. Los nombres de datos incrustados están a la izquierda del signo igual (=), indicado con un icono verde de ED. El lado derecho no debe ser alterado. Los nombres que fije a la izquierda serán los nombres de los campos tal y como aparecen en sus datos.
  4. Si selecciona Incendio y olvido, no grabará ninguno de los datos devueltos de la llamada del servicio Web. Esta función es útil cuando no necesita guardar los datos devueltos.
    Opción Iniciar y olvidar arriba de los campos; Aplicar en la parte inferior derecha

    Consejo Q: Fuego y olvido permite que su encuesta realice una solicitud a un servicio web sin esperar una respuesta. Esto significa que los encuestados podrán completar la encuesta completa sin demora debido al servicio web. Es posible que desee utilizar esta opción si tiene una solicitud de servicio web que tarda un tiempo en procesarse, pero le recomendamos que solo utilice esta función durante las pruebas, ya que evitará que se guarden los datos embebidos.
  5. Cuando haya terminado, haga clic en Aplicar.

Corrección de errores TLS

A partir del 1 de septiembre de 2021, las solicitudes de servicio web con errores de seguridad de la capa de transporte (TLS) fallarán. TLS es lo que hace que las solicitudes web sobre HTTPS (a diferencia de HTTP simple) sean seguras, evitando que los datos de la solicitud sean visibles para terceros y asegurándose de que la solicitud se envía al destino correcto. Ignorar los errores de TLS elimina de forma eficaz estos beneficios de seguridad; este cambio es un paso importante en nuestros continuos esfuerzos por mejorar la seguridad de la plataforma de Qualtrics.

Para resolver cada error de TLS, debe realizar 1 de las siguientes acciones:

  • Corrija el error TLS. Debido a la naturaleza de los errores de TLS, nuestro equipo de soporte no puede proporcionar orientación específica sobre cómo hacerlo, pero su administrador de red sabrá cómo solucionar el error.
  • Cambie la solicitud de servicio web del elemento de flujo que se debe realizar mediante HTTP, no HTTPS. Por ejemplo, puede modificar la URL “https://example.com” a “http://example.com”. Si opta por adoptar este enfoque, también debe asegurarse de que la URL HTTP no redirige a la URL HTTPS.
    Atención: Tenga en cuenta que este enfoque hará que los datos de solicitud del servicio web se transmitan sin cifrar.

Puede verificar que su elemento de servicio web está listo para este cambio utilizando el botón de prueba junto al campo URL en el elemento de flujo. La visualización de los datos brutos en la ventana resultante, que también se muestra a continuación, no debería mostrar un error.

Diálogo que se abre en el flujo de la encuesta e indica Seleccionar campos para incluir como datos embebidos El servicio web no ha devuelto campos. Haga clic aquí para ver los datos sin procesar. En la esquina inferior izquierda del diálogo hay un botón que dice Ver datos brutos

Atención: Si actualiza el elemento del servicio web para solucionar el error, también debe publicar las modificaciones en la encuesta. Le recomendamos que resuelva los errores lo antes posible para evitar sesiones de encuesta en curso utilizando la versión de encuesta antigua después de la fecha límite. Si en su lugar resuelve el error mediante otro método (por ejemplo, corrigiendo la configuración TLS en el servidor al que va dirigido su elemento de servicio Web), la publicación no es necesaria.

Tipos de proyectos en los que está disponible esta función

Siempre que tenga acceso a los servicios web como parte de su licencia, puede añadir un servicio web a cualquier tipo de flujo de encuesta del proyecto. Esto incluye:

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.