Skip to content
Systems

Messaging

Messaging covers the ways an app speaks to people: an email after a purchase, a push notification when a job finishes, a badge in the corner of the screen, a list that updates while someone watches. Every message is logged with its delivery status, so a missing email is something you look up, not guess at.

What Messaging does

Email from your domain

Plain-text and HTML email sent from your own verified domain, with every delivery and failure logged.

Web push

Browser push subscriptions per user, with one call to notify one person or many.

In-app inbox

A notification list per user with read state, ready to show in a menu or on a page of its own.

Realtime channels

Publish from your server and stream to browsers over server-sent events. No socket server to run.

Preferences

Each person chooses which messages they get and where. You read their choice before you send.

TemplatesIn preview

Versioned email templates with variables, previewed in the dashboard before they go out.

In your code.

Email a receipt, then update the open tab live.

TypeScript
await dianthan.messages.email({
  to: user.email,
  subject: "Your export is ready",
  text: `Download it here: ${url}`,
});

await dianthan.channels.publish(`user:${user.id}`, {
  type: "export.ready",
  url,
});

Better with.

What Messaging does once another system is switched on in the same app.

  • Automation

    Email on a schedule or after a delay, with retries and a delivery log.

  • Identity

    Message a person, not an address, and respect the preferences they set.

  • Metering

    Tell a customer they're running low on credits before they run out.

  • Billing

    Receipts, failed-payment notices and trial reminders go out without extra code.

Endpoints.

The main routes. The API reference lists every parameter and response.

  • POST /v1/messages/email
  • GET /v1/messages
  • POST /v1/push/subscriptions
  • POST /v1/push/send
  • GET /v1/notifications
  • POST /v1/channels/publish
  • GET /v1/channels/:channel/subscribe

Included in the plan.

Messaging is part of every account: free within hard limits, then included in the $29 plan that covers every system and every app.

  • Included

    10,000 emails. 100,000 push notifications. 1 million realtime messages.

  • Beyond that

    $0.80 per 1,000 emails. $0.20 per 100,000 push or realtime messages.