ربط WhatsApp Business

WhatsApp هو القناة الأكثر استخداماً لأغلب الأعمال السعوديّة والخليجيّة. ربطه بوَصل يعني أنّ كلّ استفسار يُلتقَط، ويُستخرَج، ويُدفَع لنظام إدارة العملاء — حتّى الرسائل الصوتيّة (تُفرَّغ عبر Whisper).

المتطلّبات

تحتاج إلى:

• حساب WhatsApp Business (WABA) — مختلف عن حساب WhatsApp الشخصي
• رقم جوّال مُتحقَّق منه عند Meta (هذا هو الرقم الذي يراسله العملاء)
• صلاحيّة الدخول إلى Meta Business Manager (business.facebook.com)

إن لم تكن هذه جاهزة بعد، راجع وثائق WhatsApp Business Platform من Meta.

الخطوة الأولى: إنشاء تطبيق WhatsApp في Meta

١. اذهب إلى developers.facebook.com ٢. My Apps ← Create App ← Business ← Continue ٣. أضف منتج WhatsApp إلى تطبيقك ٤. سجّل الآتي: - App ID (أعلى الصفحة) - Phone Number ID (تحت WhatsApp ← API Setup) - WhatsApp Business Account ID

الخطوة الثانية: استخراج access token

في تطبيقك في Meta:

١. WhatsApp ← API Setup ٢. أنشئ System User Access Token (مُفضّل على tokens المؤقّتة — system user tokens لا تنتهي) ٣. امنح system user صلاحيّة whatsapp_business_messaging ٤. انسخ الـ token بحرص

الخطوة الثالثة: ضبط الـ webhook

وَصل يحتاج إلى استلام الرسائل الواردة. في تطبيق Meta:

١. Webhooks ← Configure على كائن WhatsApp ٢. Callback URL: https://wasl.sa/api/whatsapp/webhook ٣. Verify Token: أيّ نص تختاره (ستلصقه في إعدادات وَصل) ٤. Webhook Fields: اشترك في messages (وفي message_status إذا أردت تأكيدات التسليم)

احفظ. Meta تتحقّق من الـ webhook بإرسال طلب GET؛ وَصل يردّ بشكل صحيح.

الخطوة الرابعة: الربط في وَصل

في لوحة تحكّم وَصل:

١. الموصلات ← WhatsApp ← اربط ٢. الصق Phone Number ID ٣. الصق System User Access Token ٤. الصق Verify Token (الذي ضبطته في Meta) ٥. اضغط حفظ

وَصل يختبر الاتّصال باستدعاء Meta API لجلب تفاصيل رقم الجوّال. إن نجح، سترى ✅ خضراء بجوار موصل WhatsApp.

الخطوة الخامسة: التجربة

أرسل رسالة WhatsApp من رقم آخر إلى رقم عملك. من جانب العميل، المحادثة تبدو تماماً مثل أيّ محادثة WhatsApp اعتياديّة:

في لوحة تحكّم وَصل، اذهب إلى المحادثات. ستظهر الرسالة خلال ثوانٍ. اضغط عليها — الاستخراج الآلي عبّأ:

• اسم المرسِل (من ملفّه في WhatsApp)
• رقم الجوّال (مُطبَّع لصيغة E.164)
• درجة العميل + التحليل
• النبرة + الإلحاح (إن وُجدا)

إذا ربطت نظام إدارة عملاء، فالجهة وصلت إليه أصلاً.

الرسائل الصوتيّة

عندما يرسل العميل رسالة صوتيّة عبر WhatsApp، وَصل:

١. يحمّل الصوت من Meta media API (Basic Auth) ٢. يفرّغه عبر OpenAI Whisper (~٠.٠٢ ر.س للدقيقة) ٣. يخزّن النص المُفرَّغ كمحتوى الرسالة ٤. لا يخزّن ملفّ الصوت (تقليل البيانات بحسب نظام حماية البيانات الشخصيّة — راجع سياسة الخصوصيّة) ٥. يشغّل المستخرِج على النص (مثل أيّ رسالة نصيّة)

تظهر شارة 🎙️ بجوار الرسالة مع مدّة الصوت ليعرف موظّفك أنّ هذا الجزء قاله العميل بصوته بدل أن يكتبه. التفريغ يأتي طبيعيّاً — Whisper يتعامل مع اللهجات السعوديّة والخليجيّة بشكل جيّد.

الأمان

الـ webhook يتحقّق من توقيع Meta على كلّ طلب وارد:

• Meta توقّع كلّ payload بـ HMAC-SHA1 باستخدام App Secret الخاص بك
• وَصل يتحقّق من التوقيع على الخادم قبل المعالجة
• طلبات webhook المزوَّرة تُرفَض بـ 401

الـ access token و App Secret مشفّران أثناء التخزين في قاعدة بيانات وَصل (Connector.config مشفَّر).

القيود الحاليّة

• إرسال الرسائل من وَصل غير مدعوم بعد — الموظّفون يردّون من تطبيق WhatsApp على جوّالهم حاليّاً (أو عبر web.whatsapp.com)
• محادثات المجموعات غير مدعومة — فقط محادثات فرديّة مع العملاء
• تطبيق WhatsApp Business مقابل API: تطبيق "WhatsApp Business" للجوّال يستخدم API مختلفاً عن WhatsApp Business Platform (الذي ندمج معه). تحتاج نسخة الـ Platform/API.

استكشاف الأعطال

الرسائل لا تصل.

• راجع سجل تسليم webhook في Meta (developers.facebook.com ← تطبيقك ← Webhooks ← recent deliveries)
• ابحث عن استجابات 4xx/5xx؛ أبلغنا برمز الخطأ عبر الدعم
• تأكّد أنّ webhook URL هو https://wasl.sa/api/whatsapp/webhook بالضبط

الرسائل الصوتيّة تظهر فارغة.

• تأكّد أنّ Whisper API مُفعَّل لحسابك في وَصل (مُفعَّل افتراضيّاً؛ بعض الخطط تقيّده)
• الصوت أقل من ثانية يُرجِع أحياناً نصاً فارغاً؛ هذا قيد من Whisper

اسم الجهة الظاهر خاطئ.

• أسماء WhatsApp في الملفّ الشخصي قد تكون منخفضة الجودة؛ المستخرِج يفضّل الاسم المذكور داخل نص الرسالة إن وُجد
• عدّل الجهة يدويّاً من لوحة التحكّم إن احتجت

التالي

• المكالمات الصوتيّة (Twilio) — النمط نفسه للمكالمات الواردة
• منع التكرار بين القنوات — نفس الشخص على الموقع و WhatsApp = جهة واحدة
• اربط نظامك — ادفع الجهات المستخرَجة تلقائيّاً