Blog Details

Salla WhatsApp automation bridges a Salla store with the Wutt inbox, AI assistant, and template engine. Salla handles the storefront, the Saudi-compliant payments (mada, Apple Pay, STC Pay, TABBY, Tamara), and the tax invoices. Wutt adds the WhatsApp layer: cart recovery, COD confirmation, shipping notifications, and an AI concierge that replies in Arabic or English. This page shows the real Salla app integration steps and four ready-to-use templates.

Salla API basics you need

Salla exposes a REST API and a webhook system. The endpoints that matter for WhatsApp automation:

GET    /api/v1/orders                  list orders
GET    /api/v1/orders/{id}             order details
POST   /api/v1/orders/{id}/status      change status (paid, shipped, delivered, cancelled)
GET    /api/v1/customers               list customers
GET    /api/v1/abandoned-carts         list abandoned carts (Merchant plan and above)
POST   /api/v1/webhooks                register a webhook URL

Step-by-step integration

Step 1 — Install the Salla app from Wutt

Wutt Commerce → Providers → Add provider → Salla. You will be redirected to Salla’s OAuth screen. Approve the scopes read_orders, write_orders, read_customers, read_abandoned_carts. Wutt stores the access token and refresh token in the encrypted vault.

Step 2 — Register the webhooks

Wutt auto-registers these topics in your Salla account:

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

Step 3 — One-time backfill

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

Step 4 — Connect your WhatsApp sender

WhatsApp accounts → Add account → Meta Cloud API (or scan a QR if you prefer the gateway approach). The example number below is wa.me/966500000000.

4 ready-to-use message templates (Salla-tuned)

1. Cart recovery (Arabic, +1h)

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

2. COD confirmation

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

3. Shipping update with courier

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

4. Post-purchase review (T+5d)

TEMPLATE:  salla_review_ar_v1
CATEGORY:  MARKETING
LANGUAGE:  ar
HEADER:    Image  (the product the customer bought)
BODY:      "شكراً لطلبك من {{1}}، {{2}}! رأيك يهمنا ⭐"
           "اكتب سطراً واحداً وساعد المتسوقين الآخرين."
BUTTONS:   [اكتب مراجعة] [تصفح جديد]

Currency and language

Salla stores are SAR by default. Wutt reads order.currency from the Salla payload and uses it in templates. For multi-currency Salla stores (SAR / AED / USD), add a {{3}} variable in the template body and Wutt will substitute the right currency code.