Los webhooks envían información cuando se producen determinados eventos que afectan a un servicio. En ArcGIS Online, puede crear webhooks para los servicios de entidades que rellenan capas de entidades alojadas, vistas de capas de entidades alojadas y tablas alojadas, y definir los eventos que provocan la invocación de los webhooks.
El elemento debe tener habilitada la configuración de edición Realizar un seguimiento de los cambios en los datos (agregar, actualizar, eliminar entidades) antes de poder crear o administrar un webhook para él.
Crear un webhook
Puede crear un webhook para una capa de entidades alojada, una vista de capa de entidades alojada o una tabla alojada con el fin de utilizar desencadenantes y mensajes que puedan notificar o facilitar la automatización de tareas para estos elementos.
La infraestructura para admitir webhooks se configura fuera de ArcGIS. Para obtener información sobre lo que debe configurar antes de poder crear un webhook y sobre los privilegios necesarios para crear webhooks, consulte Webhooks en ArcGIS Online.
Para crear un webhook para una capa de entidades alojada, una vista de capa de entidades alojada o una tabla alojada, siga estos pasos:
- Inicie sesión en la organización.
- Abra la página del elemento de la capa de entidades, vista o tabla alojada.
- Haga clic en la pestaña Configuración.
- Desplácese hasta la sección Webhooks y haga clic en Crear webhook.
Si el botón Crear webhook está desactivado, es posible que la capa no tenga activada la opción Realizar un seguimiento de los cambios en los datos (agregar, actualizar, eliminar entidades).
En el caso de las vistas, la opción Realizar un seguimiento de los cambios en los datos (agregar, actualizar, eliminar entidades) debe estar activada en la capa de entidades alojada de origen.
- Proporcione un nombre para el webhook.
- Expanda el menú Eventos y marque todas las casillas de verificación de eventos que desee activar un webhook.
- En el cuadro de texto URL del receptor del webhook, proporcione la URL del receptor del webhook.
El receptor del webhook debe existir ya y estar configurado para comunicarse a través de una conexión HTTPS segura.
- Si lo desea, proporcione una clave secreta para mayor seguridad.
Debe configurar la clave secreta en el receptor del webhook antes de proporcionarla para el webhook.
- Proporcione un nombre para el webhook.
El webhook aparece en la lista de webhooks para este elemento.
Administrar webhooks
Puede administrar los webhooks desde la pestaña Configuración de la página del elemento.
Los propietarios de elementos también pueden acceder y administrar todos los webhooks que poseen desde Mi configuración.
Sugerencia:
Los administradores de la organización tienen acceso y pueden gestionar todos los webhooks de la organización desde la pestaña Organización > Configuración > Webhooks. Consulte Administrar webhooks en toda la organización para obtener más información.
La gestión de un webhook asociado a una capa de entidades alojada, una vista de capa de entidades alojada o una tabla alojada incluye lo siguiente:
- Desactivar o activar el webhook: cuando un webhook está inactivo, no se activa cuando se producen los eventos desencadenantes definidos para él. Puede desactivar temporalmente todos los webhooks de una capa mientras realiza actualizaciones automáticas para evitar que su bandeja de entrada se llene de mensajes. También puede desactivar temporalmente un webhook que se activa para todos los eventos posibles y dejar activo otro webhook que se activa con un solo desencadenante para poder centrarse temporalmente en ese evento concreto.
- Editar el webhook: puede cambiar la configuración del webhook. Por ejemplo, puede agregar una clave secreta o cambiar los desencadenantes de eventos que provocan que se active el webhook.
- Eliminar el webhook: puede eliminar un webhook si ya no lo necesita.
Nota:
Los webhooks se eliminan de inmediato. No se mueven a la papelera de reciclaje.
Administrar un webhook desde la página del elemento
Para administrar un webhook desde la página de elementos de la capa de entidades alojada, la vista de la capa de entidades alojada o la tabla alojada con la que está asociado, siga estos pasos:
- Inicie sesión en la organización.
- Abra la página del elemento de la capa de entidades, vista o tabla alojada.
- Haga clic en la pestaña Configuración y desplácese a la sección de webhooks.
Aquí se enumeran todos los webhooks asociados a este elemento.
- Realice una de las siguientes tareas de administración:
- Para desactivar el webhook, desactive el botón de alternancia situado junto al nombre del webhook.
- Para activar el webhook, active el botón de alternancia situado junto al nombre del webhook.
- Para editar la configuración de un webhook, haga clic en el botón Opciones
junto al nombre del webhook y haga clic en Editar. Cambie el nombre, los eventos, la URL del receptor del webhook o la clave secreta del webhook y haga clic en Actualizar webhook. - Para eliminar un webhook, haga clic en el botón Opciones junto al nombre del webhook y haga clic en Eliminar. Cuando se le solicite que confirme, haga clic en Eliminar.
Administrar un webhook desde Mi configuración
Para administrar webhooks desde Mi configuración, siga estos pasos:
- Inicie sesión en la organización.
- Haga clic en su nombre de miembro en la parte superior del sitio y haga clic en Mi configuración.
- Haga clic en la pestaña Webhooks.
- Realice una de las siguientes tareas de administración:
- Para desactivar el webhook, desactive el botón de alternancia situado junto al nombre del webhook.
- Para activar el webhook, active el botón de alternancia situado junto al nombre del webhook.
- Para editar la configuración de un webhook, haga clic en el botón Opciones junto al nombre del webhook y haga clic en Editar. Cambie el nombre, los eventos, la URL del receptor del webhook o la clave secreta del webhook y haga clic en Actualizar webhook.
- Para eliminar un webhook, haga clic en el botón Opciones junto al nombre del webhook y haga clic en Eliminar. Cuando se le solicite que confirme, haga clic en Eliminar.