WhatsApp Business — Message Dashboard (Wireframe v2.0.0)

Total Sent

1,267

12% vs last week

Delivered

1,247

98.4% delivery rate

Read

983

78.8% read rate

Pending

12

Next batch in 3 min

Failed

8

3 vs last week

Blacklisted

3

0.2% of contacts

Messages Over Time (Last 30 Days)

Area chart: Sent (green line) · Delivered (blue fill) · Failed (red dots)

By Message Type

Donut: Shipment 48% · Confirmation 32% · Delivery 15% · Other 5%

Shipment (608) Confirmation (405) Delivery (190) Other (64)

Order #10247 — WhatsApp Notification Timeline

All notifications delivered

Order Info

CustomerMaria da Silva

Phone+55 11 98765-4321

Order Date2026-05-25 10:14

TotalR$ 187,90

StatusComplete

Shipment

CarrierCorreios — PAC

TrackingQR123456789BR

Shipped2026-05-26 14:30

Delivered2026-05-28 09:45

WhatsApp Chat Preview

Loja Atacadão da Lash

+55 11 9xxxx-xx42

✅ Pedido Confirmado

Olá Maria,
Seu pedido #10247 foi confirmado!

💰 Total: R$ 187,90
📅 Previsão de envio: 27/05/2026

Obrigado pela preferência!

10:15 ✓✓

📦 Pedido Enviado

Olá Maria,
Seu pedido #10247 foi enviado!

🚚 Transportadora: Correios — PAC
📋 Código de rastreio: QR123456789BR
🔗 Rastreie em: linkcorreios.com.br

Obrigado pela sua compra!

14:32 ✓✓

📬 Pedido Entregue

Olá Maria,
Seu pedido #10247 foi entregue!

📅 Entregue em: 28/05/2026

Esperamos que goste! Alguma dúvida? Responda esta mensagem.

09:50 ✓✓

Delivery Timeline

2026-05-25 10:15 UTC

Order Confirmation sent to +5511987654321

Read — Read at 10:17 UTC · WhatsApp ID: wamid.abc123...

2026-05-26 14:32 UTC

Shipment Tracking sent — Tracking: QR123456789BR (Correios)

Read — Read at 14:35 UTC · WhatsApp ID: wamid.def456...

2026-05-28 09:50 UTC

Delivery Confirmation sent

Read — Read at 09:52 UTC · WhatsApp ID: wamid.ghi789...

Dispatch Queue

12 pending

#	Order	Customer	Phone	Type	Tracking	Queued At	ETA
1	#10250	João Pereira	+5521976543210	Shipment	SS445566778BR	14:55	~30s
2	#10249	Ana Costa	+5531912345678	Confirmation	—	14:55	~45s
3	#10248	Carlos Lima	+5541998765432	Shipment	JD112233445BR	14:55	~1m 20s
4–12	9 more messages queued (Confirmation ×4, Shipment ×3, Delivery ×2)						~5–8 min

Recent Activity

Auto-refreshes every 30s

14:55 — Just now

Shipment Tracking queued for Order #10250 (João Pereira)

Tracking: SS445566778BR · Carrier: Sequoia · ETA: 30s

14:52

Delivery Confirmation Delivered for Order #10247 (Maria da Silva)

Delivered at 14:52 · WhatsApp ID: wamid.ghi789...

14:45

Order Confirmation Read for Order #10249 (Ana Costa)

Read at 14:47

14:20

Processing Notification Failed for Order #10240

(#131030) Recipient phone number not in allowed list — auto-blacklisted

14:15

Shipment Tracking Read for Order #10245 (Pedro Santos)

Tracking: NN987654321BR · Carrier: Correios · Read at 14:18

13:50

Rate limit warning — approaching daily sending limit

842 / 1,000 messages sent today (Tier 1 limit). Queue paused for 2 min.

Wireframe Annotations — Message Dashboard

This dashboard is a secondary view accessible from the admin Configure page. It provides real-time monitoring of message dispatch and delivery status.

KPI tiles — aggregated from WhatsAppMessageLog grouped by Status. Refresh via AJAX every 30 seconds.
Charts
- Messages Over Time: server-side query with date range filter, rendered via Chart.js or similar
- By Message Type: donut chart from GROUP BY MessageType
Order Notification Timeline
- Shown when navigating from an Order detail page → WhatsApp tab
- Queries all WhatsAppMessageLog entries for that OrderId
- Chat preview renders from template name + parameters stored on the log entry
- WhatsApp Message ID (WhatsAppMessageId) links to the webhook delivery status
Dispatch Queue
- Shows the current batch being processed by WhatsAppScheduleTask
- ETA computed from position × random delay (min–max range from settings)
- "Process Now" triggers an immediate task execution outside the polling interval
Recent Activity
- Live feed from WhatsAppMessageLog ordered by SentAt DESC
- Includes webhook status updates (Sent → Delivered → Read transitions)
- Rate limit warnings injected by the dispatch engine when approaching tier limits

New Routes

GET /Admin/WhatsAppBusiness/Dashboard — this page
GET /Admin/WhatsAppBusiness/OrderMessages?orderId={id} — order-specific timeline (JSON for AJAX)
GET /Admin/WhatsAppBusiness/QueueStatus — current queue state (JSON for polling)
GET /Admin/WhatsAppBusiness/Stats?from={date}&to={date} — aggregated stats for charts
POST /Admin/WhatsAppBusiness/ProcessQueueNow — trigger immediate dispatch

Integration Points

Order Detail Page — add a "WhatsApp" tab in the admin order detail view showing the notification timeline for that order. Uses nopCommerce widget zone admin_order_details_buttons to inject a "View WhatsApp Messages" button.
Webhook callbacks — POST /api/whatsapp/webhook receives status updates from Meta and updates WhatsAppMessageLog.Status and WhatsAppMessageLog.WhatsAppMessageId.
Event Consumers — ShipmentSentEvent and ShipmentDeliveredEvent consumers queue messages immediately (in addition to the polling fallback).