WhatsApp Business — Admin Configure (Wireframe v2.0.0)

Connection Status

Last checked 2 min ago

API Status

Connected

Graph API v23.0

Phone Number

+55 11 9••••-••42

ID: 995578186971989

Messages Today

23 delivered · 24 read

Queue

12 pending

Next dispatch in 3 min

API Credentials

Meta Business Manager → WhatsApp → API Setup

Use a System User permanent token from Meta Business Manager. Temporary tokens expire in 24 hours and should not be used in production.

Access Token Permanent System User token

Phone Number ID Numeric ID from API Setup

App ID Meta App identifier

App Secret Used for webhook signature verification

Business Account ID WABA ID from Meta

API Version Graph API version

Notification Events

Enable/disable which order events trigger WhatsApp messages

Order Placed

Send confirmation when a new order is placed. Includes order number and total.

Order Processing

Notify when order moves to processing status. Provides estimated timeline.

Shipment Created

Send tracking number and carrier info when a shipment is created for the order.

Shipment Delivered

Confirm delivery when shipment is marked as delivered. Includes delivery date.

Order Cancelled

Notify customer when their order is cancelled. Includes cancellation reason.

Refund Issued

Send notification when a refund is processed for the order.

Message Templates

WhatsApp-approved template messages for each notification type

Template messages must be approved by Meta before use. Notifications sent outside the 24-hour customer service window require an approved template. Create templates at Meta Business Manager → Message Templates.

Use Template Messages Use approved templates instead of plain text

Enabled (recommended for production)

Default Language Template language code

Shipment Tracking Template Approved

Template Name Exact name registered in Meta

Preview How the message appears in WhatsApp

📦 Atualização do Pedido

Olá {{1}},
Seu pedido #{{2}} foi enviado!

🚚 Transportadora: {{3}}
📋 Código de rastreio: {{4}}
🔗 Rastreie em: {{5}}

Obrigado pela sua compra!

14:32 ✓✓

Order Confirmation Template Approved

Template Name Exact name registered in Meta

Preview

✅ Pedido Confirmado

Olá {{1}},
Seu pedido #{{2}} foi confirmado!

💰 Total: R$ {{3}}
📅 Previsão de envio: {{4}}

Obrigado pela preferência!

14:30 ✓✓

Delivery Confirmation Template Pending Review

Template Name

Preview

📬 Pedido Entregue

Olá {{1}},
Seu pedido #{{2}} foi entregue!

📅 Entregue em: {{3}}

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

16:45 ✓✓

Dispatch Settings & Anti-Ban

Configure message queue timing to prevent rate limiting

WhatsApp enforces rate limits. Sending too many messages too quickly can result in temporary or permanent bans. The randomized delay between messages helps comply with Meta's anti-spam policies.

Polling Interval (seconds) How often the task checks for new notifications

Default: 300s (5 minutes). Range: 60s – 3600s

Min Delay Between Sends (sec) Minimum random delay between messages

Max Delay Between Sends (sec) Maximum random delay between messages

Each message is delayed by a random value between min and max

Max Messages Per Batch Limit per scheduled task run

Lookback Window (days) How far back to scan for unsent notifications

Enable Plugin Master on/off switch for all notifications

Active — messages are being dispatched

Webhook Configuration

Receive delivery status updates from WhatsApp

Configure this URL in Meta App Dashboard → WhatsApp → Configuration → Webhook. The webhook receives delivery receipts (sent, delivered, read) and updates the message log automatically.

Webhook URL Auto-generated; register in Meta

Verify Token Shared secret for webhook verification

Webhook Status Last verified by Meta

Verified Last callback: 2 minutes ago

Tracking URL Configuration

Configure tracking URLs sent to customers for each carrier

Default Tracking URL Fallback when carrier is not mapped

Use {tracking} as placeholder for the tracking number

Carrier-Specific URLs

Carrier	Tracking URL Pattern

Message Log

Last 50 messages

1,247

Delivered

983

Read

Pending

Failed

1,267

Total

Order	Phone	Type	Status	Tracking	Sent At	Error
#10247	+5511987654321	Shipment	Read	QR123456789BR	2026-05-28 14:32	—
#10246	+5521976543210	Confirmation	Delivered	—	2026-05-28 14:30	—
#10245	+5531912345678	Shipment	Delivered	NN987654321BR	2026-05-28 14:28	—
#10244	+5541998765432	Shipment	Sent	SS112233445BR	2026-05-28 14:25	—
#10240	+5511912345678	Processing	Failed	—	2026-05-28 14:20	Recipient not in allowed list
#10238	+5585987654321	Delivery	Read	JD778899001BR	2026-05-28 13:55	—

Showing 1–50 of 1,267 entries

Blacklist

3 numbers blocked

Numbers are automatically blacklisted when the API returns a 4xx error (invalid number, user blocked, etc.). You can also manually add numbers to prevent notifications.

+5511955551234 Recipient phone number not in allowed list 2026-05-26 09:14

+5521999887766 Not a valid WhatsApp account 2026-05-24 16:41

+5531912340000 Manually added — customer requested opt-out 2026-05-20 11:00

Wireframe Annotations — Model / Property Bindings

This wireframe maps 1:1 to the enhanced ConfigurationModel and WhatsAppBusinessSettings. Below are the property names for each field:

API Credentials card
- ApiKey → Access Token (permanent system user token)
- PhoneNumberId → Phone Number ID
- AppId → App ID (new in v2)
- AppSecret → App Secret (new in v2)
- BusinessAccountId → Business Account ID
- ApiVersion → API Version dropdown (new in v2, default "v23.0")
Notification Events card
- EnableOrderPlaced → Order Placed toggle (new)
- EnableOrderProcessing → Order Processing toggle
- EnableShipmentCreated → Shipment Created toggle (new — key feature)
- EnableShipmentDelivered → Shipment Delivered toggle (new)
- EnableOrderCancelled → Order Cancelled toggle
- EnableRefundIssued → Refund Issued toggle (new)
Message Templates card
- UseTemplateMessages → master toggle (new)
- DefaultLanguageCode → language dropdown (new, default "pt_BR")
- ShipmentTrackingTemplateName → shipment template name (new)
- OrderConfirmationTemplateName → order confirmation template name (new)
- DeliveryConfirmationTemplateName → delivery template name (new)
- Template previews are rendered client-side from the template name — no model binding
Dispatch Settings card
- PollingIntervalSeconds → Polling Interval (new, default 300)
- MinDelayBetweenSendsSeconds → Min Delay (new, default 10)
- MaxDelayBetweenSendsSeconds → Max Delay (new, default 45)
- MaxMessagesPerBatch → Max per batch (new, default 50)
- LookbackWindowDays → Lookback Window (new, default 30)
- IsEnabled → master enable toggle (new)
Webhook Configuration card
- WebhookUrl → auto-generated URL (read-only, computed from store URL + route)
- WebhookVerifyToken → verify token (new)
- Webhook status is queried live, not persisted
Tracking URL Configuration card
- DefaultTrackingUrlPattern → default URL with {tracking} placeholder (new)
- CarrierTrackingUrls → JSON dictionary of carrier→URL pairs (new)
Message Log card
- Stats: aggregated from WhatsAppMessageLog table
- Grid data: RecentLogs list of WhatsAppMessageLog entities
- New column: TrackingNumber (new in v2)
- New statuses: Sent, Delivered, Read, Failed (updated by webhook callbacks)
- Pagination via nopCommerce DataTables with server-side paging
Blacklist card
- Data: BlacklistedNumbers list of WhatsAppBlacklist entities
- Add Number: opens modal to add phone + reason manually
- Remove: soft-deletes the blacklist entry (allows re-sending)

Backend Changes Required (v2.0.0)

WhatsAppBusinessSettings.cs — add all new properties listed above
ConfigurationModel.cs — mirror new settings + add BlacklistedNumbers, pagination, stats
WhatsAppBusinessService.cs — add SendTemplateMessageAsync() method for template-based sending
WhatsAppScheduleTask.cs — add shipment event handling, randomized delays, batch limits
WhatsAppBusinessPlugin.cs — add new locale resources, update schedule task interval
WhatsAppWebhookController.cs (new) — handle webhook verification (GET) and delivery status callbacks (POST)
EventConsumer.cs (new) — consume ShipmentSentEvent, ShipmentDeliveredEvent, OrderPlacedEvent for real-time dispatch instead of polling-only
WhatsAppMessageLog.cs — add TrackingNumber, WhatsAppMessageId columns
FluentMigrator migration — add new columns and carrier tracking URL table

Routes (v2.0.0)

GET /Admin/WhatsAppBusiness/Configure — admin config page
POST /Admin/WhatsAppBusiness/Configure — save settings
POST /Admin/WhatsAppBusiness/TestConnection — test API credentials
POST /Admin/WhatsAppBusiness/SendTestMessage — send a test notification
GET /api/whatsapp/webhook — Meta webhook verification (challenge response)
POST /api/whatsapp/webhook — delivery status callbacks from Meta
POST /Admin/WhatsAppBusiness/AddBlacklist — manually add blacklisted number
POST /Admin/WhatsAppBusiness/RemoveBlacklist — remove from blacklist

WhatsApp Business v2.0.0

Connection Status

API Credentials

Notification Events

Message Templates

Shipment Tracking Template Approved

Order Confirmation Template Approved

Delivery Confirmation Template Pending Review

Dispatch Settings & Anti-Ban

Webhook Configuration

Tracking URL Configuration

Carrier-Specific URLs

Message Log

Blacklist

Wireframe Annotations — Model / Property Bindings

Backend Changes Required (v2.0.0)

Routes (v2.0.0)