Skip to main content

Notification Channels

Business Purpose

Explain what each selectable channel actually does so stakeholders do not mistake configured intent for real delivery.

Actors

Recipients, template administrators, provider administrators, product owners, security reviewers and support operators.

Business Flow

ChannelRequired addressReviewed behaviorReadiness
In-appRecipient external referenceThe persisted message acts as the inbox deliveryImplemented
EmailEmail addressA selectable sender can perform real delivery, log-only demonstration or suppressed successConfiguration-dependent
SMSPhone numberPlaceholder sender records simulated successExternal delivery not implemented
WhatsAppPhone numberPlaceholder sender records simulated successExternal delivery not implemented

No push channel is defined in the reviewed notification domain.

Responsibilities

Administrators select and validate a real email provider before launch. Product owners approve channel suitability and fallback rules. Data owners maintain addresses. Support communicates simulated-channel status honestly.

Business Rules

A channel without an address is skipped. A channel without a registered sender fails. Event overrides can request channels, but they cannot bypass address, template, preference or sender checks.

Integrations

Channel senders are selected by the notification service. Email may integrate with an external mail system; in-app requires persistence only. SMS and WhatsApp have no reviewed provider integration.

Limitations

There are no reviewed external receipts, bounce handling, unsubscribe links, carrier callbacks or push tokens. “Sent” is not consistently equivalent to recipient delivery.

Requires Confirmation

Confirm approved providers, sender identities, geographic coverage, consent rules, bounce handling, accessibility requirements and service-level targets.

Source References

  • microservices/src/notification-service/Channels/InAppSender.cs
  • microservices/src/notification-service/Channels/EmailSenders.cs
  • microservices/src/notification-service/Channels/PlaceholderSenders.cs
  • microservices/src/notification-service/Application/NotificationDispatcher.cs

See Also

Keywords

In-app, email, SMS, WhatsApp, provider readiness.

Revision Information

Draft; reviewed 2026-07-21; next quarterly review 2026-10-21.