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.