Suscripción de webhook - Detalle
Una suscripción se abre desde la lista de Suscripciones de webhook. La página se abre en modo de visualización; pulse Editar para modificarla.
Cabecera
La cabecera muestra el nombre de la suscripción con su URL debajo.
Los botones de acción:
| Campo | Descripción |
|---|---|
| Ping de prueba | Envía una entrega de prueba al endpoint e informa del resultado — el código de estado HTTP y cuánto ha tardado, o el error. |
| Regenerar secreto | Emite un nuevo secreto de firma. Se abre un diálogo de confirmación para aprobar que el endpoint receptor debe actualizarse con el nuevo secreto. |
| Ver eventos | Abre los eventos de la suscripción. |
Cuerpo
General
| Campo | Descripción |
|---|---|
| Nombre | Cómo se llama la suscripción. Obligatorio |
| URL | El endpoint al que se notifica. Obligatorio. |
| Activo | Marca de verificación si se están enviando entregas. |
Tipos de evento
Sobre qué eventos se notifica a este endpoint. La pantalla lo indica: una casilla de grupo suscribe a todos los eventos actuales y futuros de ese grupo, y All events suscribe a todos los eventos de todas las entidades, incluidas las entidades que se añadan más adelante.
Elija una entidad para seleccionar sus operaciones individuales; la lista se puede filtrar y alternar entre All y Selected para comprobar qué cubre realmente una suscripción.
Secreto del webhook
El secreto firma cada entrega, de modo que el sistema receptor puede comprobar que la llamada procede de Beas.
El secreto se muestra en claro solo una vez — justo después de crear la suscripción o de regenerar el secreto. Cópielo en ese momento; no se vuelve a mostrar.
Al regenerarlo, el secreto actual queda invalidado de inmediato, y el endpoint receptor tiene que actualizarse con el nuevo. La pantalla pide confirmación antes de hacerlo.
Ejemplos
Una suscripción que recibe más de lo esperado. Una casilla de grupo es una suscripción permanente a ese grupo, eventos futuros incluidos — lo que suele convenir para una integración de partner y rara vez para una integración acotada. Use Selected para comprobar exactamente qué cubre una suscripción antes de culpar al remitente.
Un endpoint que rechaza todas las entregas. Ping de prueba distingue entre «Beas no está enviando» y «el endpoint está rechazando»: informa del código de estado HTTP y del tiempo de ida y vuelta. Un ping que funciona mientras los eventos reales fallan apunta a la firma — normalmente un secreto que se ha regenerado aquí y nunca se ha actualizado en el otro extremo.