WhatsApp Delivery
Track deliveries in real-time and send automated shipping status notifications via WhatsApp.
WhatsApp Delivery Overview
The WhatsApp Delivery module integrates WhatsApp Business API with Odoo Delivery to automatically send delivery status notifications, tracking codes, and real-time shipping updates. Customers receive information instantly on WhatsApp, reducing inquiry calls by 70% and increasing satisfaction by 45%.
Key points
• Automatically send tracking codes when orders are shipped
• Real-time delivery status updates (in transit, delivered)
• Notify when goods arrive at transit hub or near destination
• Confirm successful delivery with review request
• Alert when delivery fails or is delayed
• Integration with popular carriers (GHN, GHTK, Viettel Post)
Key Benefits
Key points
• Reduce order status inquiry calls by 70%
• Increase customer satisfaction by 45% through transparent information
• Reduce failed deliveries due to customer absence
• Increase product review rate after delivery
• Save time for customer service and logistics teams
• Build customer trust through continuous updates
Warehouse Dispatch Notification
As soon as an order is packed and dispatched, customers receive a WhatsApp message:
Key points
• Confirm order has been packed and ready for delivery
• Tracking code to follow shipping journey
• Carrier name and contact hotline
• Estimated delivery time
• Direct tracking link on carrier website
• Instructions on how to track the code
Shipping Status Updates
System automatically sends updates when status changes:
Key points
• Goods received by carrier and being processed
• Goods in transit to customer area
• Goods arrived at transit hub near destination
• Shipper on the way to deliver (same day)
• Successful delivery and signed
• Failed delivery with specific reason
Pre-Delivery Notification
Send reminder message 2-4 hours before shipper prepares to deliver:
Key points
• Notify goods will be delivered in a few hours
• Request customer to prepare for receiving
• Shipper phone number for direct contact
• Option to change address or delivery schedule
• Confirm payment method (COD or paid)
• Reduce failed deliveries due to customer absence
Successful Delivery Confirmation
After successful delivery, send thank you message and request feedback:
Key points
• Confirm order has been delivered successfully
• Thank customer for purchase
• Request product and service review
• Direct review link on website or app
• Return and warranty policy information
• Discount code for next purchase
Failed Delivery Handling
When delivery fails, system automatically notifies and suggests solutions:
Key points
• Notify reason for failed delivery (customer absent, wrong address)
• Suggest rescheduled delivery or address change
• Link to update delivery information on Portal
• Customer service hotline for immediate support
• Option to cancel order or pick up at post office
• Track number of failed attempts for timely handling
Carrier Integration
Connect with APIs of popular carriers:
Key points
• Giao Hang Nhanh (GHN) - Tracking API and webhook
• Giao Hang Tiet Kiem (GHTK) - Automatic status updates
• Viettel Post - Shipping journey tracking
• J&T Express - Real-time notifications
• Ninja Van - Tracking and POD (Proof of Delivery)
• Self-managed carriers - Manual updates
Configure Carrier Webhook
Steps
1. Register business account with carrier
2. Get API Key and Secret from carrier dashboard
3. Configure Webhook URL in Odoo: /whatsapp/delivery/webhook
4. Register Webhook URL with carrier
5. Test webhook by creating test order
6. Check logs to ensure receiving updates
7. Enable automatic WhatsApp sending on status updates
Customize Notification Content
Customize message templates for each shipping stage:
Key points
• Dispatch template - Tracking info and estimated time
• In transit template - Location and progress updates
• Near delivery template - Reminder and shipper info
• Successful delivery template - Thanks and review request
• Failed delivery template - Reason and solutions
• Delayed delivery template - Reason and new schedule
Track Shipping Journey
Customers can track detailed journey via Portal:
Key points
• Complete timeline from dispatch to delivery
• Current order location on map
• History of transit points
• Continuously updated estimated delivery time
• Proof of delivery photos (POD) when available
• Recipient information and signature (if any)
Automation Process
Steps
1. Order confirmed and moved to "Ready to Ship" status
2. System creates delivery slip and calls carrier API
3. Receive tracking code from carrier
4. Send WhatsApp message with tracking code to customer
5. Carrier sends webhook when status updates
6. System processes webhook and sends corresponding WhatsApp notification
7. Customer receives real-time updates on WhatsApp
8. After successful delivery, send review request message
Timezone and Delivery Time Handling
Optimize notification sending time by customer timezone:
Key points
• Automatically detect timezone based on delivery address
• Do not send notifications from 10 PM to 7 AM
• Prioritize sending notifications during business hours
• Urgent notifications (failed delivery) sent immediately
• Customize sending time window by notification type
• Store notifications to resend at appropriate time
Performance Tracking Dashboard
Reports and analysis of delivery effectiveness:
Key points
• Successful delivery rate by carrier
• Average delivery time by region
• Number of order inquiry calls before and after using WhatsApp
• Customer click rate on tracking links
• Product review rate after receiving notifications
• Monthly WhatsApp message sending costs
Integration with Other Modules
Key points
• Sales - Automatically send tracking when order confirmed
• Stock - Trigger notification when dispatched from warehouse
• Website - Customers ordering online receive tracking via WhatsApp
• CRM - Record customer interactions with notifications
• Helpdesk - Automatically create ticket when delivery fails
• Marketing - Send discount code after successful delivery
International Order Handling
Support cross-border delivery with multilingual notifications:
Key points
• Automatically detect country and send messages in appropriate language
• Notify about customs procedures and import taxes
• Update when goods pass border checkpoints
• Information about international delivery time (7-21 days)
• Instructions for paying taxes and customs fees
• Integration with DHL, FedEx, UPS for international delivery
Best Practices
Key points
• Send tracking code immediately after available, no delay
• Only send important updates, avoid spamming customers
• Always include detailed tracking link on Portal
• Provide customer service hotline in all messages
• Personalize messages with customer name and order number
• Test webhook regularly to ensure operation
• Backup to SMS if WhatsApp delivery fails
• Monitor feedback and optimize message content
Common Error Handling
Key points
• Webhook not received: Check URL and firewall
• Invalid tracking code: Verify with carrier
• Status not updating: Check API key and secret
• Duplicate messages sent: Add deduplication logic
• Customer not receiving: Check WhatsApp phone number
• Tracking link not working: Update URL template
Security and Privacy
Key points
• Encrypt tracking and order information
• Only send notifications to verified phone numbers
• Do not display sensitive information in messages
• Comply with GDPR and data protection regulations
• Allow customers to opt-out of notifications
• Store message sending logs for audit
Important Terminology
Key points
• Tracking Number - Order tracking code from carrier
• Webhook - URL to receive automatic notifications from carrier
• POD (Proof of Delivery) - Delivery proof (photo, signature)
• Delivery Status - Delivery status (pending, in transit, delivered)
• Carrier - Shipping company (GHN, GHTK, Viettel Post)
• Transit Hub - Distribution center
• Failed Delivery - Unsuccessful delivery attempt
• COD (Cash on Delivery) - Payment upon receipt