Webhooks

Comprende la página de Webhooks del proyecto y recuperate cuando su portal integrado no esté listo.

Los Webhooks permiten que otro servicio reciba eventos seleccionados de un proyecto de Runner. Esta es una función avanzada y sensible a la seguridad: úsala solo cuando sepas qué servicio debe recibir los eventos y cómo ese servicio los verifica.

Ruta de entrada

Abre la página de Webhooks del proyecto solo a través de una entrada que Runner pone a disposición de tu espacio de trabajo. Si no hay entrada, no adivines una URL; consulta Disponibilidad de funciones o pregunta al soporte si la función está habilitada.

Antes de comenzar

Usa Webhooks solo cuando Runner o el soporte exponga una entrada aprobada.
Conoce el servicio receptor previsto y cómo verifica los eventos.
Trata las direcciones de punto final, secretos de firma y datos entregados como sensibles.

Lo que Runner muestra

Runner prepara el servicio de webhook antes de mostrar el portal de gestión integrado.

Estado de página o control	Lo que significa o hace
Cargando…	Runner está verificando si el servicio de webhook está listo.
La plataforma de webhook se está inicializando	La configuración aún está en progreso. Espera y mantén la página abierta, o regresa más tarde.
La inicialización está tomando más tiempo del esperado	La configuración no se ha completado después de la espera normal. Reintentar pide a Runner que aprovisione el servicio nuevamente.
Reintentando…	El reintento está en progreso; el botón permanece no disponible hasta que la solicitud se termine.
Mensaje de error	Runner no pudo preparar el servicio. Mantén el mensaje visible para el soporte.
Portal de webhook integrado	El servicio está listo. Las etiquetas y controles exactos dentro de este portal administrado por el proveedor pueden cambiar, así que sigue las instrucciones mostradas allí en lugar de confiar en nombres de botón fijos en esta guía.
Reconectar Shopify	Abre la página de integración de Shopify cuando una conexión de Shopify más antigua necesita nuevos permisos de webhook. Reconecta antes de esperar que lleguen eventos de Shopify.

Recuperate de una inicialización larga

Espera a que el mensaje de inicialización se termine.
Si La inicialización está tomando más tiempo del esperado aparece, selecciona Reintentar una vez.
Espera a que el portal integrado reemplace la pantalla de inicialización.
Si aparece un error nuevamente, guarda el nombre del proyecto y el mensaje exacto, luego contacta al soporte en lugar de reintentar repetidamente.

Reconecta Shopify cuando se solicite

Lee el aviso Reconecta tu tienda Shopify.
Selecciona Reconectar Shopify.
Completa el flujo de conexión en la página de integración de Shopify.
Regresa a Webhooks y confirma que el aviso de reconexión se haya ido antes de confiar en la entrega de eventos.

Reconectar cambia la autorización de integración de la tienda. Solo una persona que pueda gestionar esa conexión de tienda debe continuar.

Notas de seguridad

Trata las direcciones de punto final, secretos de firma y contenidos de eventos como sensibles.
Agrega o cambia un destino solo cuando su propietario haya proporcionado la dirección segura correcta.
Revisa cada confirmación mostrada dentro del portal integrado; sus acciones pueden afectar entregas futuras.
Si un valor de firma se expone, reemplázalo en el servicio de webhook de Runner y el sistema receptor antes de enviar más eventos.

Solución de problemas

Problema	Siguiente paso
Sin entrada de Webhooks	La función no está expuesta en este espacio de trabajo. Verifica Disponibilidad de funciones.
La inicialización no se termina	Usa Reintentar una vez, luego reporta el estado exacto si se repite.
Aparece mensaje de error	Mantén el mensaje completo y el nombre del proyecto para el soporte.
El aviso de reconexión de Shopify permanece	Termina de reconectar desde la página de integración, luego recarga Webhooks una vez.
El portal integrado está en blanco o se comporta diferente	Recarga una vez. Si persiste, captura lo que es visible; la interfaz del proveedor integrado puede diferir por cuenta o lanzamiento.