Blog Details

Zid WhatsApp automation turns a Zid storefront into a fully conversational WhatsApp channel. Zid is the second-largest Saudi ecommerce platform (after Salla) and a favorite among electronics, beauty, and grocery merchants because of its built-in COD support, its multi-warehouse inventory, and its Saudi-compliant invoicing. Wutt adds the WhatsApp layer Zid does not ship with: a shared inbox, an AI concierge, a COD follow-up flow, and Arabic-first templates. This page shows the real Zid integration and four ready-to-use templates.

Zid API basics you need

Zid exposes a GraphQL API and a webhook system. The mutations and queries that matter for WhatsApp automation:

query orders($status: OrderStatus)         list orders by status
query order(id: ID!)                     order details + customer + items
mutation updateOrderStatus($id: ID!, $status: OrderStatus!)
                                         change status (new, in_progress, shipped, delivered, completed, cancelled)
query abandonedCarts                     list abandoned carts
mutation createWebhook($url: String!, $events: [String!]!)
                                         register a webhook URL

Step-by-step integration

Step 1 — Generate a Zid access token

Zid Merchant → Settings → API → Create token. Required scopes: read_orders, write_orders, read_customers, read_abandoned_carts, manage_webhooks. Paste the token into Wutt Commerce → Providers → Zid.

Step 2 — Register the webhooks

Wutt auto-registers:

order.created
order.updated
order.shipped
order.delivered
order.cancelled
abandoned_cart.created
abandoned_cart.updated

Step 3 — One-time backfill

php artisan commerce:sync zid --orders --days=180 --products

Step 4 — Connect WhatsApp and Arabic template language

Add the WhatsApp number (default wa.me/966500000000), and in Templates → New, set the language to ar for every primary template. Create a matching _en variant for English-speaking customers.

The COD follow-up flow (Zid-specific)

COD is the default payment in Saudi Arabia for low-to-mid basket sizes, but it carries a 15–25% return-to-sender rate when the courier shows up and the customer is unreachable. Wutt’s COD follow-up flow reduces that with a 3-step WhatsApp sequence.

Order created (COD, status = new)
  |
  v
T+0  ->  zid_cod_confirm_v1   confirm address + amount
  Customer taps Confirm  ->  status = in_progress (ready to ship)
  Customer taps Cancel   ->  status = cancelled, contact tagged `cod_cancel`
  No reply in 24h        ->  T+24h step
  |
  v
T+24h ->  zid_cod_reminder_v1  friendly reminder, ask for confirmation
  No reply in 48h        ->  T+72h step
  |
  v
T+72h ->  zid_cod_last_call_v1 last-chance template with a small incentive
         ("confirm now and get free shipping on this order")
  No reply in 24h        ->  order auto-cancelled, contact tagged `cod_ghost`

4 ready-to-use message templates (Zid + Arabic)

1. Cart recovery (Arabic, +1h)

TEMPLATE:  zid_cart_ar_v1
CATEGORY:  MARKETING
LANGUAGE:  ar
HEADER:    Image  (first product in the cart)
BODY:      "مرحباً {{1}}، تركت {{2}} في السلة."
           "الإجمالي {{3}} ر.س. سنحفظها لمدة ٢٤ ساعة."
BUTTONS:   [أكمل الطلب] [خصم ١٠٪] [إزالة]

2. COD confirmation (T+0)

TEMPLATE:  zid_cod_confirm_v1
CATEGORY:  UTILITY
LANGUAGE:  ar
BODY:      "أهلاً {{1}}، طلبك رقم {{2}} جاهز."
           "الإجمالي عند الاستلام: {{3}} ر.س."
           "العنوان المسجل: {{4}}"
BUTTONS:   [تأكيد] [تغيير العنوان] [إلغاء]

3. COD reminder (T+24h)

TEMPLATE:  zid_cod_reminder_v1
CATEGORY:  UTILITY
LANGUAGE:  ar
BODY:      "مرحباً {{1}}، لم نسمع منك بخصوص الطلب {{2}}."
           "نحتاج تأكيدك حتى نبدأ التجهيز."
BUTTONS:   [تأكيد] [إلغاء] [تواصل معنا]

4. Shipping update with courier

TEMPLATE:  zid_shipped_v1
CATEGORY:  UTILITY
LANGUAGE:  ar  (also create zid_shipped_en_v1)
BODY:      "طلبك رقم {{1}} في الطريق 🚚"
           "مع شركة الشحن: {{2}}"
           "رقم التتبع: {{3}}"
BUTTONS:   [تتبع] [تواصل مع الدعم]

Currency and Saudi compliance

Zid stores are SAR by default. Wutt reads order.currency and substitutes it in templates. VAT (15%) and the ZATCA-compliant invoice are generated by Zid; Wutt simply attaches the PDF to the order.delivered template if you want to send the invoice via WhatsApp.