---
name: WhatsApp Business Customer Service
priority: 1
keywords: whatsapp business, واتساب اعمال, واتساب بزنس, baileys, whatsapp api, twilio whatsapp, meta whatsapp, customer service, خدمة عملاء, دعم فني, support, معطل, شكوى, استفسار, تذمر
---

# WhatsApp Business Customer Service

## متى تستخدم
أي تفاعل عبر WhatsApp مع العملاء — استفسارات، شكاوى، طلبات، متابعات، broadcasts.

## الأدوات المتاحة لمسلم

### 1. Baileys (المضمّن في Muassis، مجاني، يستخدم WhatsApp Web)
- موجود في `src/channels/whatsapp/baileys-adapter.ts` — Muassis يقدر يبعث رسائل من نفس الجوال المربوط.
- ربط QR في `muassis init` أو من dashboard.
- ⚠️ **محدودية**: WhatsApp بيقفل الرقم لو ارسلت 100+ رسالة جديدة في يوم. للـscale استخدم Cloud API.

### 2. Meta WhatsApp Cloud API (الرسمي، للأعمال الكبيرة)
- Phone Number ID + Permanent Access Token من Meta Business Suite.
- $WABA_TOKEN و$WABA_PHONE_ID.
```bash
exec_command "curl -s -X POST -H 'Authorization: Bearer $WABA_TOKEN' -H 'Content-Type: application/json' \
  -d '{\"messaging_product\":\"whatsapp\",\"to\":\"966500000000\",\"type\":\"template\",\"template\":{\"name\":\"hello_world\",\"language\":{\"code\":\"ar\"}}}' \
  'https://graph.facebook.com/v19.0/$WABA_PHONE_ID/messages'"
```
أنواع المحتوى: text, template, image, document, video, audio, location, interactive (buttons + lists).

### 3. Twilio WhatsApp (شائع)
```bash
exec_command "curl -X POST 'https://api.twilio.com/2010-04-01/Accounts/$TWILIO_SID/Messages.json' \
  --data-urlencode 'From=whatsapp:+14155238886' \
  --data-urlencode 'To=whatsapp:+966500000000' \
  --data-urlencode 'Body=مرحباً، فاتورتك جاهزة' \
  -u $TWILIO_SID:$TWILIO_TOKEN"
```

### 4. wa.me (للروابط المشاركة بدون API)
استدعِ `whatsapp_send` fast-path أو افتح `https://wa.me/<number>?text=<msg>` — يفتح في WhatsApp المربوط على الجهاز.

## قوالب رسائل (Saudi context)

### Welcome
```
أهلاً بك في تأسيس 👋

أنا المؤسس، موظف رقمي ذكي عندك. كيف ممكن أساعدك اليوم؟

١. استفسار عن خدمة
٢. متابعة طلب سابق
٣. شكوى أو ملاحظة
٤. التحدّث مع فريق المبيعات
```

### Order confirmation
```
✅ تأكدت طلبك!

🛒 رقم الطلب: #12345
💰 الإجمالي: 450 ر.س
📅 التسليم: 2026-05-12

لو حابب تتابع، اكتب: "أين طلبي" + رقم الطلب.
```

### Complaint acknowledgment (مهم! اعترف بسرعة)
```
آسفين على هذي التجربة 🙏

أحلتها فوراً للمختصة، وسيتواصلون معك في أقل من ساعتين.

رقم البلاغ: #C-7890 (احتفظ به).
```

## Auto-reply patterns

### بعد ساعات العمل
```
مرحباً 👋
استلمنا رسالتك. ساعات العمل: السبت-الخميس 9ص-9م.
أول الـbusiness hours، أحد الفريق راح يرد عليك.

لو طارئ: اتصل على 800-XXX-XXXX.
```

### Out-of-stock
```
هذا المنتج خلص حالياً 😔
عندنا بدائل ممكن تعجبك:
• <product 1>
• <product 2>
أو احجز للدفعة الجاية: تصل بعد ~10 أيام.
```

## Escalation rules (متى ترسل لإنسان)
- العميل قال "أنت غبي" / "AI سيء" / "بدي إنسان حقيقي" → escalate فوراً.
- شكوى مالية > 1000 ر.س → escalate.
- طلب refund → escalate (المالك يقرر).
- عميل VIP (تاج في metadata) → escalate.

## أمثلة
- "ابعث لـ+966500000000 رسالة 'فاتورتك جاهزة'" → `whatsapp_send` fast-path.
- "اعمل broadcast لـ500 عميل" → ⚠️ من Cloud API بـtemplate موافق عليه فقط.
- "العميل اشتكى" → اعترف، احفظ رقم بلاغ، escalate لإنسان.

## القواعد الذهبية
- ❌ **ممنوع** templates مرفوضة من Meta — حظر مؤكد على الرقم.
- ❌ **لا ترسل marketing بدون موافقة** — قوانين الخصوصية السعودية (PDPL) صارمة.
- ❌ **لا تعد بدون قدرة** — "بنرسلها بكرة" يلزم بكرة بالضبط.
- ✅ **رد خلال 5 دقائق** على رسائل العمل (الـSLA المتوقع في السعودية أعلى من العالمي).
- ✅ **استخدم اللهجة المحلية** — "تمام" أفضل من "حسناً"، "بكرة" أفضل من "غداً".
- ✅ **شارك أرقام التتبع/الفاتورة** — العميل يحب يقدر يتابع بنفسه.
