Servicio web

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 desea automatizar una segunda distribución de encuesta para que se envíe por correo electrónico a los encuestados de una primera encuesta exactamente 2 horas después. Un servicio web le permitiría hacer exactamente eso haciendo solicitudes a una URL designada.

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.
   
2. Haga clic en Añadir abajo o Añadir nuevo elemento aquí.
   
3. Seleccione Servicio web.
4. En el campo URL, pegue la URL de su servicio Web externo.
   
   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.

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

Parámetros

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

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, añádalos como cadena de consulta al final de la URL especificada.
   b) application/json: introduzca 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.
3. Encabezado personalizado: inserte aquí los encabezados de URL.

Si está utilizando nuestras llamadas a la 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.

Añadir parámetros a su 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.
   
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.
   
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.
   
   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 hacer 1 de lo siguiente:

• 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 esta modificación 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.