Los webhooks son un método muy compatible utilizado para permitir que varias aplicaciones interactúen entre sí, a través de solicitudes HTTP POST para pasar devoluciones de llamadas entre ellas. Para obtener más información, consulte la página de Wikipedia sobre los webhooks. Entre los usos habituales de webhooks se encuentran: el envío de notificaciones por correo electrónico o SMS, la publicación de mensajes en redes sociales, la escritura automática de registros en una hoja de cálculo y la actualización de bases de datos corporativas.
Al volver a publicarla, ArcGIS Survey123 muestra un aviso si alguno de los cambios que ha realizado no es compatible con la capa de entidades existente. Si desactiva la advertencia y vuelve a publicarla, la capa de entidades original se elimina y se reemplaza, y se pierden todos los datos asociados.
Su lugar de trabajo puede contar con su propio proveedor de webhook, pero también dispone de una variedad de servicios de flujo de trabajo de terceros, tales como Microsoft Power Automate, Make (anteriormente Integromat), Zapier y tray.io. Todos ellos se pueden utilizar para incorporar Survey123 como desencadenador de un proceso automático. En particular, Microsoft Power Automate y Make tienen, cada uno, un conector de Survey123 integrado, lo cual le permite integrar Survey123 en su flujo de trabajo de webhook con el mínimo de dificultad y sin tener que configurar el webhook en el sitio web de Survey123 ni introducir una URL de carga.
Precaución:
Al crear o modificar un webhook para una encuesta, la encuesta se debe actualizar en la aplicación de campo Survey123 para que los cambios surtan efecto.
Existen muchas maneras de utilizar Survey123 como desencadenador de sus flujos de trabajo. En las secciones que aparecen a continuación, se demuestra cómo configurar un webhook para enviar una notificación de correo electrónico cuando se haya enviado una respuesta que contenga una pregunta respondida con un valor determinado.
Al final de este tema, se muestran como referencia todas las propiedades disponibles en la carga de eventos de webhooks.
Configurar un webhook en Make
Make (anteriormente Integromat) es una plataforma de automatización en línea. Regístrese para conseguir una cuenta gratuita y empezar a trabajar. Make tiene plantillas para utilizar como punto de partida para incluir adjuntos en las notificaciones por correo electrónico, agregar registros a hojas de cálculo y crear elementos de calendario.
- Vaya a https://www.make.com/ e inicie sesión.
- En la página Escenarios, haga clic en el botón Crea un nuevo escenario.
- Haga clic en el icono de módulo del centro de la pantalla. Busque Survey123 y selecciónelo.
- Elija el módulo desencadenador Ver encuesta.
Este módulo se ha diseñado para ejecutar el escenario cada vez que se envíe una respuesta a una encuesta.
Aparece un elemento emergente que le ayuda a configurar el módulo Ver encuesta.
Sugerencia:
Puede utilizar el módulo Crear informe para generar un informe para una respuesta de encuesta.
- Haga clic en Agregar y proporcione un nombre para su webhook.
Este nombre debe ser exclusivo de la encuesta para la cual está configurando el webhook.
- Si esta es la primera vez que utiliza el módulo Survey123 en Make, establezca una conexión a su organización de ArcGIS. Solo necesita hacerlo una vez, dado que Make guardará su información para uso futuro. En Conexión, haga clic en Agregar y asigne un nombre a la conexión a ArcGIS.
- Para conectarse a ArcGIS Online, haga clic en Guardar para iniciar sesión en su organización de ArcGIS.
- Para conectarse a ArcGIS Enterprise, regístrese en Make con su portal. Para obtener más información, consulte la entrada de blog Secretos de Survey123: Make.
- Elija la encuesta de su organización de ArcGIS a la que desea conectarse.
- Considere las opciones que desea incluir en su webhook y haga clic en Guardar.
Se recomienda mantener el valor predeterminado Sí en todos los ajustes avanzados, ya que es lo que le proporciona la mayor flexibilidad a la hora de personalizar el webhook.
- Haga clic en Aceptar.
Se crea el webhook y se configura el módulo Ver encuesta.
- Haga clic en el botón Agregar otro módulo en el lateral derecho del módulo Ver encuesta para conectarle otro módulo.
- Busque Correo electrónico y seleccione el módulo Correo electrónico.
- Seleccione la acción Enviar correo electrónico.
- Si es la primera vez que utiliza este módulo en Make, haga clic en Agregar para configurar una conexión a su cuenta de correo electrónico. Seleccione un tipo de conexión e inicie sesión en su cuenta.
Solo necesita hacerlo una vez, dado que Make guardará su conexión para uso futuro.
- Agregue una dirección de correo electrónico de destinatario.
Esta es la dirección de correo electrónico a la que se enviará el correo electrónico generado por el desencadenador.
- Haga clic en el cuadro de texto de asunto. Elija campos de su encuesta para construir el asunto de su correo electrónico utilizando el panel de configuración del módulo que aparece.
- Haga clic en el cuadro de texto de contenido. Elija campos de su encuesta para construir el contenido de su correo electrónico utilizando el panel de configuración del módulo que aparece. Puede formatear el contenido con HTML.
- Haga clic en Aceptar.
Este escenario necesita enviar el correo electrónico cuando se ha respondido a una pregunta de una forma concreta, de modo que indicará un filtro.
- Haga clic en el icono de las herramientas entre los dos módulos y seleccione Definir filtro.
- Haga clic en el cuadro de texto Condición y elija el campo de su encuesta que desea usar en el filtro.
- Elija el operador para la condición. En este caso, elija el predeterminado, Igual que.
- Introduzca un valor para la condición y haga clic en Aceptar.
- Haga clic en Guardar para guardar su escenario.
Opcionalmente, puede hacer clic en Ejecutar una vez para probar su webhook. Después de hacer clic en Ejecutar una vez, abra Survey123 y envíe una encuesta, asegurándose de que la respuesta de la encuesta cumpla la condición de filtro. Confirme que el destinatario recibe el correo electrónico.
- Utilice el botón de alternancia activar/desactivar de la parte inferior izquierda de la página para activar su escenario. Cambie la programación a Inmediatamente para asegurarse de que el escenario se ejecute cada vez que se envíe una respuesta a la encuesta.
Para conocer más formas de utilizar Survey123 como desencadenador de escenarios de Make, consulte Integraciones de Survey123.
Configurar un webhook en Microsoft Power Automate
Microsoft Power Automate es un servicio de webhooks disponible en la plataforma Microsoft Office 365.
Nota:
Las credenciales de ArcGIS Online que se utilizan para crear flujos en Power Automate cierran la sesión de forma automática después de dos semanas. Si no puede examinar las encuestas esperadas en Power Automate, confirme que su conexión de datos con Survey123 está activa. Para obtener más información, consulte el artículo del blog Consejo rápido: Cómo mantener válido el token de actualización de ArcGIS Connectors for Power Automate.
Para configurar un flujo en Microsoft Power Automate utilizando los conectores de ArcGIS o ArcGIS Enterprise, siga los pasos que se indican a continuación. Si anteriormente creó flujos con el conector de Survey123, estos seguirán funcionando, pero la nueva funcionalidad solo se agregará a los conectores de ArcGIS y ArcGIS Enterprise. Para obtener más información, consulte el artículo del blog Desencadenadores y acciones de Survey123 en ArcGIS Connectors for Power Automate.
- Abra Microsoft Power Automate.
- Seleccione Crear en el menú lateral de la página.
- Seleccione Flujo de nube automático en las opciones de Empezar desde cero.
Aparece el cuadro de diálogo Crear un flujo de nube automático.
- Ponga un nombre al flujo.
A continuación, seleccionará un desencadenador.
- Escriba ArcGIS en la barra de búsqueda y seleccione Cuando se envía la respuesta a una encuesta.
Precaución:
Elija la opción Cuando se envía la respuesta a una encuesta en ArcGIS si el flujo requiere que inicie sesión en una organización de ArcGIS Online. Elija la opción Cuando se envía la respuesta a una encuesta en ArcGIS Enterprise si el flujo requiere que inicie sesión en una organización de ArcGIS Enterprise.
- Haga clic en Crear.
- Si esta es la primera vez que utiliza este conector en Microsoft Power Automate, haga clic en Iniciar sesión para iniciar sesión con las credenciales de su organización de ArcGIS.
Solo necesita iniciar sesión una vez, dado que Microsoft Power Automate guardará sus credenciales para usos futuros.
- Seleccione la encuesta que desee usar para el webhook en la lista desplegable de encuestas.
Ya ha configurado el desencadenador para el webhook; sin embargo, para que el webhook realice acciones con este desencadenador, hay pasos adicionales.
El flujo necesita enviar un correo electrónico cuando se ha respondido a una pregunta de una forma concreta, de modo que indicará una condición.
- Haga clic en el botón Nuevo paso y elija Condición en la parte superior de la sección Acciones.
- Haga clic en el cuadro de texto que está más a la izquierda para abrir un cuadro de diálogo y elegir una pregunta o propiedad de la encuesta y seleccione la pregunta de la encuesta que desea usar para calificar la encuesta.
- En el cuadro de texto central, en el menú desplegable, seleccione la condición es igual a como desencadenador, ya que está buscando una respuesta exacta.
- En el cuadro de texto que está más a la derecha, escriba el valor de la pregunta para la que desee enviar una notificación.
Usted desea que este correo electrónico solo se envíe si se cumple la condición.
- Haga clic en Agregar una acción en el cuadro Si se cumple.
El cuadro Si no se cumple permanece vacío.
Varios servicios de correo disponen de conectores que se pueden utilizar para este flujo.
- Elija Office 365 Outlook - Enviar un correo electrónico (V2).
- Inicie sesión en el servicio de correo con sus credenciales, si es que aún no están guardadas.
- Rellene los campos Para, Asunto y Cuerpo de su correo electrónico.
El cuadro de diálogo Contenido dinámico que aparece cuando selecciona un cuadro de texto le permite insertar el contenido de la respuesta de encuesta según sus necesidades.
- Cuando haya terminado el correo electrónico, haga clic en Guardar.
El webhook se completa y se activa de forma predeterminada. El webhook ahora se ejecutará cada vez que se envíe una respuesta de encuesta que reúna las condiciones definidas.
Sugerencia:
Puede utilizar el módulo Crear informe para generar un informe para una respuesta de encuesta
Configurar un webhook en el sitio web de Survey123
Siga estos pasos para configurar un webhook en el sitio web de Survey123:
- En la página Mis encuestas, seleccione la pestaña Configuración en el menú de la parte inferior derecha del panel de la encuesta.
- En el menú de la izquierda, seleccione la sección Webhook.
Esta página le permite configurar y acceder a todos los webhooks que haya configurado. Si no ha configurado ningún webhook en Survey123, la página estará vacía.
- Haga clic en Agregar webhook.
Aparece una nueva página donde puede configurar cómo interactuará el webhook con su encuesta.
- Proporcione un nombre para su webhook, que se utilizará para identificar su webhook en el futuro.
- La URL de carga es el lugar al que se enviará la información de la encuesta. Debe provenir de un servicio de webhooks externo.
Cuando crea un webhook mediante un servicio como Microsoft Power Automate o Make, la URL de carga se completa automáticamente en esta página. Otros servicios, como Zapier o FME Server, proporcionan la URL de carga para que la copie en esta página. Otras aplicaciones pueden requerir que cree un servicio específico para escuchar el webhook.
- Los eventos desencadenadores describen las acciones específicas que llamarán al webhook. Seleccione Nuevo registro enviado.
- Los datos del evento le permiten elegir la información de la encuesta que se incluirá en la carga: Información de la encuesta, Respuesta del servidor, Registro enviado, Información del usuario e Información del portal. Active las opciones Información de la encuesta y Registro enviado.
- El botón de alternancia Estado determina si el webhook estará activo al guardarlo. Déjelo como Activado (el valor predeterminado).
- Haga clic en Guardar.
El webhook está listo para su uso y se ejecutará cada vez que se envíe una respuesta de la encuesta. Las reglas definidas dentro del proveedor de webhooks pueden garantizar el envío de un correo electrónico solamente si se reúnen determinados criterios.
Propiedades de Carga de eventos
Un evento de webhook envía una carga de propiedades como un objeto JSON. El contenido de la carga variará en función de la encuesta. La siguiente tabla enumera las propiedades comunes contenidas en el objeto JSON:
| Propiedad | Descripción |
|---|---|
| eventType | El tipo de modelo. Los valores pueden ser addData o editData. |
| portalInfo | Información sobre la organización de ArcGIS en la que se aloja la encuesta. Contiene las siguientes opciones:
|
| surveyInfo | Información sobre la encuesta que generó el webhook. Contiene las siguientes opciones:
|
| userInfo | Información sobre la cuenta de organización de ArcGIS para el usuario que ha enviado la encuesta. Contiene las siguientes opciones:
|
Las siguientes propiedades variarán en función de la encuesta y el tipo de evento:
| Propiedad | Descripción |
|---|---|
| applyEdits | La carga Aplicar ediciones enviadas por la encuesta. Si eventType es addData, contendrá adds. Si eventType es editData, contendrá updates. Al agregar un nuevo registro de repetición, también contendrá adds. |
| response | La respuesta de la operación applyEdits. Incluye los Id. globales de las entidades creadas por la operación y si la operación se realizó correctamente. |
| feature | El registro de la encuesta que se envió. Contiene las siguientes opciones:
|