WPP.order — Manage orders in WhatsApp Business chats

// Listen for incoming messages and read orders
WPP.on('chat.new_message', async (msg) => {
  if (msg.type === 'order') {
    const order = await WPP.order.get(msg.id);
    console.log('Order ID:', order.id);
    console.log('Products:', order.products.length);
    console.log('Total:', order.total, order.currency);
  }
});

// Retrieve an order by a known message ID string
const order = await WPP.order.get('3EB0C9A1B2C3D4E5F6A7B8');
console.log(order);

// Accept an order
await WPP.order.accept({
  msgId: '3EB0C9A1B2C3D4E5F6A7B8',
});

// Decline with an explanation
await WPP.order.decline({
  msgId: '3EB0C9A1B2C3D4E5F6A7B8',
  declineNote: 'Sorry, this item is currently out of stock.',
});

// Decline without a note
await WPP.order.decline({
  msgId: '3EB0C9A1B2C3D4E5F6A7B8',
});

// Mark as shipped
await WPP.order.update({
  msgId: '3EB0C9A1B2C3D4E5F6A7B8',
  orderStatus: WPP.order.OrderStatus.Shipped,
  orderNote: 'Your order has been shipped via Express Delivery.',
});

// Mark as delivered
await WPP.order.update({
  msgId: '3EB0C9A1B2C3D4E5F6A7B8',
  orderStatus: WPP.order.OrderStatus.Delivered,
  orderNote: 'Your order was delivered. Thank you!',
});

// Mark as complete with payment confirmation
await WPP.order.update({
  msgId: '3EB0C9A1B2C3D4E5F6A7B8',
  orderStatus: WPP.order.OrderStatus.Complete,
  paymentStatus: WPP.order.PaymentStatus.Captured,
  orderNote: 'Order completed and payment received.',
});

const ORDER_MSG_ID = '3EB0C9A1B2C3D4E5F6A7B8';

// Step 1 — Read the incoming order
const order = await WPP.order.get(ORDER_MSG_ID);
console.log(`New order: ${order.itemCount} item(s), total ${order.total} ${order.currency}`);

// Step 2 — Decide whether to accept or decline
const canFulfill = order.products.every((p) => p.quantity <= 10);

if (!canFulfill) {
  // Decline with a reason
  await WPP.order.decline({
    msgId: ORDER_MSG_ID,
    declineNote: 'One or more items in your order exceed our stock limit.',
  });
  return;
}

// Step 3 — Accept the order
await WPP.order.accept({ msgId: ORDER_MSG_ID });
console.log('Order accepted.');

// Step 4 — Update to "preparing to ship" after packing
await WPP.order.update({
  msgId: ORDER_MSG_ID,
  orderStatus: WPP.order.OrderStatus.PreparingToShip,
  orderNote: 'We are packing your order.',
});

// Step 5 — Mark as shipped when dispatched
await WPP.order.update({
  msgId: ORDER_MSG_ID,
  orderStatus: WPP.order.OrderStatus.Shipped,
  orderNote: 'Your order is on its way! Tracking: BR123456789.',
});

// Step 6 — Confirm delivery and payment
await WPP.order.update({
  msgId: ORDER_MSG_ID,
  orderStatus: WPP.order.OrderStatus.Complete,
  paymentStatus: WPP.order.PaymentStatus.Captured,
  orderNote: 'Thank you for your purchase!',
});