Appearance

Subscriptions ​

Subscriptions son reglas de usuario para recibir alerts. Una subscription conecta el project elegido, trigger o template, parámetros de usuario, condiciones de filtrado y actions mediante las cuales Web3alert envía notificaciones.

Dicho de forma simple, un project describe la integración disponible, triggers y templates describen a qué se puede suscribir el usuario, y una subscription es la configuración concreta del workspace: qué seguir exactamente, con qué condiciones y adónde enviar el resultado.

Qué conecta una subscription ​

Workspace ​

Una subscription pertenece al workspace activo. Por eso la lista de subscriptions muestra la configuración del workspace actual, no solo del usuario actual.

Si el usuario cambia de workspace, ve y gestiona otro conjunto de subscriptions.

Project ​

Cada subscription está vinculada a un project. El project define la integración de marketplace, triggers disponibles, templates, metadata y access level.

En la página del project, la pestaña Subscriptions muestra la misma lista de subscriptions que la sección general Subscriptions, pero filtrada por el project concreto.

Trigger o template ​

Una subscription puede crearse de dos formas:

  • mediante un template, cuando el usuario elige un escenario preparado y topics;
  • directamente mediante un trigger, cuando el usuario necesita una configuración más precisa de evento, inputs y filters.

Un template dentro de una subscription se despliega en rules. Una rule indica qué trigger usar y qué conditions aplicar.

Inputs y filters ​

Inputs son valores que el usuario rellena al crear una subscription. Pueden ser necesarios para el trigger directamente o para template rules.

Filters son condiciones adicionales que limitan el flujo de alerts. Por ejemplo, se pueden recibir notificaciones solo por una dirección concreta, token id o importe.

Para template subscriptions, parte de los filters puede estar ya preparada por el owner del project. Entonces el usuario rellena solo inputs comprensibles, y el template los aplica en rules.

Actions ​

Actions definen dónde y cómo se entregan las notificaciones.

Normalmente una action está vinculada a un resource: Telegram chat, Discord channel, webhook u otro canal de entrega. Una subscription puede tener una o varias actions.

Notification overrides ​

Para algunas actions se puede redefinir el aspecto de la notificación: title, short/long message, icon, cover, avatar y links.

Si no se definen overrides, se usan defaults del trigger/template. Defaults son recomendaciones del creador del trigger, no una regla estricta: el usuario puede conservarlos o sustituirlos para su escenario.

Cómo funciona una subscription ​

Cuando source trae un nuevo evento, Web3alert comprueba los triggers del project. Si un trigger forma output, el engine aplica las rules de la subscription: inputs, filters, template conditions y activation logic.

Si el evento encaja con la subscription, Web3alert forma el notification payload y lo entrega a las actions seleccionadas.

Si el evento no pasa las condiciones, la notificación no se envía.

Estados de subscription ​

On ​

La subscription está activa y puede enviar alerts.

Off ​

La subscription fue desactivada por el usuario o creada en estado desactivado. Conserva la configuración, pero no envía alerts.

Blocked ​

La subscription está bloqueada por el servicio. Normalmente está relacionado con permisos, límites, disponibilidad de project/trigger/template u otra causa que hay que corregir.

Una subscription bloqueada no debe considerarse eliminada: la configuración permanece, pero el envío de alerts se detiene hasta que se resuelva la causa.

Lista de subscriptions ​

En la sección Subscriptions se puede:

  • buscar subscriptions por address, event o filter;
  • activar y desactivar una subscription;
  • abrir la edición;
  • duplicar una subscription;
  • ejecutar un test run;
  • compartir un enlace a la configuración;
  • eliminar una subscription.

La tabla muestra:

  • Triggers - trigger/template elegido, topics, inputs y filters;
  • Actions - canales de entrega;
  • Settings - estado y acciones de gestión.

Creación ​

El proceso detallado de creación se describe en Create subscription.