Webhook

Un webhook en el desarrollo web es un método para aumentar o alterar el comportamiento de una aplicación web, con devoluciones de llamada personalizadas. Estas devoluciones de llamadas pueden ser mantenidas, modificadas y administradas por terceros usuarios y desarrolladores que no necesariamente estén afiliados a la aplicación original. QuestionPro soporta webhooks entrantes y salientes. Los webhooks pueden invocarse antes de que comience la encuesta, durante la encuesta (antes de una pregunta) o después de que se complete la encuesta. Puede configurar webhooks desde la sección Integraciones >> Webhooks:

Los Webhooks entrantes son una forma sencilla de publicar mensajes de fuentes externas en su encuesta.

Los webhooks salientes se pueden usar para enviar datos de encuestas a una fuente externa. Hacen uso de solicitudes HTTP normales con una carga JSON.

Para crear un webhook:

• Haga clic en el botón Add New Webhook .
• Introduzca una descripción para su webhook
• Seleccione el tipo requerido (entrante / saliente)
• Elija cuándo debe invocarse el webhook.
• Haga clic en Guardar cambios.

• URL de API: la URL de punto final para realizar una llamada a API
• Método: El método HTTP utilizado para hacer la llamada.
• Encabezado de solicitud: campos de encabezado HTTP que son componentes de la sección de encabezado de la solicitud
• Solicitud JSON: datos de carga útil requeridos por la API

Puede guardar los datos recuperados del recurso externo asignándolos a variables personalizadas:

Puede asignar los datos a variables personalizadas asignando claves JSON individuales a variables personalizadas específicas. También puede asignar un nombre relevante a las variables personalizadas:

Una vez que se establece la asignación, los datos recopilados se pueden mostrar en la encuesta utilizando el siguiente código: $ {CLAVE}

En el caso de los webhooks salientes, puede enviar los datos recopilados en variables personalizadas a un servicio web externo agregando las variables personalizadas en el JSON de solicitud:

Para obtener los datos de las variables personalizadas, puede usar las siguientes etiquetas para las variables personalizadas correspondientes en el JSON de solicitud:

Variable personalizada 1: $ {custom1}

Variable personalizada 2: $ {custom2}

Variable personalizada 3: $ {custom3}

Variable personalizada 4: $ {custom4}

Variable personalizada 5: $ {custom5}

Variable personalizada N: $ {customN}

Para obtener datos para las preguntas de la encuesta, puede utilizar el código de la pregunta correspondiente. Por ejemplo, si desea obtener datos para una pregunta con el código Q1, puede usar $ {Q1}