NaijaRatings Notification System Architecture

Automated multi-channel communication logic for Users and Businesses

WhatsApp Email SMS In-App
Track:
Channel:

Channel Routing Logic — Why Some Notifications Don't Use All 4 Channels

Smart Routing

NaijaRatings intelligently filters channels based on urgency, user preferences, and anti-spam rules.

Quick Scenario Jump:
01Track 1 • Onboarding(4 Steps in Path)

1. User Registration & Onboarding

New user signs up for NaijaRatings with flexible OTP verification and multi-channel confirmation.

Step

New User Registration

User enters their full name, mobile phone number, and email address on the NaijaRatings mobile app.

Decision

Choice of OTP Channel

User selects preferred channel to receive their one-time verification code: WhatsApp (recommended) or SMS.

WhatsApp OR SMS
Notification Node

OTP Verification Code Sent

Instant 6-digit security OTP sent via the user-selected channel only (not all 4 channels).

Active Notification Channels (2/4):
WhatsAppSMS
Preview Message
Notification Node

Complete Registration

Account verified successfully. Welcome notification delivered via Email + WhatsApp to establish primary trust.

Active Notification Channels (2/4):
WhatsApp
Preview Message
01Track 1 • Critical Review(5 Steps in Path)

2. User Review of Entity (1–2 Stars)

User submits a 1-star or 2-star review on an unregistered or registered entity. Triggers In-App moderation notifications.

Step
1-2 Stars

Review Submitted (1–2 Stars)

User submits a critical 1-2 star review with text/photos for a business entity.

Notification Node
1-2 Stars

Pending Approval Notification

Critical reviews enter quality moderation to prevent defamation or spam. In-App notification sent immediately.

Active Notification Channels (1/4):
In-App
Preview Message
Decision
1-2 Stars

Moderation Decision Node

QA moderation checks if the critical review adheres to community standards (no hate speech, verified experience).

Rejected vs. Approved
Notification Node
1-2 Stars

Approved: Live Notification

Review passes moderation. In-App live notification sent to user.

Active Notification Channels (1/4):
In-App
Preview Message
Notification Node
1-2 Stars

Rejected: Policy Notification

If rejected due to policy violations, an In-App feedback notification explains why.

Active Notification Channels (1/4):
In-App
Preview Message
01Track 1 • Positive Review(2 Steps in Path)

3. User Review of Entity (3–5 Stars)

User submits a positive 3, 4, or 5-star review on any entity. Instant In-App publishing confirmation.

Step
3-5 Stars

Review Submitted (3–5 Stars)

User rates a business 3, 4, or 5 stars and writes a helpful recommendation.

Notification Node
3-5 Stars

Approved & Published Notification

Positive reviews publish instantly! User receives an In-App celebration notification.

Active Notification Channels (1/4):
In-App
Preview Message
02Track 2 • Business Onboarding(4 Steps in Path)

4. Business Account Registration

Business owner claims or registers their enterprise on NaijaRatings with OTP verification.

Step

Business Registration Initiated

Merchant enters business name, CAC registration (optional), category, and phone number.

Decision

Choice of OTP Channel

Merchant chooses verification channel: WhatsApp Business or SMS OTP.

WhatsApp OR SMS
Notification Node

OTP Verification Sent

Security OTP sent only via the selected channel (WhatsApp or SMS).

Active Notification Channels (2/4):
WhatsAppSMS
Preview Message
Notification Node

Complete Registration

Business account confirmed. Send welcome & merchant kit via Email + WhatsApp.

Active Notification Channels (2/4):
WhatsApp
Preview Message
02Track 2 • Unregistered Entity(4 Steps in Path)

5. Review on Unregistered Business (1–2 Stars)

A customer leaves a critical review on a business that has not yet claimed their NaijaRatings profile.

Step
1-2 Stars

Review on Unregistered Business (1–2 ★)

Customer submits a 1-2 star review for an unregistered business entity listed in the directory.

Decision
1-2 Stars

Moderation Approved

Review passes moderation checks. System retrieves publicly available contact (Email / WhatsApp) for the business.

Approved for Outreach
Notification Node
1-2 Stars

Send Sign-Up Prompt

Proactive alert sent via Email & WhatsApp inviting the business owner to claim their profile and address customer feedback.

Active Notification Channels (2/4):
WhatsApp
Preview Message
Notification Node
1-2 Stars

Review Goes Live Notification (Sign-up CTA)

When the review goes live on the public directory, a follow-up Email & WhatsApp alert is sent with a clear Sign-Up CTA.

Active Notification Channels (2/4):
WhatsApp
Preview Message
02Track 2 • Unregistered Entity(2 Steps in Path)

6. Review on Unregistered Business (3–5 Stars)

A customer leaves a glowing 3, 4, or 5-star review on an unclaimed business profile.

Step
3-5 Stars

Review on Unregistered Business (3–5 ★)

Customer submits a 5-star commendation for an unregistered merchant.

Notification Node
3-5 Stars

Approved Notification & Sign-Up Prompt

Approved automatically. Exciting invitation sent via Email & WhatsApp inviting the owner to claim their 5-star reputation!

Active Notification Channels (2/4):
WhatsApp
Preview Message
02Track 2 • Registered Merchant(3 Steps in Path)

7. Review on Registered Business (1–2 Stars)

A customer submits a critical 1-2 star review for a verified business account.

Step
1-2 Stars

Review on Registered Business (1–2 ★)

Customer submits critical feedback on a registered business.

Decision
1-2 Stars

Approved by Moderation

QA team confirms review is authentic customer feedback and meets platform rules.

Approved Review
Notification Node
1-2 Stars

Live Notification to Business

Immediate alert sent via Email & WhatsApp to registered merchant so they can reply promptly.

Active Notification Channels (2/4):
WhatsApp
Preview Message
02Track 2 • Registered Merchant(2 Steps in Path)

8. Review on Registered Business (3–5 Stars)

A customer posts a positive 3–5 star rating on a registered merchant profile.

Step
3-5 Stars

Review on Registered Business (3–5 ★)

Customer submits a 5-star review for a registered NaijaRatings merchant.

Notification Node
3-5 Stars

Instant Live Review Notification

Instant notification sent via Email & WhatsApp celebrating the new positive review.

Active Notification Channels (2/4):
WhatsApp
Preview Message
02Track 2 • Business Subscription(5 Steps in Path)

9. Business Account - Subscription Notifications

Automated multi-channel communications managing merchant paid plan lifecycle, renewal alerts, upgrades, and cancellations across In-App, Email, and WhatsApp.

Notification Node

Confirmation of Payment

Sent immediately after payment is processed successfully. Confirms Verified Merchant activation or renewal.

Active Notification Channels (3/4):
In-AppWhatsApp
Preview Message
Notification Node

Payment Reminder (Due Soon)

Automated alert sent X days (e.g., 7 days & 2 days) prior to auto-renewal due date.

Active Notification Channels (3/4):
In-AppWhatsApp
Preview Message
Notification Node

Expired Subscription Notice

Delivered immediately when a merchant subscription lapses or fails auto-renewal billing.

Active Notification Channels (3/4):
In-AppWhatsApp
Preview Message
Notification Node

Upgrade Subscription Confirmation

Sent immediately when a merchant upgrades their plan tier (e.g. to Enterprise Multi-Location Tier).

Active Notification Channels (3/4):
In-AppWhatsApp
Preview Message
Notification Node

Cancel Renewal Subscription Confirmation

Delivered when a merchant cancels auto-renewal for their subscription plan.

Active Notification Channels (3/4):
In-AppWhatsApp
Preview Message