Subscriptions & Events

Most of the time, you send a message and your agent replies. But with subscriptions and events, your agents can reach out to you first when something important happens — no prompting required.

How events work

Events are signals that something has occurred. They can come from:

• Agents — An agent detects something noteworthy (e.g., a price drop on a product you’re tracking).
• Integrations — An external service sends a webhook (e.g., a new email arrives, a deploy finishes).
• Schedules — A timer fires at a configured interval (e.g., every morning at 9 AM).
• System — Selu itself raises events for things like agent errors or resource limits.

Subscribing to events

A subscription tells Selu: “When this event happens, notify me on this channel.”

To create a subscription:

1. Go to Settings → Events → Subscriptions.
2. Click New Subscription.
3. Choose the event type you want to listen for.
4. Select the channel where you’d like to receive notifications (web chat, iMessage, or Telegram).
5. Optionally, pick an agent to process the event before it reaches you — the agent can summarize, filter, or enrich the notification.
6. Save the subscription.

Common use cases

Daily digest

Subscribe to a schedule event that fires every morning. An agent gathers your calendar, weather, and news into a single summary.

Smart home alerts

React to sensor events from your home automation system. Get a Telegram message if a door opens while you’re away.

Monitoring

Subscribe to system health events. If an agent crashes or a container runs out of memory, you’ll know immediately.

Workflow triggers

Chain agents together — one agent’s completed task becomes an event that triggers the next agent in a workflow.

Event filtering

Not every event needs your attention. Use filters on your subscriptions to narrow things down:

• Severity — Only notify on warnings or errors, not informational events.
• Source — Listen to events from a specific agent or integration only.
• Content match — Use simple pattern matching to filter by event payload.

Viewing event history

All events are logged under Settings → Events → History. You can search and filter past events to understand what happened and when, which is helpful for debugging subscriptions or reviewing agent behavior.