Shiprocket Event Data Insertion & Variables Guide
Comprehensive A to Z guide on mapping live Shiprocket webhook data into WhatsApp Meta Approved Templates, Flow Messages, Condition Logic, and Dynamic Buttons.
Where Can You Use Shiprocket Data Variables?
When Shiprocket dispatches a tracking update or order status event, Softymize automatically captures all payload fields into runtime attributes. You can use these variables across multiple components:
1WhatsApp Meta Approved Templates
Map placeholders like {{1}}, {{2}} to {{shiprocket.customer_name}}, {{shiprocket.courier_name}}, {{shiprocket.order_id}}.
2Dynamic CTA Button Links
Set WhatsApp template button URL to {{shiprocket.tracking_url}} so customers can track parcels in 1-click.
3Check Condition & Router Nodes
Branch flows dynamically based on payment method (COD vs Prepaid) or order total (total > 2000).
4AI Autopilot Context
AI agent uses live AWB tracking info (shiprocket.awb, shiprocket.etd) to answer customer queries automatically.
Complete Shiprocket Data Variables Mapping Reference Table
The table below lists all variables populated by Shiprocket events. Both namespaced tags ({{shiprocket.*}}) and legacy flat tags ({{*}}) are fully supported.
| Variable Name | Data Type | Description | Sample Value |
|---|---|---|---|
| {{shiprocket.customer_name}} | String | Full name of recipient customer | Jay Bhawani Customer |
| {{shiprocket.customer_phone}} | String | Customer mobile number (auto-formatted with country code) | 919876543210 |
| {{shiprocket.customer_number}} | String | Alias for customer mobile number | 919876543210 |
| {{shiprocket.order_id}} | String | Store Order ID / Reference Order Number | 1373900_150876814 |
| {{shiprocket.sr_order_id}} | Number | Internal Shiprocket System Order ID | 348456385 |
| {{shiprocket.awb}} | String | Air Waybill (AWB) Tracking Code assigned by courier | 19041424751540 |
| {{shiprocket.courier_name}} | String | Courier logistics partner name | Delhivery Surface |
| {{shiprocket.current_status}} | String | Live shipment tracking status label | IN TRANSIT / MANIFEST GENERATED |
| {{shiprocket.current_status_id}} | Number | Shiprocket status numeric ID code | 20 |
| {{shiprocket.tracking_url}} | String | Direct URL link to track shipment online | https://shiprocket.co/tracking/19041424751540 |
| {{shiprocket.etd}} | String | Estimated Time of Delivery timestamp | 2023-05-23 15:40:19 |
| {{shiprocket.awb_assigned_date}} | String | Timestamp when AWB was generated | 2023-05-19 11:59:16 |
| {{shiprocket.pod_status}} | String | Proof of Delivery verification type | OTP Based Delivery |
| {{shiprocket.total}} / {{total}} | Number | Total order payable amount | 1499.00 |
| {{shiprocket.payment_method}} | String | Payment mode method (COD vs Prepaid) | COD / Prepaid |
| {{shiprocket.location}} / {{location}} | String | Current parcel location hub/city extracted from latest tracking scan | Mumbai_MiraRdIndEstate_I (Maharashtra) |
| {{shiprocket.activity}} / {{activity}} | String | Latest scan activity description | In Transit - Shipment Received at Facility |
Official Shiprocket Webhook Sample JSON Payload
Below is the official JSON payload sent by Shiprocket servers for tracking scan updates:
{
"awb": "19041424751540",
"courier_name": "Delhivery Surface",
"current_status": "IN TRANSIT",
"current_status_id": 20,
"shipment_status": "IN TRANSIT",
"shipment_status_id": 18,
"current_timestamp": "23 05 2023 11:43:52",
"order_id": "1373900_150876814",
"sr_order_id": 348456385,
"awb_assigned_date": "2023-05-19 11:59:16",
"pickup_scheduled_date": "2023-05-19 11:59:17",
"etd": "2023-05-23 15:40:19",
"scans": [
{
"date": "2023-05-19 11:59:16",
"status": "X-UCI",
"activity": "Manifested - Manifest uploaded",
"location": "Chomu_SamodRd_D (Rajasthan)",
"sr-status": "5",
"sr-status-label": "MANIFEST GENERATED"
},
{
"date": "2023-05-19 15:32:17",
"status": "X-PPOM",
"activity": "In Transit - Shipment picked up",
"location": "Chomu_SamodRd_D (Rajasthan)",
"sr-status": "42",
"sr-status-label": "PICKED UP"
},
{
"date": "2023-05-23 11:43:46",
"status": "X-IBD3F",
"activity": "In Transit - Shipment Received at Facility",
"location": "Mumbai_MiraRdIndEstate_I (Maharashtra)",
"sr-status": "18",
"sr-status-label": "IN TRANSIT"
}
],
"is_return": 0,
"channel_id": 3422553,
"pod_status": "OTP Based Delivery",
"pod": "Not Available",
"qc_image": "",
"qc_failure_reason": ""
}