Back to docs
Recipe

In-app messaging

Embed a real-time messaging surface inside your product so users never leave to check email or Slack. Meridian handles presence, threads, and push fallback.

Why in-app?

Email open rates hover around 20%. In-app messages reach 100% of active sessions. Use them for onboarding nudges, license expiry warnings, or support chat — all without context-switching.

Quick start

// 1. Install the Meridian SDK
npm install @meridian/web

// 2. Initialize with your app key
import { Meridian } from '@meridian/web';
const m = new Meridian({ appKey: 'mk_live_...' });

// 3. Mount the inbox component
m.inbox.mount('#meridian-inbox');

Presence & threads

Meridian tracks online/offline state per user. Threads support typing indicators, read receipts, and attachments. All data stays encrypted at rest with per-tenant keys.

Push fallback

When a user closes the tab, Meridian automatically delivers messages via web push. No extra code — the SDK registers a service worker on first load.

Next: read the API reference for webhook signatures and custom templates.