Notifications & Subscriptions

Stay informed about what matters. MeetLoyd's notification subscriptions let you choose exactly what events you want to know about across your AI workforce.

The RACI "Informed" Pattern

In traditional RACI matrices, the "I" (Informed) role means keeping stakeholders in the loop without requiring their direct involvement. MeetLoyd brings this pattern to AI operations:

• Subscribe to resources you care about (tasks, agents, workflows, etc.)
• Choose events that matter to you (success, failure, changes)
• Pick channels for delivery (in-app, email, Slack)

Subscribing to Resources

You can subscribe to notifications from anywhere in the dashboard. Look for the notification bell icon in resource detail views.

Available Resource Types

Resource	What You'll Be Notified About
Tasks	Task starts, completions, failures, timeouts
Workflows	Workflow completions, step failures
Agents	Agent status changes, activity summaries
Teams	Team-wide events, weekly digests
Projects	Project updates, milestone achievements
Approvals	When your approval is needed
Incidents	Security incidents, escalations
Reports	New agent reports ready

Subscribing to a Task

1. Open the task detail view
2. Click "Subscribe to notifications"
3. Select which events you want:
   • At start - When the task begins executing
   • On success - When the task completes successfully
   • On failure - When the task fails
   • On stuck - When the task times out
   • On cancel - When the task is cancelled
4. Choose your notification channels
5. Click "Subscribe"

Subscribing to an Agent

1. Navigate to the agent view in OpenSpace
2. Find the notification subscription section in the header
3. Select events:
   • On change - When agent status changes
   • Daily digest - Daily activity summary
4. Choose channels and subscribe

Notification Channels

Receive notifications where you work:

Channel	Description
In-App	Badge on the notification bell, viewable in dropdown
Email	Email to your registered address
Slack	Message in your connected Slack workspace
Teams	Message in Microsoft Teams
Webhook	POST to a custom URL
SMS	Text message via Twilio
WhatsApp	WhatsApp message via Twilio or Meta Cloud API
Telegram	Telegram message via Bot API
Signal	Signal message via signal-cli or signald
Google Chat	Google Chat via webhooks
Keybase	Keybase Chat for secure team messaging

Setting Up Channels

Most channels work automatically once you've connected integrations:

• Slack: Connect via Integrations > Slack
• Teams: Connect via Integrations > Microsoft 365
• Email: Uses your account email by default

Managing Subscriptions

Viewing Your Subscriptions

Each resource shows its current subscribers in the detail view. You can:

• See all active subscriptions
• Modify your subscription events or channels
• Unsubscribe from resources

Subscription Settings

Fine-tune how you receive notifications:

digestMode: 'immediate' | 'hourly' | 'daily' | 'weekly'
quietHours: { start: '22:00', end: '08:00' }

Digest Mode: Instead of immediate notifications, receive periodic summaries:

• Immediate - Get notified right away (default)
• Hourly - Hourly digest of all events
• Daily - Daily summary at your preferred time
• Weekly - Weekly roundup

Quiet Hours: Pause notifications during specific times (useful for preventing late-night alerts).

Event Types Reference

Execution Events

Event	When It Fires
at_start	Execution begins
on_success	Execution completes successfully
on_failure	Execution fails with error
on_stuck	Execution times out
on_cancel	Execution is cancelled

Lifecycle Events

Event	When It Fires
on_create	Resource is created
on_update	Resource is modified
on_delete	Resource is removed
on_change	Any state change

Special Events

Event	When It Fires
on_approval_needed	Approval request awaiting your action
on_escalation	Issue escalated to higher priority
daily_digest	Daily summary (scheduled)
weekly_digest	Weekly summary (scheduled)

Using the API

List Your Subscriptions

const { subscriptions } = await client.subscriptions.list({
  subscriberId: 'current-user-id'
});

Create a Subscription

await client.subscriptions.create({
  resourceType: 'task',
  resourceId: 'task-123',
  subscriberType: 'user',
  subscriberId: 'user-456',
  triggerEvents: ['on_success', 'on_failure'],
  channels: ['in_app', 'email'],
  settings: {
    digestMode: 'immediate'
  }
});

Update Subscription

await client.subscriptions.update('subscription-id', {
  triggerEvents: ['on_success', 'on_failure', 'on_stuck'],
  channels: ['in_app', 'email', 'slack']
});

Unsubscribe

await client.subscriptions.delete('subscription-id');

Best Practices

1. Start Selective

Subscribe to critical events first. You can always add more later.

// Good - focused on what matters
triggerEvents: ['on_failure', 'on_stuck']

// Potentially noisy - every event
triggerEvents: ['at_start', 'on_success', 'on_failure', 'on_stuck', 'on_cancel']

2. Use Digests for Routine Updates

For informational subscriptions, use daily or weekly digests:

// Agent activity - daily summary is enough
{
  resourceType: 'agent',
  triggerEvents: ['daily_digest'],
  settings: { digestMode: 'daily' }
}

3. Match Channel to Urgency

• Failures/Incidents: Email + Slack (immediate attention needed)
• Successes: In-app only (informational)
• Digests: Email (review at your pace)

4. Set Quiet Hours

Prevent alert fatigue by pausing non-critical notifications:

settings: {
  quietHours: {
    start: '20:00',
    end: '08:00'
  }
}

5. Clean Up Unused Subscriptions

Periodically review your subscriptions and remove ones you no longer need.

Agent Subscriptions

Agents can also subscribe to notifications, enabling autonomous awareness:

• Team lead agents can subscribe to team member failures
• Supervisor agents can monitor project milestones
• Watchdog agents can track compliance violations

This enables agent-to-agent awareness without direct coupling.

---

Next: Learn about the Activity Stream for real-time visibility into your AI workforce.